windows.getLastFocused()
Erhält das Fenster, das zuletzt im Fokus war — typischerweise das Fenster 'obenauf'.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let gettingWindow = browser.windows.getLastFocused(
getInfo // optional object
)
Parameter
getInfo
Optional-
object
.populate
Optional-
boolean
. Wenntrue
, enthält daswindows.Window
Objekt einetabs
Eigenschaft, die eine Liste vontabs.Tab
Objekten enthält, die die Tabs im Fenster repräsentieren. DieTab
Objekte enthalten nur die Eigenschaftenurl
,title
undfavIconUrl
, wenn die Manifestdatei der Erweiterung entweder die Berechtigung"tabs"
oder Host-Berechtigungen enthält, die mit der URL des Tabs übereinstimmen. windowTypes
Optional-
Ein
array
vonwindows.WindowType
Objekten. Wenn gesetzt, wird das zurückgegebenewindows.Window
basierend auf seinem Typ gefiltert. Wenn nicht gesetzt, ist der Standardfilter auf['normal', 'panel', 'popup']
eingestellt, wobei'panel'
Fenstertypen auf die Fenster der Erweiterung beschränkt sind.
Hinweis:
Wenn angegeben, wird die windowTypes
Komponente von getInfo
ignoriert. Die Verwendung von windowTypes
wurde ab Firefox 62 als veraltet markiert.
Rückgabewert
Ein Promise
, das mit einem windows.Window
Objekt erfüllt wird, welches die Details des zuletzt fokussierten 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 | ||||||
---|---|---|---|---|---|---|---|
getLastFocused | |||||||
getInfo | |||||||
getInfo.windowTypes |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
Beispiele
Erhalten Sie das zuletzt fokussierte Fenster und loggen Sie die darin enthaltenen Tabs. Beachten Sie, dass Sie die "tabs" Berechtigung oder passende Host-Berechtigungen benötigen, um auf Tab-URLs zuzugreifen.
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.getLastFocused({ populate: true }).then(logTabs, onError);
});
Hinweis:
Diese API basiert auf der chrome.windows
API von Chromium. Diese Dokumentation stammt von windows.json
im Chromium-Code.