windows.getLastFocused()
Ruft das Fenster ab, das zuletzt fokussiert war — typischerweise das Fenster "on top".
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
, wird daswindows.Window
-Objekt einetabs
-Eigenschaft haben, 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 die Berechtigung"tabs"
oder Host-Berechtigungen enthält, die zur URL des Tabs passen. 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']
gesetzt, wobei'panel'
-Fenstertypen auf die eigenen Fenster der Erweiterung beschränkt sind.
Hinweis:
Wenn angegeben, wird der windowTypes
-Bestandteil von getInfo
ignoriert. Die Verwendung von windowTypes
wurde ab Firefox 62 verworfen.
Rückgabewert
Ein Promise
, das mit einem windows.Window
-Objekt erfüllt wird, das die Details des zuletzt fokussierten Fensters enthält. Tritt ein Fehler auf, wird das Promise mit einer Fehlermeldung abgelehnt.
Browser-Kompatibilität
Beispiele
Holen Sie sich das zuletzt fokussierte Fenster und protokollieren Sie die Tabs, die es enthält. Beachten Sie, dass Sie die "tabs"-Berechtigung oder passende Host-Berechtigungen benötigen, um auf die 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 ist abgeleitet von windows.json
im Chromium-Code.