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

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

Parameter

fetchProperties Optional

Ein Objekt mit den folgenden Eigenschaften:

type Optional

string. Ein extension.ViewType-Wert, der den Typ der zu erhaltenden Ansicht angibt. Wenn weggelassen, gibt diese Funktion alle Ansichten zurück.

windowId Optional

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:

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

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

Nur Fenster in Popups abrufen:

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

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.extension API. Diese Dokumentation ist abgeleitet von extension.json im Chromium-Code.