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
BCD tables only load in the browser
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.