братья-сестры
Получить дочерние DOM-элементы.
Синтаксис
.siblings()
.siblings(selector)
.siblings(options)
.siblings(selector, options)
Использование
Правильное использование
cy.get('td').siblings() // Yield all td's siblings
cy.get('li').siblings('.active') // Yield all li's siblings with class '.active'
Неправильное использование
cy.siblings('.error') // Errors, cannot be chained off 'cy'
cy.location().siblings() // Errors, 'location' does not yield DOM element
Аргументы
selector (строковый селектор)
Селектор для фильтрации соответствующих DOM-элементов.
options (объект)
Передайте объект options, чтобы изменить поведение по умолчанию .siblings().
| Опция | Значение по умолчанию | Описание |
|---|---|---|
log |
true |
Отображает команду в журнале команд |
timeout |
defaultCommandTimeout |
Время ожидания, пока .siblings() разрешится перед выходом за пределы времени ожидания
|
Возвращаемые значения
-
.siblings()возвращает новые найденные DOM-элементы.
Примеры
Без аргументов
Получить братьев и сестер каждого li
<ul>
<li>Home</li>
<li>Contact</li>
<li class="active">Services</li>
<li>Price</li>
</ul>
// yields all other li's in list
cy.get('.active').siblings()
Селектор
Получить братьев и сестер элемента с классом active
// yields <li class="active">Services</li>
cy.get('li').siblings('.active')
Правила
Требования
-
.siblings()требует привязки к команде, которая возвращает DOM-элемент(ы).
Утверждения
-
.siblings()автоматически повторно выполнится, пока элемент(ы) не появятся в DOM -
.siblings()автоматически повторно выполнится, пока все связанные утверждения не пройдут
Таймауты
-
.siblings()может выйти за пределы времени ожидания, ожидая появления элемента(ов) в DOM . -
.siblings()может выйти за пределы времени ожидания, ожидая выполнения утверждений.
Журнал команд
Получить братьев и сестер элемента с классом active
cy.get('.left-nav').find('li.active').siblings()
Вышеуказанные команды будут отображены в журнале команд как:
При нажатии на siblings в журнале команд, консоль выведет следующее:
История
| Версия | Изменения |
|---|---|
| < 0.3.3 |
.siblings() команда добавлена |
См. также
© 2017 Cypress.io
Licensed under the MIT License.
https://docs.cypress.io/api/commands/siblings