extension.getViews()
Gibt ein Array der Window-Objekte für jede der Seiten zurück, die innerhalb der aktuellen Erweiterung ausgeführt werden. Dazu gehören beispielsweise:
- die Hintergrundseite, falls eine definiert ist
- alle Pop-up-Seiten, falls definiert und geladen
- alle Optionsseiten, falls definiert und geladen
- alle Browser-Tabs, die Inhalte der Erweiterung hosten
In Firefox wird der Rückgabewert, wenn diese Methode von einer Seite aufgerufen wird, die Teil eines privaten Browserfensters ist, wie zum Beispiel eine Seitenleiste in einem privaten Fenster oder ein Pop-up, das von einem privaten Fenster geöffnet wird, die Hintergrundseite der Erweiterung nicht enthalten.
Syntax
let windows = browser.extension.getViews(
fetchProperties // optional object
)
Parameter
fetchProperties
Optional-
Ein Objekt mit den folgenden Eigenschaften:
type
Optional-
string
. Einextension.ViewType
, der den Typ der abzurufenden Ansicht angibt. Falls weggelassen, gibt diese Funktion alle Ansichten zurück. windowId
Optional-
integer
. Das Fenster, auf das die Suche beschränkt werden soll. Falls weggelassen, gibt diese Funktion alle Ansichten zurück. In Firefox Version 92 und früher werden Seitenleisten-Ansichten nicht berücksichtigt und daher nicht zurückgegeben.
Rückgabewert
array
von object
. Array von Window-Objekten.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Alle Fenster dieser Erweiterung abrufen und deren URLs protokollieren:
const windows = browser.extension.getViews();
for (const extensionWindow of windows) {
console.log(extensionWindow.location.href);
}
Nur Fenster in Browser-Tabs abrufen, die Inhalte der Erweiterung hosten:
const windows = browser.extension.getViews({ type: "tab" });
Nur Fenster in Pop-ups abrufen:
const windows = browser.extension.getViews({ type: "popup" });
Hinweis: Diese API basiert auf der chrome.extension
-API von Chromium. Diese Dokumentation stammt aus extension.json
im Chromium-Code.