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. 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
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
Window | |||||||
alwaysOnTop | |||||||
focused | |||||||
height | |||||||
id | |||||||
incognito | |||||||
left | |||||||
sessionId | |||||||
state | |||||||
tabs | |||||||
title | |||||||
top | |||||||
type | |||||||
width |
Legend
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.
Example extensions
Note:
This API is based on Chromium's chrome.windows
API. This documentation is derived from windows.json
in the Chromium code.