nextUntil

Получить все следующие родственные элементы каждого DOM-элемента в наборе сопоставленных DOM-элементов до, но не включая, указанный элемент.

Поведение запроса этой команды точно соответствует тому, как работает .nextUntil() в jQuery.

Синтаксис

.nextUntil(selector)
.nextUntil(selector, filter)
.nextUntil(selector, filter, options)
.nextUntil(element)
.nextUntil(element, filter)
.nextUntil(element, filter, options)

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

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

cy.get('div').nextUntil('.warning') // Yield siblings after 'div' until '.warning'

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

cy.nextUntil() // Errors, cannot be chained off 'cy'
cy.location().nextUntil('path') // Errors, 'location' does not yield DOM element

Аргументы

selector (Строковый селектор)

Селектор, где следует остановить поиск следующих родственных элементов.

element (DOM-узел, объект jQuery)

Элемент, где следует остановить поиск следующих родственных элементов.

filter (Строковый селектор)

Селектор, используемый для фильтрации сопоставленных DOM-элементов.

options (Объект)

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

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

• .nextUntil() возвращает новые найденные DOM-элементы.

Примеры

Селектор

Найти все родственные элементы, следующие за #veggies до #nuts

<ul>
  <li id="fruits" class="header">Fruits</li>
  <li>apples</li>
  <li>oranges</li>
  <li>bananas</li>
  <li id="veggies" class="header">Vegetables</li>
  <li>cucumbers</li>
  <li>carrots</li>
  <li>corn</li>
  <li id="nuts" class="header">Nuts</li>
  <li>walnuts</li>
  <li>cashews</li>
  <li>almonds</li>
</ul>

//returns [<li>cucumbers</li>, <li>carrots</li>, <li>corn</li>]
cy.get('#veggies').nextUntil('#nuts')

Правила

Требования

• .nextUntil() требует цепочки команд, возвращающих DOM-элементы.

Утверждения

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

Таймауты

• .nextUntil() может прекратить ожидание, пока элемент(ы) не появятся в DOM .
• .nextUntil() может прекратить ожидание, пока утверждения не пройдут.

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

Найти все родственные элементы, следующие за #veggies до #nuts

cy.get('#veggies').nextUntil('#nuts')

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

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

См. также

• .next()
• .nextAll()
• .parentsUntil()
• .prevUntil()