Interact with browser windows. You can use this API to get information about open windows and to open, modify, and close windows. You can also listen for window open, close, and activate events.

Types

windows.WindowType
The type of browser window this is.
windows.WindowState
The state of this browser window.
windows.Window
Contains information about a browser window.
windows.CreateType
Specifies the type of browser window to create.

Properties

windows.WINDOW_ID_NONE
The windowId value that represents the absence of a browser window.
windows.WINDOW_ID_CURRENT
A value that can be used in place of a windowId in some APIs to represent the current window.

Functions

windows.get()
Gets details about a window, given its ID.
windows.getCurrent()
Gets the current window.
windows.getLastFocused()
Gets the window that was most recently focused — typically the window 'on top'.
windows.getAll()
Gets all windows.
windows.create()

Creates a new window.

windows.update()
Updates the properties of a window. Use this to move, resize, and (un)focus a window, etc.
windows.remove()
Closes a window, and all its tabs.

Events

windows.onCreated
Fired when a window is created.
windows.onRemoved
Fired when a window is closed.
windows.onFocusChanged
Fired when the currently focused window changes.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
CreateType Yes *14 *45 No Yes *
WINDOW_ID_CURRENT181445 No15
WINDOW_ID_NONE Yes1445 No Yes
Window Yes1445 No Yes
WindowState Yes1445 No Yes
WindowType Yes1445 No Yes
create Yes1445 * No Yes
get Yes1445 No Yes
getAll Yes1445 No Yes
getCurrent Yes1445 No Yes
getLastFocused Yes1445 No Yes
onCreated Yes1445 No Yes
onFocusChanged Yes1445 No Yes
onRemoved Yes No45 No Yes
remove Yes No45 No Yes
update Yes1445 No Yes

Example extensions

Acknowledgements

This API is based on Chromium's chrome.windows API. This documentation is derived from windows.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: Mossop, wbamberg, abbycar, chrisdavidmills, bsilverberg
 Last updated by: Mossop,