MDN self-hosted library · e01.org

New Window

The New Window command of the WebDriver API opens a new top-level browsing context of type window or tab, and returns with a dictionary containing the handle of the new WebWindow and its created type. If the requested type cannot be created by the browser, the alternative type will be tried to create.

no runnable cells webdriver-command upstream source

The New Window command of the WebDriver API opens a new top-level browsing context of type window or tab, and returns with a dictionary containing the handle of the new WebWindow and its created type. If the requested type cannot be created by the browser, the alternative type will be tried to create.

Syntax

Method URI template
POST /session/{session id}/window/new

URL parameters

  • session id
  • : Identifier of the session.

Payload

The input is an object:

  • type
  • : Requested type of top-level browsing context.

Response

The response payload is an object:

  • handle
  • : The handle of the new WebWindow.
  • type
  • : The created type of top-level browsing context.

Errors

Specifications

Browser compatibility

See also