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
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.
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.