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

title, comments

title	comments
url	false

Get the current URL of the page that is currently active.

{% note info %} This is an alias of {% url "cy.location('href')" location %} {% endnote %}

Syntax

cy.url()
cy.url(options)

Usage

{% fa fa-check-circle green %} Correct Usage

cy.url()    // Yields the current url as a string

Arguments

{% fa fa-angle-right %} options (Object)

Pass in an options object to change the default behavior of cy.url().

cy.hash( options )

Option	Default	Description
log	true	{% usage_options log %}
timeout	{% url defaultCommandTimeout configuration#Timeouts %}	{% usage_options timeout cy.url %}

Yields {% helper_icon yields %}

{% yields sets_subject cy.url 'yields the current URL as a string' %}

Examples

No Args

Assert the URL is http://localhost:8000/users/1/edit

// clicking the anchor causes the browser to follow the link
cy.get('#user-edit a').click()
cy.url().should('eq', 'http://localhost:8000/users/1/edit') // => true

Notes

Href Shorthand

Url is an alias for cy.location('href')

cy.url() uses href under the hood.

cy.url()                  // these yield the same string
cy.location('href')       // these yield the same string

Differences

Url versus href

Given the remote URL, http://localhost:8000/index.html, all 3 of these assertions are the same.

cy.location('href').should('eq', 'http://localhost:8000/index.html')

cy.location().its('href').should('eq', 'http://localhost:8000/index.html')

cy.url().should('eq', 'http://localhost:8000/index.html')

href and toString come from the window.location spec.

But you may be wondering where the url property comes from. Per the window.location spec, there actually isn't a url property on the location object.

cy.url() exists because it's what most developers naturally assume would return them the full current URL. We almost never refer to the URL as an href.

Rules

Requirements {% helper_icon requirements %}

{% requirements parent cy.url %}

Assertions {% helper_icon assertions %}

{% assertions retry cy.url %}

Timeouts {% helper_icon timeout %}

{% timeouts assertions cy.url %}

Command Log

Assert that the url contains "#users/new"

cy.url().should('contain', '#users/new')

The commands above will display in the command log as:

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

See also

• {% url cy.hash() hash %}
• {% url cy.location() location %}