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
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. Gibttrue
zurück, wenn es zuhört, andernfallsfalse
.
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 booleschesallHistory
und ein Arrayurls
.- Wenn dieses Ereignis ausgelöst wird, weil der gesamte Verlauf gelöscht wurde, ist
allHistory
true
undurls
ist ein leeres Array. - Andernfalls ist
allHistory
false
undurls
enthält einen Eintrag, der die URL der entfernten Seite ist.
- Wenn dieses Ereignis ausgelöst wird, weil der gesamte Verlauf gelöscht wurde, ist
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
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.