Information about a browser window.
On this page
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 thesessions
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 | 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