Skip to main content

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​