extension.getViews()
Gibt ein Array der Window-Objekte für jede der Seiten zurück, die innerhalb der aktuellen Erweiterung ausgeführt werden. Dies umfasst beispielsweise:
- die Hintergrundseite, falls eine definiert ist
- alle Popup-Seiten, falls definiert und geladen
- alle Optionsseiten, falls definiert und geladen
- alle Browser-Tabs, die Inhalte hosten, die mit der Erweiterung verpackt sind
In Firefox wird der Rückgabewert, wenn diese Methode von einer Seite aufgerufen wird, die Teil eines privaten Fensters ist, wie z.B. eine Seitenleiste in einem privaten Fenster oder ein Popup, das aus einem privaten Fenster geöffnet wurde, nicht die Hintergrundseite der Erweiterung enthalten.
Syntax
let windows = browser.extension.getViews(
fetchProperties // optional object
)
Parameter
fetchPropertiesOptional-
Ein Objekt mit den folgenden Eigenschaften:
typeOptional-
string. Einextension.ViewType-Wert, der den Typ der zu erhaltenden Ansicht angibt. Wenn weggelassen, gibt diese Funktion alle Ansichten zurück. windowIdOptional-
integer. Das Fenster, auf das die Suche beschränkt werden soll. Wenn weggelassen, gibt diese Funktion alle Ansichten zurück. In Firefox-Version 92 und früher, werden Seitenleistenansichten nicht abgeglichen und daher nicht zurückgegeben.
Rückgabewert
array von object. Array von Window-Objekten.
Beispiele
Alle Fenster abrufen, die zu dieser Erweiterung gehören, und ihre 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 hosten, die mit der Erweiterung verpackt sind:
const windows = browser.extension.getViews({ type: "tab" });
Nur Fenster in Popups abrufen:
const windows = browser.extension.getViews({ type: "popup" });
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.extension API. Diese Dokumentation ist abgeleitet von extension.json im Chromium-Code.