Spec-Zone.ru › Web Extensions

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);

});

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

  • 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/update

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API