Окна
Взаимодействие с окнами браузера. Вы можете использовать этот API для получения информации об открытых окнах, а также для открытия, изменения и закрытия окон. Вы также можете прослушивать события открытия, закрытия и активации окна.
Типы
windows.WindowType-
Тип окна браузера.
windows.WindowState-
Состояние окна браузера.
windows.Window-
Содержит информацию об окне браузера.
windows.CreateType-
Указывает тип создаваемого окна браузера.
Константы
windows.WINDOW_ID_NONE-
Значение
windowId, обозначающее отсутствие окна браузера. windows.WINDOW_ID_CURRENT-
Значение, которое может быть использовано вместо
windowIdв некоторых API для представления текущего окна.
Методы
windows.get()-
Получает подробную информацию о окне по его ID.
windows.getCurrent()-
Получает текущее окно.
windows.getLastFocused()-
Получает окно, которое было в фокусе последним — обычно это окно «сверху».
windows.getAll()-
Получает все окна.
windows.create()-
Создаёт новое окно.
windows.update()-
Обновляет свойства окна. Используйте это для перемещения, изменения размера, (снятия/установки) фокуса окна и т. п.
windows.remove()-
Закрывает окно и все его вкладки.
События
windows.onCreated-
Вызывается при создании окна.
windows.onRemoved-
Вызывается при закрытии окна.
windows.onFocusChanged-
Вызывается при изменении фокусированного окна.
Совместимость с браузерами
| Рабочий стол | Мобильные | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
CreateType |
Даdetached_panel не поддерживается. |
14panel и detached_panel не поддерживаются. |
45 | ? | Даdetached_panel не поддерживается. |
14panel и detached_panel не поддерживаются. |
? | ? | Нет | ? | 15panel и detached_panel не поддерживаются. |
? |
WINDOW_ID_CURRENT |
18 | 14 | 45 | ? | 15 | 14 | ? | ? | Нет | ? | 15 | ? |
WINDOW_ID_NONE |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
Window |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
WindowState |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
WindowType |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
create |
Да | 14 | 45["'url' и 'tabId options can't both be set together.", "Возвращаемый объект 'Window' содержит свойство 'tabs' только начиная с версии 52.", "С Firefox 86 опцияfocused: false игнорируется."] |
? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
get |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
getAll |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
getCurrent |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
getLastFocused |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
onCreated |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15Вызывает пару событий: одно для приватного, другое для обычного просмотра. |
? |
onFocusChanged |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15Вызывается при переключении в режим приватного просмотра, при переходе в браузер из главного экрана и при возвращении в браузер с главного экрана. |
? |
onRemoved |
Да | 79 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
remove |
Да | 79 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
update |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
Примеры расширений
- annotate-page
- bookmark-it
- private-browsing-theme
- store-collected-images
- theme-integrated-sidebar
- window-manipulator
Примечание: Этот 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
