Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 durch die Verwendung von history.deleteUrl), wird dieses Ereignis einmal ausgelöst.
  • Wenn ein Bereich von Besuchen entfernt wird (zum Beispiel durch die Verwendung von history.deleteRange oder einer Browserfunktion wie "Jüngsten Verlauf löschen"), wird es einmal für jede Seite ausgelöst, deren Besuche vollständig innerhalb des gelöschten Bereichs liegen.
  • Wenn der gesamte Browserverlauf gelöscht wird (zum Beispiel 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)

Stoppt 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 es lauscht, andernfalls false.

addListener Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird folgendes 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.

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);

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.history API von Chromium. Diese Dokumentation leitet sich von history.json im Chromium-Code ab.