W3cubDocs

/Cypress

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

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