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