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

title, comments

title	comments
as	false

Assign an alias for later use. Reference the alias later within a {% url cy.get() get %} or {% url cy.wait() wait %} command with a @ prefix.

{% note info %} Note: .as() assumes you are already familiar with core concepts such as {% url 'aliases' aliases-and-references %} {% endnote %}

Syntax

.as(aliasName)

Usage

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

cy.get('.main-nav').find('li').first().as('firstNav') // Alias first 'li' as @firstNav
cy.route('PUT', 'users', 'fx:user').as('putUser')     // Alias 'route' as @putUser   
cy.stub(api, 'onUnauth').as('unauth')                 // Alias 'stub' as @unauth   
cy.spy(win, 'fetch').as('winFetch')                   // Alias 'spy' as @winFetch  

{% fa fa-exclamation-triangle red %} Incorrect Usage

cy.as('foo')   // Errors, cannot be chained off 'cy'

Arguments

{% fa fa-angle-right %} aliasName (String)

The name of the alias to be referenced later within a {% url cy.get() get %} or {% url cy.wait() wait %} command using a @ prefix.

Yields {% helper_icon yields %}

{% yields same_subject .as %}

Examples

DOM Element

cy.route('PUT', /^\/users\/\d+/, 'fixture:user').as('userPut')
cy.get('form').submit()
cy.wait('@userPut')
  .its('url').should('contain', 'users')

Route

cy.route('PUT', 'users', 'fx:user').as('userPut')
cy.get('form').submit()
cy.wait('@userPut')
  .its('url').should('contain', 'users')

Notes

Reserved Words

Alias names cannot match some reserved words.

Some strings are not allowed as alias names since they are reserved words in Cypress. These words include: test, runnable, timeout, slow, skip, and inspect.

Rules

Requirements {% helper_icon requirements %}

{% requirements child .as %}

Assertions {% helper_icon assertions %}

{% assertions utility .as %}

Timeouts {% helper_icon timeout %}

{% timeouts none .as %}

Command Log

Alias several routes

cy.route(/company/, 'fixture:company').as('companyGet')
cy.route(/roles/, 'fixture:roles').as('rolesGet')
cy.route(/teams/, 'fixture:teams').as('teamsGet')
cy.route(/users\/\d+/, 'fixture:user').as('userGet')
cy.route('PUT', /^\/users\/\d+/, 'fixture:user').as('userPut')

Aliases of routes display in the routes instrument panel:

See also

• {% url cy.get() get %}
• {% url cy.wait() wait %}
• {% url 'Guides: Aliases' aliases-and-references %}