windows.Window
Information about a browser 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. -
heightOptional -
integer. The height of the window, including the frame, in pixels. -
idOptional -
integer. The ID of the window. Window IDs are unique within a browser session. incognito-
boolean. Whether the window is incognito (private). -
leftOptional -
integer. The offset of the window from the left edge of the screen in pixels. -
sessionIdOptional -
string. The session ID used to uniquely identify a Window obtained from thesessionsAPI. -
stateOptional -
A
windows.WindowStatevalue representing the state of this browser window — maximized, minimized, etc. -
tabsOptional -
Array of
tabs.Tabobjects representing the current tabs in the window. -
titleOptional -
The title of the browser window. Requires "tabs" permission or host permissions for the active tab's URL. Read only.
-
topOptional -
integer. The offset of the window from the top edge of the screen in pixels. -
typeOptional -
A
windows.WindowTypevalue representing the type of browser window this is — normal browser window, popup, etc. -
widthOptional -
integer. The width of the window, including the frame, in pixels.
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
Window |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
alwaysOnTop |
19 | 79 | 45 | ? | 15 | 14Always returnsfalse. |
? | ? | No | ? | 15Always returnsfalse. |
? |
focused |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
height |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
id |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
incognito |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
left |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
sessionId |
31 | 79 | No | ? | 18 | No | ? | ? | No | ? | No | ? |
state |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
tabs |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
title |
No | No | 56 | ? | No | No | ? | ? | No | ? | No | ? |
top |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
type |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
width |
Yes | 14 | 45 | ? | Yes | 14 | ? | ? | No | ? | 15 | ? |
Note: This API is based on Chromium's chrome.windows API. This documentation is derived from windows.json in the Chromium code.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/windows/Window