如何在Selenium JavaScript测试脚本中等待HTML元素加载并避免异常

我找到的最接近的方法是until.elementLocated，但它似乎会立即抛出异常。请问是否有办法在JavaScript版Selenium测试脚本中等待元素加载完成？或者有没有办法避免以下异常在超时前抛出：

"NoSuchElementError: no such element: Unable to locate element: {"method":"xpath","selector":"//button[text()='NEXT']"}"

我当前使用的代码如下：

await driver.wait(function () {
    let text = "//button[text()='" + "NEXT" + "']";
    let button = By.xpath(text);
    return until.elementLocated(button);
}, 40000).then(() => {console.log("element is located")})

问题原因及解决方法 #

你的代码问题在于driver.wait的回调函数用法错误：until.elementLocated本身是Selenium提供的等待条件对象，不需要放在自定义回调里返回，直接传给driver.wait即可。错误的包裹方式导致它没有按预期进入等待逻辑，反而触发了立即查找元素的行为。

正确写法1：直接使用until.elementLocated条件 #

这是最简洁的标准用法，until.elementLocated会在超时时间内持续尝试查找元素，不会提前抛出异常：

const buttonLocator = By.xpath("//button[text()='NEXT']");
try {
    await driver.wait(until.elementLocated(buttonLocator), 40000);
    console.log("element is located");
} catch (error) {
    console.error("超时未找到元素:", error);
}

正确写法2：自定义回调（需返回布尔值/Promise） #

如果需要在等待过程中加入自定义逻辑，回调函数要返回布尔值或Promise，通过捕获查找异常来控制等待逻辑：

await driver.wait(async () => {
    try {
        const button = await driver.findElement(By.xpath("//button[text()='NEXT']"));
        return button !== null;
    } catch (err) {
        return false; // 未找到元素时返回false，让wait继续等待
    }
}, 40000).then(() => {console.log("element is located")});

额外优化提示 #

• 若需要确保元素不仅存在还可见，可结合until.elementIsVisible：

const button = await driver.wait(until.elementLocated(buttonLocator), 40000);
await driver.wait(until.elementIsVisible(button), 40000);

• 用try/catch包裹等待逻辑，能更优雅地处理超时场景。

内容的提问来源于stack exchange，提问作者Duncan Groenewald