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

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

Parameter

getInfo Optional

object.

populate Optional

boolean. Wenn true, wird das windows.Window-Objekt eine tabs-Eigenschaft haben, 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 die Berechtigung "tabs" oder Host-Berechtigungen enthält, die zur URL des Tabs passen.

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

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 ist abgeleitet von windows.json im Chromium-Code.