history.onVisited
Wird jedes Mal ausgelöst, wenn der Benutzer eine Seite besucht. Ein history.HistoryItem
-Objekt wird an den Listener übergeben. Dieses Ereignis wird ausgelöst, bevor die Seite geladen ist.
Syntax
browser.history.onVisited.addListener(listener)
browser.history.onVisited.removeListener(listener)
browser.history.onVisited.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)
-
Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener)
-
Stoppt das Lauschen auf dieses Ereignis. Das Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es lauscht, andernfallsfalse
.
addListener-Syntax
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird folgendes Argument übergeben:
result
-
history.HistoryItem
. Ein Objekt, das den Eintrag im Browserverlauf darstellt.Zu dem Zeitpunkt, an dem dieses Ereignis gesendet wird, kennt der Browser den Titel der Seite noch nicht. Wenn der Browser diese Seite vorher besucht hat und sich ihren alten Titel gemerkt hat, wird das Objekt
HistoryItem.title
den alten Titel der Seite enthalten. Wenn der Browser keinen Eintrag für den alten Titel der Seite hat, wirdHistoryItem.title
leer sein. Um die Titel der Seiten zu erhalten, sobald sie bekannt sind, hören Sie aufhistory.onTitleChanged
.
Browser-Kompatibilität
Beispiele
Hören Sie auf Besuche und protokollieren Sie die URL und die Besuchszeit.
function onVisited(historyItem) {
console.log(historyItem.url);
console.log(new Date(historyItem.lastVisitTime));
}
browser.history.onVisited.addListener(onVisited);
Hinweis:
Diese API basiert auf der Chromium-API chrome.history
. Diese Dokumentation ist aus history.json
im Chromium-Code abgeleitet.