Skip to main content
Cypress应用

siblings

获取兄弟DOM元素。

语法​

.siblings()
.siblings(selector)
.siblings(options)
.siblings(selector, options)

用法​

正确用法

cy.get('td').siblings() // 获取所有td元素的兄弟元素
cy.get('li').siblings('.active') // 获取所有li元素中带有'.active'类的兄弟元素

错误用法

cy.siblings('.error') // 错误，不能从'cy'链式调用
cy.clock().siblings() // 错误，'clock'不返回DOM元素

参数​

selector (字符串选择器)

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

options (对象)

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

选项默认值描述
logtrue在命令日志中显示该命令
timeoutdefaultCommandTimeout在超时前等待.siblings()解析的时间

生成结果 了解主题管理​

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

示例​

无参数​

获取每个li元素的兄弟元素​

<ul>
  <li>首页</li>
  <li>联系</li>
  <li class="active">服务</li>
  <li>价格</li>
</ul>
// 返回列表中所有其他li元素
cy.get('.active').siblings()

选择器​

获取带有active类的元素的兄弟元素​

// 返回<li class="active">服务</li>
cy.get('li').siblings('.active')

规则​

要求 了解命令链​

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

断言 了解断言​

超时设置 了解超时机制​

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

命令日志​

获取带有active类元素的兄弟元素

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

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

命令日志 siblings

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

控制台日志 siblings

历史​

版本变更
< 0.3.3添加了.siblings()命令

另请参阅​

目录