windows.Window

Type

Values of this type are objects. They contain the following properties:

alwaysOnTop: boolean. Whether the window is set to be always on top.
focused: boolean. Whether the window is currently the focused window.
height Optional: integer. The height of the window, including the frame, in pixels.
id Optional: integer. The ID of the window. Window IDs are unique within a browser session.
incognito: boolean. Whether the window is incognito (private).
left Optional: integer. The offset of the window from the left edge of the screen in pixels.
sessionId Optional: string. The session ID used to uniquely identify a Window obtained from the sessions API.
state Optional: A windows.WindowState value representing the state of this browser window — maximized, minimized, etc.
tabs Optional: Array of tabs.Tab objects representing the current tabs in the window.
title Optional: The title of the browser window. Requires "tabs" permission or host permissions for the active tab's URL. Read only.
top Optional: integer. The offset of the window from the top edge of the screen in pixels.
type Optional: A windows.WindowType value representing the type of browser window this is — normal browser window, popup, etc.
width Optional: integer. The width of the window, including the frame, in pixels.

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Firefox for Android	Safari on iOS
`Window`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`alwaysOnTop`	Chrome – Full support Chrome 19 (Release date: 2012-05-15) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote footnote Always returns `false`.	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote footnote Always returns `false`.
`focused`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`height`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`id`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`incognito`	Chrome – Full support Chrome 5 (Release date: 2010-05-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) altname altname Alternate name: inPrivate	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`left`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`sessionId`	Chrome – Full support Chrome 31 (Release date: 2013-11-12) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 18 (Release date: 2013-11-19) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`state`	Chrome – Full support Chrome 17 (Release date: 2012-02-08) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`tabs`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`title`	Chrome – No support Chrome footnote No support	Edge – No support Edge footnote No support	Firefox – Full support Firefox 56 (Release date: 2017-09-28) footnote Full support	Opera – No support Opera footnote No support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`top`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`type`	Chrome – Full support Chrome 5 (Release date: 2010-05-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support
`width`	Chrome – Full support Chrome 4 (Release date: 2010-01-25) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) footnote Full support	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.
: Uses a non-standard name

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

This page was last modified on Jul 17, 2025 by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.

Type

Example extensions

Browser compatibility

Legend