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