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

js
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. Gibt true zurück, wenn es zuhört, andernfalls false.

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üpfte history.HistoryItem.

url

String. URL der besuchten Seite.

title

String. Titel der besuchten Seite.

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
onTitleChanged
id

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Beispiele

Hören Sie auf Titeländerungsereignisse und protokollieren Sie die ID, URL und den Titel der besuchten Seiten.

js
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.