Puppeteer 22.x中XPath使用疑问：如何点击含'Next'文本的元素

你之前的代码失败原因很明确：page.waitForSelector()是专门用于CSS选择器的方法，不能直接传入XPath表达式。要在Puppeteer中使用XPath，得用专门的XPath相关API，比如page.waitForXPath()或page.$x()。

结合你提供的HTML结构和元素特性（class随机、role=button重复），可以通过精准匹配文本+辅助属性来定位元素，以下是可行的解决方案：

方案一：使用waitForXPath等待并点击 #

这个方法会等待元素出现在页面中，再执行点击操作，适合处理异步加载的元素：

// 用normalize-space处理文本可能存在的前后空格，确保匹配准确
const nextButton = await page.waitForXPath("//div[normalize-space(text())='Next' and @role='button']");
await nextButton.click();

方案二：使用$x获取元素列表后点击 #

如果能确定元素已经加载完成，可以直接获取匹配的元素数组，取第一个进行点击：

// 也可以结合tabindex属性进一步缩小范围，因为你的元素有tabindex="0"
const buttons = await page.$x("//div[text()='Next' and @tabindex='0']");
if (buttons.length > 0) {
  await buttons[0].click();
}

补充说明 #

• 当元素文本可能包含空格、换行时，normalize-space(text())会自动去除文本前后的空白字符，并把中间的多个空白替换成单个空格，避免因格式问题导致匹配失败。
• 不要混用CSS选择器方法和XPath表达式，Puppeteer对两种选择器有明确的方法划分。

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