closest
获取与选择器匹配的第一个DOM元素(可以是元素本身或其祖先元素之一)。
info
该命令的查询行为与jQuery中的
.closest()
完全一致。
语法
.closest(selector)
.closest(selector, options)
用法
正确用法
cy.get('td').closest('.filled') // 获取带有类'.filled'的最近元素
错误用法
cy.closest('.active') // 错误,不能直接在'cy'上链式调用
cy.clock().closest() // 错误,'clock'不返回DOM元素
参数
selector (字符串选择器)
用于过滤匹配DOM元素的选择器。
options (对象)
传入选项对象以改变.closest()
的默认行为。
选项 | 默认值 | 描述 |
---|---|---|
log | true | 在命令日志中显示该命令 |
timeout | defaultCommandTimeout | 等待.closest() 解析的时长,超 过则超时 |
生成结果
.closest()
返回找到的新DOM元素。.closest()
是一个查询命令,可以安全地链式调用其他命令。