windows.getAll()

Gets information about all open windows, passing them into a callback.

This is an asynchronous function that returns aPromise.

Syntax

let gettingAll = browser.windows.getAll(  getInfo                // optional object)

Parameters

getInfoOptional

object. This controls whatwindows.Window objects are retrieved.

populateOptional: boolean. Defaults tofalse. If set totrue, eachwindows.Window object will have atabs property that contains a list oftabs.Tab objects representing the tabs in that window. TheTab objects will contain theurl,title andfavIconUrl properties only if the extension's manifest file includes the"tabs" permission orhost permissions that match the tab's URL.
windowTypesOptional: Anarray ofwindows.WindowType objects. If set, thewindows.Window objects returned will be filtered based on their type. If unset the default filter is set to['normal', 'panel', 'popup'], with'panel' window types limited to the extension's own windows.

APromise that will be fulfilled with an array ofwindows.Window objects, representing all windows that match the given criteria. If any error occurs, the promise will be rejected with an error message.

Examples

Log the URLs for the tabs across all "normal" browser windows. Note that you'll need the "tabs"permission or matchinghost permissions to access tab URLs.

function logTabsForWindows(windowInfoArray) {  for (const windowInfo of windowInfoArray) {    console.log(`Window: ${windowInfo.id}`);    console.log(windowInfo.tabs.map((tab) => tab.url));  }}function onError(error) {  console.error(`Error: ${error}`);}browser.browserAction.onClicked.addListener((tab) => {  browser.windows    .getAll({      populate: true,      windowTypes: ["normal"],    })    .then(logTabsForWindows, onError);});