windows.remove()

Закрывает окно и все вложенные в него вкладки, используя ID окна.

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

Синтаксис

let removing = browser.windows.remove(
  windowId        // integer
)

Параметры

windowId: integer. ID окна, которое нужно закрыть.

Возвращаемое значение

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

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

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`remove`	Да	79	45	?	Да	14	?	?	Нет	?	Нет	?

Примеры

При нажатии пользователем на значок действия браузера, закройте окно, в котором был нажат значок:

function onRemoved() {
  console.log(`Removed window`);
}

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

browser.browserAction.onClicked.addListener((tab) => {

  let removing = browser.windows.remove(tab.windowId);
  removing.then(onRemoved, onError);

});

Закройте текущее окно (например, всплывающее окно) при нажатии пользователем на кнопку на странице:

// in a script loaded by the page in the window
document.querySelector('#close').addEventListener(async ({ button, }) => { try {
  if (button) return; // not a left click
  const windowId = (await browser.windows.getCurrent()).id;
  await browser.windows.remove(windowId);
  // this point will never be reached, since the window is gone
} catch (error) { console.error('Closing failed:', error); } });

В Firefox то же самое можно было бы достичь с помощью свойства создания окна .allowScriptsToClose и window.close().

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

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/remove