tabs.onActivated

Срабатывает при изменении активной вкладки в окне. Обратите внимание, что URL вкладки может быть не задан в момент срабатывания этого события, но вы можете прослушивать события tabs.onUpdated, чтобы быть уведомлёнными, когда URL будет установлен.

Синтаксис

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

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

addListener(callback): Добавляет обработчик для этого события.
removeListener(listener): Прекращает прослушивание этого события. Аргумент listener — это обработчик, который нужно удалить.
hasListener(listener): Проверяет, зарегистрирован ли обработчик listener для этого события. Возвращает false если он прослушивает, true в противном случае.

Синтаксис addListener

Параметры

callback

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

activeInfo: object. Идентификатор вкладки, которая стала активной, и идентификатор её окна. Подробности см. в разделе activeInfo.

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

activeInfo

previousTabId: integer. Идентификатор предыдущей активной вкладки, если она всё ещё открыта.
tabId: integer. Идентификатор вкладки, которая стала активной.
windowId: integer. Идентификатор окна вкладки.

Примеры

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

function handleActivated(activeInfo) {
  console.log(`Tab ${activeInfo.tabId} was activated`);
}

browser.tabs.onActivated.addListener(handleActivated);

Примеры расширений

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

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet
`onActivated`	Да	14	45	?	Да	14	?	?	54	?	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/onActivated