history.onTitleChanged
Dieses Ereignis wird ausgelöst, wenn der Titel einer vom Benutzer besuchten Seite erfasst wird. Um Besuche einer Seite zu überwachen, verwenden Sie history.onVisited
. Allerdings enthält das history.HistoryItem
, das dieses Ereignis an seinen Listener übergibt, nicht den Seitentitel, da der Seitentitel normalerweise nicht bekannt ist, wenn history.onVisited
gesendet wird. Stattdessen wird das gespeicherte history.HistoryItem
mit dem Seitentitel aktualisiert, nachdem die Seite geladen wurde und der Titel bekannt ist. Das history.onTitleChanged
-Ereignis wird zu diesem Zeitpunkt ausgelöst. Wenn Sie also die Titel der Seiten kennen müssen, während sie besucht werden, sollten Sie history.onTitleChanged
überwachen.
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 Listener hinzu.
removeListener(listener)
-
Beenden des Zuhörens dieses Ereignisses. Das Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Überprüfen, 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 auftritt. Der Funktion wird ein Objekt mit diesen Eigenschaften übergeben:
id
-
String
. Die eindeutige Kennung für das mit diesem Besuch verknüpftehistory.HistoryItem
. url
-
String
. URL der besuchten Seite. title
-
String
. Titel der besuchten Seite.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Hören Sie auf Titeländerungsereignisse und protokollieren Sie die ID, URL und den Titel der besuchten Seiten.
function handleTitleChanged(item) {
console.log(item.id);
console.log(item.title);
console.log(item.url);
}
browser.history.onTitleChanged.addListener(handleTitleChanged);
Hinweis: Diese API basiert auf der chrome.history
-API von Chromium. Diese Dokumentation wurde aus history.json
im Chromium-Code abgeleitet.