родители
Получите родительские DOM-элементы набора DOM-элементов.
Обратите внимание, что .parents() перемещается по DOM-дереву на несколько уровней вверх, в отличие от команды .parent (), которая перемещается только на один уровень вверх по DOM-дереву.
Поведение запроса этой команды точно соответствует работе
.parents()в jQuery.
Синтаксис
.parents()
.parents(selector)
.parents(options)
.parents(selector, options)
Использование
Правильное использование
cy.get('aside').parents() // Yield parents of aside
Неправильное использование
cy.parents() // Errors, cannot be chained off 'cy'
cy.go('back').parents() // Errors, 'go' does not yield DOM element
Аргументы
selector (Строковый селектор)
Селектор, используемый для фильтрации совпадающих DOM-элементов.
options (Объект)
Передайте объект options, чтобы изменить поведение по умолчанию .parents().
| Опция | Значение по умолчанию | Описание |
|---|---|---|
log |
true |
Отображает команду в журнале команд |
timeout |
defaultCommandTimeout |
Время ожидания, пока .parents() разрешится, прежде чем выйти за пределы времени ожидания
|
Возвращаемое значение
-
.parents()возвращает новые найденные DOM-элементы.
Примеры
Без аргументов
Получить родителей активного li
<ul class="main-nav">
<li>Overview</li>
<li>
Getting started
<ul class="sub-nav">
<li>Install</li>
<li class="active">Build</li>
<li>Test</li>
</ul>
</li>
</ul>
// yields [.sub-nav, li, .main-nav]
cy.get('li.active').parents()
Селектор
Получить родителей с классом main-nav активного li
// yields [.main-nav]
cy.get('li.active').parents('.main-nav')
Правила
Требования
-
.parents()требует цепочки с командой, возвращающей DOM-элементы.
Утверждения
-
.parents()автоматически повторит попытку, пока элемент(ы) не существуют в DOM -
.parents()автоматически повторит попытку, пока все связанные утверждения не пройдут
Таймауты
-
.parents()может выйти за пределы времени ожидания, ожидая, пока элемент(ы) не существуют в DOM . -
.parents()может выйти за пределы времени ожидания, ожидая, пока пройдут добавленные вами утверждения.
Журнал команд
Получить родителей активного li
cy.get('li.active').parents()
При нажатии на команду parents в журнале команд консоль выводит следующее:
См. также
© 2017 Cypress.io
Licensed under the MIT License.
https://docs.cypress.io/api/commands/parents