history.onTitleChanged
Вызывается, когда записывается заголовок страницы, посещенной пользователем. Чтобы прослушивать посещения страниц, используйте history.onVisited. Однако, history.HistoryItem, передаваемый этим событием в его обработчик, не содержит заголовка страницы, потому что заголовок страницы обычно неизвестен в момент, когда history.onVisited отправляется. Вместо этого хранимая history.HistoryItem обновляется с заголовком страницы после загрузки страницы, когда заголовок становится известен. Событие history.onTitleChanged вызывается в этот момент. Таким образом, если вам нужно знать заголовки страниц при их посещении, прослушивайте history.onTitleChanged.
Синтаксис
browser.history.onTitleChanged.addListener(listener) browser.history.onTitleChanged.removeListener(listener) browser.history.onTitleChanged.hasListener(listener)
События имеют три функции:
addListener(listener)-
Добавляет обработчик к этому событию.
removeListener(listener)-
Прекращает прослушивание этого события. Аргумент
listener— это обработчик, который нужно удалить. hasListener(listener)-
Проверяет, зарегистрирован ли
listenerдля этого события. Возвращаетtrueесли он прослушивает,falseв противном случае.
Синтаксис addListener
Параметры
callback-
Функция, которая вызывается при возникновении этого события. Функция получает объект со следующими свойствами:
id-
String. Уникальный идентификаторhistory.HistoryItem, связанный с этим посещением. url-
String. URL посещенной страницы. title-
String. Заголовок посещенной страницы.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
onTitleChanged |
Нет | Нет | 55 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
id |
Нет | Нет | 86 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
Примеры
Прослушивание событий изменения заголовка и вывод ID, URL и заголовка посещенных страниц.
function handleTitleChanged(item) { console.log(item.id); console.log(item.title); console.log(item.url); } browser.history.onTitleChanged.addListener(handleTitleChanged);
Примечание: Этот API основан на chrome.history API 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/onTitleChanged