history.onVisitRemoved

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

  • Wenn alle Besuche einer einzelnen Seite entfernt werden (beispielsweise durch die Verwendung von history.deleteUrl), wird dieses Ereignis einmal ausgelöst.
  • Wenn ein Bereich von Besuchen entfernt wird (beispielsweise durch die Verwendung von history.deleteRange oder einer Browserfunktion wie "Neueste Chronik löschen"), wird es einmal für jede Seite ausgelöst, deren Besuche alle innerhalb des gelöschten Bereichs liegen.
  • Wenn der gesamte Verlauf des Browsers gelöscht wird (beispielsweise durch die Verwendung von 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 Lauschen auf 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 der Listener registriert ist, andernfalls false.

addListener-Syntax

Parameter

listener

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

removed

object. Details zur 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 ein Element, das die URL der entfernten Seite ist.

Browser-Kompatibilität

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 Chromium-API chrome.history. Diese Dokumentation stammt aus history.json im Chromium-Code.