2.5 KiB
title, comments
| title | comments |
|---|---|
| blur | false |
Blur a focused element.
Syntax
.blur()
.blur(options)
Usage
.blur() requires being chained off another cy command that yields a DOM element.
This element must currently be in focus. If you want to ensure an element is focused before blurring, try using {% url .focus() focus %} before .blur().
{% fa fa-check-circle green %} Valid Usage
cy.get('[type="email"]').type('me@email.com').blur() // Blur email input
cy.get('[tabindex="1"]').focus().blur() // Blur el with tabindex
{% fa fa-exclamation-triangle red %} Invalid Usage
cy.blur('input') // Errors, cannot be chained off 'cy'
cy.window().blur() // Errors, 'window' does not yield DOM element
Arguments
{% fa fa-angle-right %} options (Object)
Pass in an options object to change the default behavior of .blur.
| Option | Default | Notes |
|---|---|---|
force |
false |
Forces blur, disables checking if el is focusable or focused |
log |
true |
Whether to display command in Command Log |
Yields {% helper_icon yields %}
.blur() yields the DOM element that was blurred.
Timeout {% helper_icon timeout %}
.blur() will continue to look for the focusable element to blur for the duration of the {% url defaultCommandTimeout configuration#Timeouts %}.
Examples
Blur
Blur the comment input.
cy.get('[name="comment"]').type('Nice Product!').blur()
Options
Blur the first input
Setting force to true in the options disables checking whether the input is focusable or currently has focus.
cy.get('input:first').blur({ force: true })
Notes
.blur() can time out because your browser did not receive any blur events.
If you see this error, you may want to ensure that the main browser window is currently focused. This means not being focused in debugger or any other window when the command is run.
Command Log
Blur a textarea after typing.
cy.get('[name="comment"]').focus().type('Nice Product!').blur()
The commands above will display in the command log as:
When clicking on the blur command within the command log, the console outputs the following:
See also
- {% url
.focus()focus %} - {% url
cy.focused()focused %}