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.deleteRangeoder 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
listenerist der zu entfernende Listener. hasListener(listener)-
Überprüft, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurü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 booleschesallHistoryund ein Arrayurls.- Wenn dieses Ereignis ausgelöst wird, weil der gesamte Verlauf gelöscht wurde, ist
allHistorytrueundurlsist ein leeres Array. - Andernfalls ist
allHistoryfalseundurlsenthä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.