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()yieldsnull..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