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 Pop-up-Seiten, falls definiert und geladen
  • alle Optionsseiten, falls definiert und geladen
  • alle Browser-Tabs, die mit der Erweiterung verpackten Inhalt hosten

In Firefox, wenn diese Methode von einer Seite aufgerufen wird, die Teil eines privaten Browsing-Fensters ist, wie ein Sidebar in einem privaten Fenster oder ein Pop-up, das von einem privaten Fenster aus geöffnet wurde, dann wird der Rückgabewert 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, der den Typ der Ansicht angibt, die abgerufen werden soll. Falls weggelassen, gibt diese Funktion alle Ansichten zurück.

windowId Optional

integer. Das Fenster, in dem die Suche eingeschränkt werden soll. Bei Weglassen gibt diese Funktion alle Ansichten zurück. In Firefox-Version 92 und früher werden Sidebar-Ansichten nicht abgeglichen und daher nicht zurückgegeben.

Rückgabewert

array von object. Array von Window-Objekten.

Browser-Kompatibilität

Beispiele

Holen Sie sich alle Fenster, die zu dieser Erweiterung gehören, und protokollieren Sie deren URLs:

js
const windows = browser.extension.getViews();

for (const extensionWindow of windows) {
  console.log(extensionWindow.location.href);
}

Holen Sie sich nur Fenster in Browser-Tabs, die Inhalte hosten, die mit der Erweiterung verpackt sind:

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

Holen Sie sich nur Fenster in Pop-ups:

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.