history.onVisitRemoved

Вызывается, когда страница полностью удалена из истории браузера.

Если все посещения одной страницы удаляются (например, с помощью history.deleteUrl), то это событие срабатывает один раз.
Если удаляется диапазон посещений (например, с помощью history.deleteRange или функции браузера, такой как «Очистить историю» ), то оно срабатывает один раз для каждой страницы, посещения которой полностью попадают в удалённый диапазон.
Если вся история браузера очищается (например, с помощью history.deleteAll), то оно срабатывает только один раз.

Синтаксис

browser.history.onVisitRemoved.addListener(listener)
browser.history.onVisitRemoved.removeListener(listener)
browser.history.onVisitRemoved.hasListener(listener)

События имеют три функции:

addListener(callback): Добавляет обработчик для этого события.
removeListener(listener): Прекращает прослушивание этого события. Аргумент listener — это обработчик, который нужно удалить.
hasListener(listener): Проверяет, зарегистрирован ли listener для этого события. Возвращает true , если обработчик зарегистрирован, false в противном случае.

Синтаксис addListener

Параметры

callback

Функция, которая будет вызвана при возникновении этого события. Функции будет передан следующий аргумент:

removed

object. Детали удаления. Это объект, содержащий две свойства: булево allHistory и массив urls.

Если это событие срабатывает из-за очистки всей истории, allHistory будет true , а urls будет пустым массивом.
В противном случае, allHistory будет false , а urls будет содержать один элемент, который представляет собой URL удалённой страницы.

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`onVisitRemoved`	Да	79	50	?	Да	Нет	?	?	Нет	?	Нет	?

Примеры

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

Примечание: Этот API основан на API chrome.history Chromium. Данная документация взята из history.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/history/onVisitRemoved