index.md

---

title: windows.remove()
slug: Mozilla/Add-ons/WebExtensions/API/windows/remove
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Extensions
  - Method
  - Non-standard
  - Reference
  - WebExtensions
  - Windows
  - close
  - remove
browser-compat: webextensions.api.windows.remove

---

{{AddonSidebar()}}

Closes a window and all the tabs inside it, given the window's ID.

This is an asynchronous function that returns a Promise.

Syntax

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

Parameters

• windowId

  • : integer. ID of the window to close.

Return value

A Promise that will be fulfilled with no arguments when the window has been closed. If any error occurs, the promise will be rejected with an error message.

Browser compatibility

{{Compat}}

Examples

When the user clicks a browser action's icon, close the window in which the icon was clicked:

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

});

Close the current, e.g. popup, window when the user clicks a button on the page:

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

In Firefox, the same could be achieved with the .allowScriptsToClose window creation property and window.close().

{{WebExtExamples}}

Note: This API is based on Chromium's chrome.windows API. This documentation is derived from windows.json in the Chromium code.