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

  • : integer. The height of the window, including the frame, in pixels.

  id

  • : integer. The ID of the window. Window IDs are unique within a browser session.

  incognito

  • : boolean. Whether the window is incognito (private).

  left

  • : integer. The offset of the window from the left edge of the screen in pixels.

  sessionId

  • : string. The session ID used to uniquely identify a Window obtained from the API.

  state

  • : A value representing the state of this browser window — maximized, minimized, etc.

  tabs

  • : Array of objects representing the current tabs in the window.

  title

  • : The title of the browser window. Requires “tabs” permission or host permissions for the active tab’s URL. Read only.

  top

  • : integer. The offset of the window from the top edge of the screen in pixels.

  type

  • : A value representing the type of browser window this is — normal browser window, popup, etc.

  width

  • : integer. The width of the window, including the frame, in pixels.

Browser compatibility

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