Spec-Zone.ru › Cypress

родители

Получите родительские 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()
Command Log parents

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

Console Log parents

См. также

  • .children()
  • .parent()
  • .parentsUntil()

© 2017 Cypress.io
Licensed under the MIT License.
https://docs.cypress.io/api/commands/parents

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API