history.onVisitRemoved

Wird ausgelöst, wenn eine Seite vollständig aus dem Browserverlauf entfernt wird.

  • Wenn alle Besuche einer einzelnen Seite entfernt werden (zum Beispiel mit history.deleteUrl), wird dieses Ereignis einmal ausgelöst.
  • Wenn ein Bereich von Besuchen entfernt wird (zum Beispiel mit history.deleteRange oder einer Browserfunktion wie "Neueste Chronik löschen"), wird es einmal für jede Seite ausgelöst, deren Besuche vollständig innerhalb des bereinigten Bereichs liegen.
  • Wenn der gesamte Verlauf des Browsers gelöscht wird (zum Beispiel mit history.deleteAll), wird es nur einmal ausgelöst.

Syntax

js
browser.history.onVisitRemoved.addListener(listener)
browser.history.onVisitRemoved.removeListener(listener)
browser.history.onVisitRemoved.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Beendet das Zuhören für dieses Ereignis. Das Argument listener ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es zuhört, andernfalls false.

Syntax für addListener

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis auftritt. Der Funktion wird dieses Argument übergeben:

removed

object. Details der Entfernung. Dies ist ein Objekt, das zwei Eigenschaften enthält: ein boolesches allHistory und ein Array urls.

  • Wenn dieses Ereignis ausgelöst wird, weil der gesamte Verlauf gelöscht wurde, ist allHistory true und urls ist ein leeres Array.
  • Andernfalls ist allHistory false und urls enthält einen Eintrag, der die URL der entfernten Seite ist.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

js
function onRemoved(removed) {
  if (removed.allHistory) {
    console.log("All history removed");
  } else if (removed.urls.length) {
    console.log(`URL removed: ${removed.urls[0]}`);
  }
}

browser.history.onVisitRemoved.addListener(onRemoved);

Hinweis: Diese API basiert auf der chrome.history API von Chromium. Diese Dokumentation ist abgeleitet von history.json im Chromium-Code.