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
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. Gibttrue
zurück, wenn es lauscht, andernfallsfalse
.
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 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
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);
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf der chrome.history
API von Chromium. Diese Dokumentation leitet sich von history.json
im Chromium-Code ab.