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
listener
-Argument ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es zuhört, ansonstenfalse
.
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 das Element im Verlauf des Browsers repräsentiert.Zu dem Zeitpunkt, zu dem dieses Ereignis gesendet wird, kennt der Browser den Titel der Seite noch nicht. Wenn der Browser diese Seite zuvor besucht hat und sich den alten Titel gemerkt hat, dann enthält das
HistoryItem.title
Objekt den alten Titel der Seite. Wenn der Browser keine Aufzeichnung des alten Titels der Seite hat, dann bleibtHistoryItem.title
leer. Um die Titel der Seiten zu erhalten, sobald sie bekannt sind, hören Sie aufhistory.onTitleChanged
.
Browser-Kompatibilität
BCD tables only load in the browser
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 Chromiums chrome.history
API. Diese Dokumentation ist abgeleitet von history.json
im Chromium-Code.