cypress/docs/source/api/commands/window.md

title, comments, description

title	comments	description
window	true

Get the global window object of the remote application visited.

Returns	the window object
Timeout	cy.window will retry for the duration of the defaultCommandTimeout

cy.window()

Get the global window object of the remote application you've visited.

Options

Pass in an options object to change the default behavior of cy.window.

cy.window( options )

Option	Default	Notes
log	true	whether to display command in command log

Usage

Returns the remote window object

cy
  .visit("http://localhost:8080/app")
  .window().then(function(win){
    // win is the remote window
    // of the page at: http://localhost:8080/app
  })

Options Usage

Passes timeout through to cy.should assertion

cy.window({timeout: 10000}).should("have.property", "foo")

Command Log

Get the window

cy.window()

The commands above will display in the command log as:

When clicking on window within the command log, the console outputs the following:

Related

• visit
• document