查询 DOM 方法
getBy
立即同步执行查找元素,如果没有元素匹配或找到多个匹配项则抛出错误(如果预期有多个元素,请使用 getAllBy)
一般用于检查元素是否已经存在
queryBy
返回匹配的节点,如果没有元素匹配则返回 null 。这对于断言不存在的元素很有用。如果找到多个匹配项,则抛出错误(如果可以,请使用 queryAllBy )。
一般用于检查元素是否不存在
findBy
返回一个 Promise,当找到匹配给定查询的元素时该 Promise 会解决。如果没有找到元素,或者默认超时 1000 毫秒后找到超过一个元素,该 Promise 会被拒绝。(如果你需要找到多个元素,请使用 findAllBy)
用于异步查找元素,即元素可能目前不存在,但是后续会存在
| 方法 | 是否等待 | 结果 | 使用场景 |
|---|---|---|---|
getBy | 否 | 直接返回元素或抛出错误 | 元素必须存在 |
queryBy | 否 | 返回元素或 null | 验证元素不存在 |
findBy | 是 | 返回 Promise,解析为元素或被拒绝 | 异步查找元素 |