windows.getLastFocused()

Получает окно, которое было последним сфокусированным — обычно окно «сверху».

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let gettingWindow = browser.windows.getLastFocused(
  getInfo               // optional object
)

Параметры

getInfo Необязательный

object.

populate Необязательный: boolean. Если true, объект windows.Window будет иметь свойство tabs, содержащее список объектов tabs.Tab, представляющих вкладки в окне. Объекты Tab содержат только свойства url, title и favIconUrl , если в файле манифеста расширения указано разрешение "tabs" или разрешения хоста, соответствующие URL вкладки.
windowTypes Необязательный: Массив объектов windows.WindowType. Если задано, возвращаемое windows.Window будет отфильтровано по типу. Если не задано, используется фильтр по умолчанию — ['normal', 'panel', 'popup'], с ограничением на типы окон 'panel' расширения только для собственных окон.

Примечание: Если указан, компонент windowTypes в getInfo игнорируется. Использование windowTypes устарело с Firefox 62.

Значение возврата

A Promise, который будет выполнен с объектом windows.Window, содержащим данные о последнем сфокусированном окне. Если произошла ошибка, обещание будет отклонено с сообщением об ошибке.

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

	Рабочий стол						Мобильное устройство
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`getLastFocused`	Да	14	45	?	Да	14	?	?	Нет	?	15	?
`getInfo`	18	14	45	?	15	14	?	?	Нет	?	15	?

Примеры

Получите последнее сфокусированное окно и выведите содержащиеся в нём вкладки. Обратите внимание, что вам потребуется разрешение «вкладки» (разрешение) или соответствующие разрешения хоста (разрешения хоста) для доступа к URL-адресам вкладок.

function logTabs(windowInfo) {
  for (const tabInfo of windowInfo.tabs) {
    console.log(tabInfo.url);
  }
}

function onError(error) {
  console.error(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  browser.windows.getLastFocused({ populate: true }).then(logTabs, onError);
});

Примечание: Этот 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/getLastFocused