MDN self-hosted library · e01.org

windows.Window

Information about a browser window.

no runnable cells webextension-api-type upstream source

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 sessions API.
  • state
  • : A windows.WindowState value representing the state of this browser window — maximized, minimized, etc.
  • tabs
  • : Array of tabs.Tab 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 windows.WindowType 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

[!NOTE] This API is based on Chromium's chrome.windows API. This documentation is derived from windows.json in the Chromium code.