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 Zuhören auf dieses Ereignis. Das Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Prüft, ob
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es zuhört, andernfallsfalse
.
addListener-Syntax
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird dieses Argument übergeben:
result
-
history.HistoryItem
. Ein Objekt, das das Element im Verlauf des Browsers darstellt.Zu dem Zeitpunkt, an dem dieses Ereignis gesendet wird, kennt der Browser den Titel der Seite noch nicht. Wenn der Browser diese Seite bereits besucht hat und sich an ihren alten Titel erinnert, dann enthält das Objekt
HistoryItem.title
den alten Titel der Seite. Wenn der Browser keinen Eintrag über den alten Titel der Seite hat, dann istHistoryItem.title
leer. Um die Titel der Seiten sofort zu erhalten, sobald sie bekannt sind, horchen Sie aufhistory.onTitleChanged
.
Beispiele
Hören Sie Besuche ab 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);
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.history
API von Chromium. Diese Dokumentation stammt aus history.json
im Chromium-Code.