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

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.