Spec-Zone.ru › Web Extensions

tabs.onHighlighted

Вызывается при изменении набора выделенных вкладок в окне.

Обратите внимание, что до версии 63 в Firefox не было концепции выделения нескольких вкладок, поэтому данное событие было просто псевдонимом для tabs.onActivated.

Синтаксис

browser.tabs.onHighlighted.addListener(listener)
browser.tabs.onHighlighted.removeListener(listener)
browser.tabs.onHighlighted.hasListener(listener)

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

addListener(callback)

Добавляет обработчик на данное событие.

removeListener(listener)

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

hasListener(listener)

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

Синтаксис addListener

Параметры

callback

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

highlightInfo

object. ID выделенных вкладок и ID их окна. Дополнительные подробности см. в разделе highlightInfo.

Дополнительные объекты

highlightInfo

windowId

integer. ID окна, в котором изменились вкладки.

tabIds

array integer. ID выделенных вкладок в окне.

Примеры

Прослушивание событий выделения и вывод ID выделенных вкладок:

function handleHighlighted(highlightInfo) {
  console.log(`Highlighted tabs: ${highlightInfo.tabIds}`);
}

browser.tabs.onHighlighted.addListener(handleHighlighted);

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

Рабочие столы Мобильные
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet
onHighlighted Да 79 63
45–62Реализовано как псевдоним для onActivated.
? Нет 14 ? ?
54Реализовано как псевдоним для onActivated.
? 15 ?

Примечание: Этот API основан на API chrome.tabs Chromium. Данная документация взята из tabs.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/tabs/onHighlighted

Spec-Zone.ru

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