windows.getLastFocused()

Syntax

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, welche die Tabs im Fenster repräsentieren. Die Tab Objekte enthalten nur die Eigenschaften url, title und favIconUrl, wenn die Manifest-Datei 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 nach 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.

Rückgabewert

Ein Promise, das mit einem windows.Window Objekt erfüllt wird, das die Details des zuletzt fokussierten Fensters enthält. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Ermitteln Sie das zuletzt fokussierte Fenster und protokollieren Sie die enthaltenen Tabs. Beachten Sie, dass Sie die Berechtigung "tabs" permission oder entsprechende 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);
});

Browser-Kompatibilität