history.onTitleChanged

Ausgelöst, wenn der Titel einer vom Benutzer besuchten Seite aufgezeichnet wird. Um Besuche auf einer Seite zu hören, verwenden Sie history.onVisited. Das history.HistoryItem jedoch, das dieses Ereignis an seinen Listener weitergibt, enthält keinen 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, sobald der Titel bekannt ist. Das history.onTitleChanged Ereignis wird zu diesem Zeitpunkt ausgelöst. Wenn Sie also die Titel der besuchten Seiten wissen möchten, 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 Listener hinzu.
removeListener(listener): Beendet das Hören auf dieses Ereignis. Das listener-Argument ist der zu entfernende Listener.
hasListener(listener): Überprüfen Sie, 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 history.HistoryItem, das mit diesem Besuch verknüpft ist.
url: String. URL der besuchten Seite.
title: String. Titel der besuchten Seite.

Browser-Kompatibilität

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 stammt von history.json im Chromium-Code.