windows.update()
Обновляет свойства окна. Используется для перемещения, изменения размера и (снятия/установки) фокуса окна и т.д.
Это асинхронная функция, которая возвращает Promise.
Синтаксис
let updating = browser.windows.update( windowId, // integer updateInfo // object )
Параметры
windowId-
integer. Идентификатор окна, которое необходимо обновить. updateInfo-
object. Объект, содержащий свойства для обновления.-
drawAttentionНеобязательно -
boolean. Еслиtrue, вызывает отображение окна таким образом, чтобы привлечь внимание пользователя к окну, не меняя фокусированное окно. Эффект сохраняется до тех пор, пока пользователь не переключит фокус на другое окно. Этот параметр не имеет эффекта, если окно уже имеет фокус. Установите в значениеfalseдля отмены предыдущего запросаdrawAttention. -
focusedНеобязательно -
boolean. Еслиtrue, выводит окно вперёд. Если false, выводит следующее окно в порядке z-индекса вперёд. -
heightНеобязательно -
integer. Высота окна в пикселях для изменения размера. Для панелей это значение игнорируется. -
leftНеобязательно -
integer. Смещение от левого края экрана в пикселях для перемещения окна. Для панелей это значение игнорируется. -
stateНеобязательно -
windows.WindowState. Новое состояние окна. Состоянияminimized,maximizedиfullscreenне могут быть объединены сleft,top,widthилиheight. -
titlePrefaceНеобязательно -
string. Используется для добавления строки в начало заголовка окна браузера. В зависимости от используемой операционной системы, это может не сработать для окон браузера без заголовка (например, about:blank в Firefox). -
topНеобязательно -
integer. Смещение от верхнего края экрана в пикселях для перемещения окна. Для панелей это значение игнорируется. -
widthНеобязательно -
integer. Ширина окна в пикселях для изменения размера. Для панелей это значение игнорируется.
-
Значение, возвращаемое функцией
A Promise, который будет выполнен с объектом windows.Window, содержащим сведения об обновленном окне. Если произойдет ошибка, обещание будет отклонено с сообщением об ошибке.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | |
update |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
drawAttention |
Да | 79 | 45 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
focused |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15update() не будет переключаться между режимами отображения Safari рядом на iPadOS. |
? |
height |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
left |
Да | 79 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
state |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
titlePreface |
Нет | Нет | 56 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
top |
Да | 79 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
width |
Да | 14 | 45 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
Примеры
При нажатии пользователем значка расширения браузера, переместите окно в верхний левый угол:
function onUpdated(windowInfo) { console.log(`Updated window: ${windowInfo.id}`); } function onError(error) { console.log(`Error: ${error}`); } browser.browserAction.onClicked.addListener((tab) => { let updating = browser.windows.update(tab.windowId, { left: 0, top: 0 }); updating.then(onUpdated, 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/update