history.onTitleChanged
Wird ausgelöst, wenn der Titel einer von der Benutzerin oder dem Benutzer besuchten Seite aufgezeichnet wird. Um Besuche auf einer Seite zu verfolgen, verwenden Sie history.onVisited. Das history.HistoryItem, das dieses Ereignis an seinen Zuhörer übergibt, enthält jedoch nicht den Seitentitel, da der Seitentitel normalerweise nicht bekannt ist, wenn history.onVisited gesendet wird. Stattdessen wird das gespeicherte history.HistoryItem aktualisiert, nachdem die Seite geladen wurde und der Titel bekannt ist. Zu diesem Zeitpunkt wird das Ereignis history.onTitleChanged ausgelöst. Wenn Sie die Titel der Seiten kennen müssen, während sie besucht werden, hören Sie auf history.onTitleChanged.
Syntax
browser.history.onTitleChanged.addListener(listener)
browser.history.onTitleChanged.removeListener(listener)
browser.history.onTitleChanged.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)-
Fügt diesem Ereignis einen Zuhörer hinzu.
removeListener(listener)-
Stoppen Sie das Lauschen auf dieses Ereignis. Das Argument
listenerist der zu entfernende Zuhörer. hasListener(listener)-
Überprüfen Sie, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn es zuhört,falseandernfalls.
addListener Syntax
Parameter
listener-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird ein Objekt mit diesen Eigenschaften übergeben:
id-
String. Die eindeutige Kennung für dashistory.HistoryItem, das mit diesem Besuch verbunden ist. url-
String. URL der besuchten Seite. title-
String. Titel der besuchten Seite.
Beispiele
Überwachen Sie Ereignisse zur Titeländerung und zeichnen Sie die ID, URL und den Titel der besuchten Seiten auf.
function handleTitleChanged(item) {
console.log(item.id);
console.log(item.title);
console.log(item.url);
}
browser.history.onTitleChanged.addListener(handleTitleChanged);
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.history API. Diese Dokumentation ist abgeleitet von history.json im Chromium-Code.