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.

Beispiele

Wenn der Benutzer auf das Symbol einer Browseraktion 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 einen Button 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-Fenstererstellungseigenschaft und window.close() erreicht werden.

Beispielerweiterungen

Browser-Kompatibilität

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