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

title, comments, description

title	comments	description
clear	true

Clears the value of an input or textarea. An alias for cy.type('{selectall}{backspace}')

Syntax

.clear()
.clear(options)

Usage

.clear() requires being chained off another cy command that yields an input or textarea.

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

cy.get('[type="text"]').clear()        // Clear text input
cy.get('textarea').type('Hi!').clear() // Clear textarea
cy.focused().clear()                   // Clear focused input/textarea

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

cy.clear()                // Errors, cannot be chained off 'cy'
cy.get('nav').clear()     // Errors, 'get' doesn't yield input or textarea
cy.url().clear()          // Errors, 'url' doesn't yield DOM element

Arguments

{% fa fa-angle-right %} options (Object)

Pass in an options object to change the default behavior of .clear.

Option	Default	Notes
force	false	Forces clear, disables error checking prior to clear
interval	16	Interval which to retry clear
timeout	defaultCommandTimeout	Total time to retry the clear
log	true	whether to display command in command log

Yields

.clear() yields the input or textarea that was cleared.

Timeout

.clear() will continue to look for the input or textarea for the duration of the defaultCommandTimeout

Examples

Clear

Clear the input and type a new value.

Prior to clearing, if the element isn't currently focused, Cypress issues a .click() on the element, which causes the element to receive focus.

<input name="name" value="John Doe" />

cy.get('input[name="name"]').clear().type('Jane Lane')

Command Log

Clear the input and type a new value

cy.get('input[name="name"]').clear().type('Jane Lane')

The commands above will display in the command log as:

When clicking on clear within the command log, the console outputs the following:

See also

• blur
• focus
• type