JavaScript版Selenium WebDriver如何正确断言元素不存在？

问题根因 #

• 异步流程处理错误：driver.findElements() 是异步接口，返回值为Promise对象，而非直接的元素数组。之前的代码将Promise对象本身赋值给noofElements后立刻执行断言，此时Promise尚未完成执行，拿到的不是元素数量，自然无法得到正确校验结果。能打印出元素长度，是因为打印逻辑写在了Promise的.then()回调中，拿到了异步返回的真实值，但外层断言完全脱离了异步执行流程。
• .size属性无效是API版本差异：JS版Selenium在Promise resolve后返回原生JS数组，仅支持原生数组的.length属性，.size是Java版Selenium为列表对象定义的自定义属性，JS版未做兼容，读取该属性只会得到undefined。

正确实现方式 #

1. async/await 写法（推荐） #

将测试逻辑承载在async函数中，通过await等待异步接口返回真实元素数组后再执行断言：

const assert = require('node:assert');
const { By } = require('selenium-webdriver');

async function verifyElementNotExist() {
  const matchedElements = await driver.findElements(By.css('#foo'));
  // 数组长度为0即代表目标元素不存在
  assert.strictEqual(matchedElements.length, 0);
}

2. 链式Promise回调写法 #

如果不使用async/await语法，需要将断言逻辑放到findElements()返回Promise的.then()回调内部，保证断言在拿到真实元素列表后执行，禁止将Promise对象本身传到回调外做校验：

const assert = require('node:assert');
const { By } = require('selenium-webdriver');

driver.findElements(By.css('#foo'))
  .then(matchedElements => {
    assert.strictEqual(matchedElements.length, 0);
  })
  .catch(error => {
    throw new Error(`元素不存在校验失败: ${error.message}`);
  });

稳定性优化 #

直接调用findElements做长度校验存在偶发误判的问题：动态渲染页面中，校验瞬间可能元素还未完成移除操作，导致校验失败。可以搭配显式等待机制，持续检测直到元素从DOM中完全消失后再做最终判断，提升用例稳定性：

async function stableVerifyElementNotExist() {
  // 最多等待5秒，持续检测直到元素列表为空
  await driver.wait(async () => {
    const matchedElements = await driver.findElements(By.css('#foo'));
    return matchedElements.length === 0;
  }, 5000, '等待5秒后目标元素仍然存在于页面中');
}

内容的提问来源于stack exchange，提问作者Michael Glennon