windows.get()

Erhält Details zu einem Fenster anhand seiner ID. Die Details werden in einen Rückruf übergeben.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let getting = browser.windows.get(
  windowId,              // integer
  getInfo                // optional object
)

Parameter

windowId

integer. Die ID des Fensterobjekts, das Sie zurückgegeben haben möchten.

getInfo Optional

object. Enthält Optionen, um den Fenstertyp zu filtern.

populate Optional

boolean. Wenn true, wird das windows.Window-Objekt eine tabs-Eigenschaft haben, die eine Liste von tabs.Tab-Objekten enthält, die die geöffneten Tabs im Fenster repräsentieren. Die Tab-Objekte enthalten nur die Eigenschaften url, title und favIconUrl, wenn die Manifestdatei der Erweiterung die Berechtigung "tabs" oder eine übereinstimmende Host-Berechtigung enthält.

windowTypes Optional

array von windows.WindowType-Objekten. Wenn gesetzt, wird das zurückgegebene windows.Window basierend auf seinem Typ gefiltert. Wenn nicht gesetzt, wird der Standardfilter auf ['normal', 'panel', 'popup'] gesetzt, wobei Fenster vom Typ 'panel' auf die eigenen Fenster der Erweiterung beschränkt sind.

Hinweis: Wenn vorhanden, wird die windowTypes-Komponente von getInfo ignoriert. Die Verwendung von windowTypes wurde ab Firefox 62 veraltet.

Rückgabewert

Ein Promise, das mit einem windows.Window-Objekt erfüllt wird, das die Details des Fensters enthält. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Dieses Beispiel erhält das aktuelle Fenster und protokolliert die URLs der darin enthaltenen Tabs. Beachten Sie, dass Sie die Berechtigung "tabs" permission oder entsprechende Host-Berechtigungen benötigen, um auf Tab-URLs zuzugreifen.

Hinweis: Dieses Beispiel ist etwas unrealistisch: In dieser Situation würden Sie wahrscheinlich eher windows.getCurrent() verwenden.

js
function logTabs(windowInfo) {
  for (const tabInfo of windowInfo.tabs) {
    console.log(tabInfo.url);
  }
}

function onError(error) {
  console.error(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  browser.windows.get(tab.windowId, { populate: true }).then(logTabs, onError);
});

Hinweis: Diese API basiert auf der chrome.windows API von Chromium. Diese Dokumentation stammt aus windows.json im Chromium-Code.