跳到主要内容

查询 DOM 方法

getBy

立即同步执行查找元素,如果没有元素匹配或找到多个匹配项则抛出错误(如果预期有多个元素,请使用 getAllBy

一般用于检查元素是否已经存在

queryBy

返回匹配的节点,如果没有元素匹配则返回 null 。这对于断言不存在的元素很有用。如果找到多个匹配项,则抛出错误(如果可以,请使用 queryAllBy )。

一般用于检查元素是否不存在

findBy

返回一个 Promise,当找到匹配给定查询的元素时该 Promise 会解决。如果没有找到元素,或者默认超时 1000 毫秒后找到超过一个元素,该 Promise 会被拒绝。(如果你需要找到多个元素,请使用 findAllBy

用于异步查找元素,即元素可能目前不存在,但是后续会存在

方法是否等待结果使用场景
getBy直接返回元素或抛出错误元素必须存在
queryBy返回元素或 null验证元素不存在
findBy返回 Promise,解析为元素或被拒绝异步查找元素