cypress/docs/source/api/commands/end.md

title, comments, description

title	comments	description
end	true

End a chain of commands.

Syntax

.end()

Usage

.end() should be chained off another cy command.

{% fa fa-check-circle green %} Valid Usage

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

{% fa fa-exclamation-triangle red %} Invalid Usage

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

Yields

.end() yields null.

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

Command Log

end does not log in the command log

cy
  .contains('.modal-title', 'Select Folder Type').end()
  .contains('li', 'Maintenance').should('have.class', 'active')

The commands above will display in the command log as:

See also

• root
• within