Puppeteer 22中无需等待的XPath查询的合适替代方案是什么？

在Puppeteer v22.10里，你可以用以下两种方式实现和旧版page.$x()完全一致的行为——即时查询所有匹配的XPath元素数组，无需等待：

方法1：使用Locator API（官方推荐） #

通过page.locator()结合all()方法，用xpath=前缀指定查询语法，直接获取所有匹配元素的数组，行为和旧版$x()完全对齐：

const xpath = `//TD[contains(text(),"sometext")]/following-sibling::td`;
const elements = await page.locator(`xpath=${xpath}`).all();

这个方法是Puppeteer官方主推的现代写法，Locator API还支持后续的链式操作（如过滤、交互），扩展性更强。

方法2：调用浏览器原生XPath API #

如果需要更底层的控制，可以通过page.evaluate()在页面上下文执行原生的document.evaluate，手动提取所有匹配节点：

const xpath = `//TD[contains(text(),"sometext")]/following-sibling::td`;
const elements = await page.evaluate((xpathExpr) => {
  const result = document.evaluate(
    xpathExpr,
    document,
    null,
    XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,
    null
  );
  const nodes = [];
  for (let i = 0; i < result.snapshotLength; i++) {
    nodes.push(result.snapshotItem(i));
  }
  return nodes;
}, xpath);

补充说明 #

官方推荐的waitForSelector本质是等待元素出现的API，默认只返回第一个匹配元素，仅适用于需要等待元素加载的场景，完全不适合替代旧版$x()的即时批量查询需求。

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