Skip to main content

Reload the page.

Syntax​

cy.reload()
cy.reload(forceReload)
cy.reload(options)
cy.reload(forceReload, options)

Usage​

Correct Usage

cy.reload()

Arguments​

forceReload (Boolean)

Whether to reload the current page without using the cache. true forces the reload without cache.

options (Object)

OptionDefaultDescription
logtrueDisplays the command in the Command log
timeoutpageLoadTimeoutTime to wait for cy.reload() to resolve before timing out Note: Network requests are limited by the underlying operating system, and may still time out if this value is increased.

Yields ​

  • cy.reload() yields the window object after the page finishes loading.
  • It is unsafe to chain further commands that rely on the yielded window after cy.reload().

Examples​

No Args​

Reload the page as if the user clicked 'Refresh'​

cy.visit('http://localhost:3000/admin')
cy.get('#undo-btn').click().should('not.be.visible')
cy.reload()
cy.get('#undo-btn').click().should('not.be.visible')

Force Reload​

Reload the page without using the cache​

cy.visit('http://localhost:3000/admin')
cy.reload(true)

Rules​

Requirements ​

  • cy.reload() requires being chained off of cy.
  • cy.reload() requires the response to be content-type: text/html.
  • cy.reload() requires the response code to be 2xx after following redirects.
  • cy.reload() requires the load load event to eventually fire.

Assertions ​

  • cy.reload() will automatically wait for assertions you have chained to pass.

Timeouts ​

  • cy.reload() can time out waiting for the page to fire its load event.
  • cy.reload() can time out waiting for assertions you've added to pass.

Command Log​

Reload the page

cy.reload()

The commands above will display in the Command Log as:

Command Log reload

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

Console Log reload

See also​