Selenium Node.js返回空Promise而非元素问题求助

问题重现 #

你使用的DOM查询语句：
document.getElementsByClassName('calendar')[0].childNodes[0].childNodes[1].childNodes

尝试的Selenium代码：

let driver = await new Builder()
        .forBrowser("chrome")
        .build();

driver.executeAsyncScript(
        "document.getElementsByClassName('calendar')[0].childNodes[0].childNodes[1].childNodes",
        it => console.log("result --> " + it)
    );

执行后返回空Promise，XPath方式driver.findElement(By.xpath(" //*[@class=\"calendar\"]"))同样返回空Promise。

解决方案 #

1. 补全页面加载步骤并等待元素渲染

你的代码缺少页面加载逻辑，且未等待元素完成渲染，这是导致空Promise的核心原因。添加显式等待确保元素存在后再操作：

const { Builder, By, until } = require('selenium-webdriver');

// 初始化驱动并打开目标页面
let driver = await new Builder().forBrowser("chrome").build();
await driver.get('https://你的目标页面地址.com'); // 替换为实际页面URL

// 等待calendar元素加载完成，超时时间10秒
const calendarElement = await driver.wait(until.elementLocated(By.className('calendar')), 10000);

2. 修正executeAsyncScript的调用方式

executeAsyncScript要求在脚本内部调用回调函数返回结果，且原生NodeList无法直接序列化，需要转为数组：

const childNodes = await driver.executeAsyncScript(function() {
  // 获取Selenium传入的回调函数
  const callback = arguments[arguments.length - 1];
  // 执行DOM查询并转成可序列化的数组
  const nodes = Array.from(document.getElementsByClassName('calendar')[0].childNodes[0].childNodes[1].childNodes);
  // 传递结果给回调
  callback(nodes);
});
console.log("result --> ", childNodes);

3. 替换childNodes为更稳定的选择器

childNodes会包含空白文本节点，页面结构稍有变动就会导致索引失效。改用CSS选择器或XPath直接定位目标层级：

// 用CSS选择器直接定位到目标父节点
const targetParent = await driver.findElement(By.css('.calendar > * > :nth-child(2)'));
// 获取子节点
const childNodes = await driver.executeScript(el => Array.from(el.childNodes), targetParent);

// 或者用XPath定位
const targetParentXPath = await driver.findElement(By.xpath('//*[@class="calendar"]/*/*[2]'));
const childNodesXPath = await driver.executeScript(el => Array.from(el.childNodes), targetParentXPath);

4. 检查目标元素是否在iframe内

如果元素嵌套在iframe中，必须先切换到iframe上下文才能查询：

// 定位iframe（根据实际情况调整选择器）
const iframe = await driver.findElement(By.id('target-iframe'));
// 切换到iframe
await driver.switchTo().frame(iframe);

// 之后再执行元素查询
const calendarElement = await driver.wait(until.elementLocated(By.className('calendar')), 10000);

内容的提问来源于stack exchange，提问作者Aleksandr T