cypress/docs/source/api/commands/nextall.md

title, comments

title	comments
nextAll	false

Get all following siblings of each DOM element in a set of matched DOM elements.

Syntax

.nextAll()
.nextAll(selector)
.nextAll(options)
.nextAll(selector, options)

Usage

.nextAll() requires being chained off another cy command that yields a DOM element or set of DOM elements.

{% fa fa-check-circle green %} Valid Usage

cy.get('.active').nextAll() // Yield all links next to `.active`

{% fa fa-exclamation-triangle red %} Invalid Usage

cy.nextAll()                // Errors, cannot be chained off 'cy'
cy.getCookies().nextAll()   // Errors, 'getCookies' does not yield DOM element

Arguments

{% fa fa-angle-right %} selector (String selector)

A selector used to filter matching DOM elements.

{% fa fa-angle-right %} options (Object)

Pass in an options object to change the default behavior of .nextAll().

Option	Default	Description
log	true	{% usage_options log %}
timeout	{% url defaultCommandTimeout configuration#Timeouts %}	{% usage_options timeout .nextAll %}

Yields {% helper_icon yields %}

{% yields changes_dom_subject .nextAll %}

Timeouts {% helper_icon timeout %}

.nextAll() will continue to look for all next element(s) for the duration of the {% url defaultCommandTimeout configuration#Timeouts %}.

Examples

All Next

Find all of the element's siblings following .second

<ul>
  <li>apples</li>
  <li class="second">oranges</li>
  <li>bananas</li>
  <li>pineapples</li>
  <li>grapes</li>
</ul>

// yields [<li>bananas</li>, <li>pineapples</li>, <li>grapes</li>]
cy.get('.second').nextAll()

Selector

Find all of the following siblings of each li. Keep only the ones with a class selected.

<ul>
  <li>apples</li>
  <li>oranges</li>
  <li>bananas</li>
  <li class="selected">pineapples</li>
  <li>grapes</li>
</ul>

// yields <li>pineapples</li>
cy.get('li').nextAll('.selected')

Command Log

Find all elements following the .active li

cy.get('.left-nav').find('li.active').nextAll()

The commands above will display in the command log as:

When clicking on nextAll within the command log, the console outputs the following:

See also

• {% url .next() next %}
• {% url .nextUntil() nextuntil %}
• {% url .prevAll() prevall %}