Spec-Zone.ru › Web Extensions

history.onVisited

Срабатывает каждый раз, когда пользователь посещает страницу. В слушатель передаётся объект history.HistoryItem. Это событие срабатывает до загрузки страницы.

Синтаксис

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

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

addListener(callback)

Добавляет слушатель к этому событию.

removeListener(listener)

Прекращает прослушивание этого события. Аргумент listener — слушатель, который нужно удалить.

hasListener(listener)

Проверяет, зарегистрирован ли listener для этого события. Возвращает true при наличии прослушивания, и false — в противном случае.

Синтаксис addListener

Параметры

callback

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

result

history.HistoryItem. Объект, представляющий элемент в истории браузера.

В момент отправки этого события браузер ещё не знает заголовок страницы. Если браузер посещал эту страницу ранее и запомнил её старый заголовок, то объект HistoryItem.title будет содержать старый заголовок страницы. Если браузер не сохранил старый заголовок страницы, то HistoryItem.title будет пустым. Чтобы получить заголовки страниц как только они станут известны, подпишитесь на событие history.onTitleChanged.

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

Десктоп Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet
onVisited Да 79
50До версии 56 объект результата 'title' всегда был пустой строкой. Начиная с версии 56, он устанавливается в последний известный заголовок, если он доступен, или в пустую строку в противном случае.
? Да Нет ? ? Нет ? Нет ?

Примеры

Прослушивание посещений и регистрация URL-адреса и времени посещения.

function onVisited(historyItem) {
  console.log(historyItem.url);
  console.log(new Date(historyItem.lastVisitTime));
}

browser.history.onVisited.addListener(onVisited);

Примечание: Этот 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/onVisited

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API