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
The windowId value that represents 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 * Yes *45 No Yes *
WINDOW_ID_CURRENT18 Yes45 No15
WINDOW_ID_NONE Yes Yes45 No Yes
Window Yes * Yes *45 * No Yes *
WindowState Yes Yes *45 * No Yes
WindowType Yes Yes *45 No Yes
create Yes Yes45 * No Yes
get Yes * Yes45 No Yes *
getAll Yes * Yes *45 No Yes *
getCurrent Yes * Yes45 No Yes *
getLastFocused Yes * Yes45 No Yes *
onCreated Yes Yes45 No Yes
onFocusChanged Yes Yes45 No Yes
onRemoved Yes No45 No Yes
remove Yes No45 No Yes
update Yes * Yes *45 * 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: wbamberg, abbycar, chrisdavidmills, bsilverberg
 Last updated by: wbamberg,