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

js
let gettingWindow = browser.windows.getLastFocused(
  getInfo               // optional object
)

Parameter

getInfo Optional

object.

populate Optional

boolean. Wenn true, enthält das windows.Window Objekt eine tabs Eigenschaft, die eine Liste von tabs.Tab Objekten enthält, die die Tabs im Fenster repräsentieren. Die Tab Objekte enthalten nur die Eigenschaften url, title und favIconUrl, 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 von windows.WindowType Objekten. Wenn gesetzt, wird das zurückgegebene windows.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 GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
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.

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