end

End a chain of commands.

Syntax

.end()

Usage

Correct Usage

cy.contains('ul').end() // Yield 'null' instead of 'ul' element

Incorrect Usage

cy.end() // Does not make sense to chain off 'cy'

Yields

  • .end() yields null .
  • .end() cannot be chained further.

Examples

.end() is useful when you want to end a chain of commands and force the next command to not receive what was yielded in the previous command.

cy.contains('User: Cheryl')
  .click()
  .end() // yield null
  .contains('User: Charles')
  .click() // contains looks for content in document now

Alternatively, you can always start a new chain of commands off of cy.

cy.contains('User: Cheryl').click()
cy.contains('User: Charles').click() // contains looks for content in document now

Rules

Requirements

  • .end() requires being chained off a previous command.

Assertions

  • .end() cannot have any assertions chained.

Timeouts

  • .end() cannot time out.

Command Log

  • .end() does not log in the Command Log

See also

© 2017 Cypress.io
Licensed under the MIT License.
https://docs.cypress.io/api/commands/end