Cypress应用

nextAll

获取一组匹配的DOM元素中每个DOM元素的所有后续兄弟元素。

info

该命令的查询行为与jQuery中的 .nextAll()完全一致。

语法

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

用法

正确用法

cy.get('.active').nextAll() // 获取`.active`之后的所有链接

错误用法

cy.nextAll() // 错误，不能直接链式调用'cy'
cy.getCookies().nextAll() // 错误，'getCookies'不返回DOM元素

参数

selector (字符串选择器)

用于过滤匹配DOM元素的选择器。

options (对象)

传入一个选项对象以改变.nextAll()的默认行为。

选项	默认值	描述
log	true	在命令日志中显示该命令
timeout	defaultCommandTimeout	等待.nextAll()解析的时长，超过则超时

生成结果

• .nextAll()返回找到的新DOM元素。
• .nextAll()是一个查询命令，可以安全地链式调用其他命令。

示例

无参数

查找.second之后的所有兄弟元素

<ul>
  <li>苹果</li>
  <li class="second">橙子</li>
  <li>香蕉</li>
  <li>菠萝</li>
  <li>葡萄</li>
</ul>

// 返回 [<li>香蕉</li>, <li>菠萝</li>, <li>葡萄</li>]
cy.get('.second').nextAll()

选择器

查找每个li之后的所有兄弟元素，仅保留带有selected类的元素

<ul>
  <li>苹果</li>
  <li>橙子</li>
  <li>香蕉</li>
  <li class="selected">菠萝</li>
  <li>葡萄</li>
</ul>

// 返回 <li>菠萝</li>
cy.get('li').nextAll('.selected')

规则

要求

• .nextAll()必须链式调用在返回DOM元素的命令之后。

断言

• .nextAll()会自动重试 直到元素 存在于DOM中。
• .nextAll()会自动重试 直到所有链式断言通过。

超时设置

• .nextAll()可能因等待元素 存在于DOM中而超时。
• .nextAll()可能因等待添加的断言通过而超时。

命令日志

查找.active li之后的所有元素

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

以上命令将在命令日志中显示为：

当点击命令日志中的nextAll时，控制台会输出以下内容：

另请参阅

• .next()
• .nextUntil()
• .prevAll()