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

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.