Spec-Zone.ru › Web Extensions

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

Spec-Zone.ru

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