windows.remove()

Schließt ein Fenster und alle darin enthaltenen Tabs anhand der ID des Fensters.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

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

Parameter

windowId

integer. ID des zu schließenden Fensters.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn das Fenster geschlossen wurde. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

Beispiele

Wenn der Benutzer auf das Symbol einer Browser-Aktion klickt, schließen Sie das Fenster, in dem auf das Symbol geklickt wurde:

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

Schließen Sie das aktuelle, z.B. Popup-Fenster, wenn der Benutzer auf eine Schaltfläche auf der Seite klickt:

js
// 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 könnte dasselbe mit der .allowScriptsToClose Fenstereigenschaft beim Erstellen und window.close() erreicht werden.

Beispielerweiterungen

Hinweis: Diese API basiert auf der chrome.windows API von Chromium. Diese Dokumentation ist abgeleitet von windows.json im Chromium-Code.