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
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:
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:
// 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.