windows.onFocusChanged

Срабатывает при изменении фокуса текущего окна. Будет windows.WINDOW_ID_NONE, если все окна браузера потеряли фокус.

Примечание: В Windows и некоторых менеджерах окон Linux WINDOW_ID_NONE всегда будет отправлен непосредственно перед переключением с одного окна браузера на другое.

Синтаксис

browser.windows.onFocusChanged.addListener(listener)
browser.windows.onFocusChanged.removeListener(listener)
browser.windows.onFocusChanged.hasListener(listener)

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

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

Синтаксис addListener

Параметры

callback

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

windowId: integer. Идентификатор вновь получившего фокус окна.

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`onFocusChanged`	Да	14	45	?	Да	14	?	?	Нет	?	15 Срабатывает при переключении в/из режима приватного просмотра, выходе из Safari на главный экран и возвращении в Safari с главного экрана.	?

Примеры

Запись изменений фокуса:

browser.windows.onFocusChanged.addListener((windowId) => {
  console.log(`Newly focused window: ${windowId}`);
});

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

bookmark-it

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