Снять галочку

Снять галочку(и) с чекбокса(ов).

Синтаксис

.uncheck()
.uncheck(value)
.uncheck(values)
.uncheck(options)
.uncheck(value, options)
.uncheck(values, options)

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

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

cy.get('[type="checkbox"]').uncheck() // Unchecks checkbox element

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

cy.uncheck('[type="checkbox"]') // Errors, cannot be chained off 'cy'
cy.get('p:first').uncheck() // Errors, '.get()' does not yield checkbox

Аргументы

value (Строка)

Значение чекбокса, с которого нужно снять галочку.

values (Массив)

Значения чекбоксов, с которых нужно снять галочку.

options (Объект)

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

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

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

.uncheck() возвращает тот же объект, что и предыдущая команда.

Примеры

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

Снять галочки со всех чекбоксов

cy.get(':checkbox').uncheck()

Снять галочку с элемента с id 'saveUserName'

cy.get('#saveUserName').uncheck()

Значение

Снять галочку с чекбокса со значением 'ga'

cy.get('input[type="checkbox"]').uncheck(['ga'])

Значения

Снять галочки с чекбоксов со значениями 'ga' и 'ca'

cy.get('[type="checkbox"]').uncheck(['ga', 'ca'])

Примечания

Возможность действия

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

.uncheck() - это "команда действия", которая следует всем правилам возможности действия.

Правила

Требования

.uncheck() требует цепочки команд, которая возвращает DOM элемент(ы).
.uncheck() требует, чтобы у элемента был тип checkbox .

Ассершены

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

Таймауты

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

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

Снять галочку с первого чекбокса

cy.get('[data-js="choose-all"]')
  .click()
  .find('input[type="checkbox"]')
  .first()
  .uncheck()

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

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

История

Версия	Изменения
6.1.0	Добавлена опция `scrollBehavior`
0.6.12	Добавлена опция `force`
0.3.3	Добавлена команда `.uncheck()`