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
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
. Wenntrue
, wird daswindows.Window
-Objekt einetabs
-Eigenschaft haben, die eine Liste vontabs.Tab
-Objekten enthält, die die geöffneten Tabs im Fenster repräsentieren. DieTab
-Objekte enthalten nur die Eigenschaftenurl
,title
undfavIconUrl
, wenn die Manifestdatei der Erweiterung die Berechtigung"tabs"
oder eine übereinstimmende Host-Berechtigung enthält. windowTypes
Optional-
array
vonwindows.WindowType
-Objekten. Wenn gesetzt, wird das zurückgegebenewindows.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
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
get | |||||||
getInfo | |||||||
getInfo.windowTypes |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
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.
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.