clear

Очистить значение input или textarea.

Псевдоним для .type('{selectall}{backspace}')

Синтаксис

.clear()
.clear(options)

Использование

Правильное использование

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

Неправильное использование

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

Аргументы

options (Объект)

Передайте объект options, чтобы изменить поведение по умолчанию .clear().

Параметр	Значение по умолчанию	Описание
`animationDistanceThreshold`	`animationDistanceThreshold`	Расстояние в пикселях, на которое элемент должен отклониться со временем, чтобы считаться анимируемым.
`force`	`false`	Принудительно выполняет действие, отключает ожидание возможности действия ожидания возможности действия
`log`	`true`	Отображает команду в журнале команд
`scrollBehavior`	`scrollBehavior`	Положение области просмотра, куда должен быть прокручен элемент перед выполнением команды
`timeout`	`defaultCommandTimeout`	Время ожидания, которое `.clear()` должен разрешить перед выходом за пределы таймаута
`waitForAnimations`	`waitForAnimations`	Нужно ли ждать, пока элементы закончат анимацию перед выполнением команды.

Возвращаемое значение

.clear() возвращает тот же объект, который был передан предыдущей командой.

Примеры

Без аргументов

Очистить поле ввода и ввести новое значение

cy.get('textarea').clear().type('Hello, World')

Примечания

Доступность

Элемент должен сначала достичь доступности

.clear() — это "команда действия", которая следует всем правилам доступности.

Документация

.clear() является псевдонимом для .type({selectall}{backspace}).

Для получения более подробной информации, пожалуйста, ознакомьтесь с документацией .type().

Правила

Требования

.clear() требует привязки к команде, которая возвращает DOM-элемент(ы).
.clear() требует, чтобы элемент был input или textarea .

Утверждения

.clear() автоматически ожидает, пока элемент достигнет состояния готовности к действию
.clear() автоматически повторяет попытки, пока все привязанные утверждения не пройдут

Таймауты

.clear() может выйти за пределы таймаута, ожидая, пока элемент достигнет состояния готовности к действию .
.clear() может выйти за пределы таймаута, ожидая выполнения добавленных утверждений.

Журнал команд

Очистить поле ввода и ввести новое значение

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

Вышеперечисленные команды будут отображаться в журнале команд как:

При нажатии на clear в журнале команд консоль выведет следующее: