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

js
let windows = browser.extension.getViews(
  fetchProperties // optional object
)

Parameter

fetchProperties Optional

Ein Objekt mit den folgenden Eigenschaften:

type Optional

string. Ein extension.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:

js
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:

js
const windows = browser.extension.getViews({ type: "tab" });

Nur Fenster in Pop-ups abrufen:

js
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.