windows.remove()

Schließt ein Fenster und alle darin enthaltenen Tabs, basierend auf 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 Fensters, das geschlossen werden soll.

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

BCD tables only load in the browser

Beispiele

Wenn der Benutzer auf das Symbol einer Browser-Aktion klickt, schließen Sie das Fenster, in dem das Symbol angeklickt 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 dies mit der .allowScriptsToClose-Eigenschaft des Fenstererstellungsprozesses und window.close() erreicht werden.

Beispiel-Erweiterungen

Hinweis: Diese API basiert auf der Chromium-API chrome.windows. Diese Dokumentation stammt aus windows.json im Chromium-Code.