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-
arrayinteger. 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 | 6345–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