如何判断XPath是否存在并实现分支处理（基于Puppeteer）

要实现根据指定XPath是否存在执行不同操作，核心是通过page.$x()返回的元素数组长度判断元素是否存在，同时避免使用会强制等待元素出现的waitForXPath（避免元素不存在时抛出错误中断流程）。以下是修改后的完整脚本：

const puppeteer = require('puppeteer');

(async () => {
    let launchOptions = { headless: false, args: ['--start-maximized'] };
    const browser = await puppeteer.launch(launchOptions);
    const page = await browser.newPage();

    await page.setViewport({width: 1366, height: 768});
    await page.setUserAgent('Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36');

    await page.goto('https://www.lamudi.co.id/newdevelopments/');

    // 直接获取XPath对应的元素数组，不强制等待
    const elHandleArray = await page.$x("(//span[@class='CountTitle-number'])[1]");

    if (elHandleArray.length > 0) {
        // XPath存在时的操作
        const lamudiNewPropertyCount = await page.evaluate(el => el.textContent, elHandleArray[0]);
        console.log('Total Property Number is:', lamudiNewPropertyCount);
    } else {
        // XPath不存在时的操作
        console.log('目标元素不存在，执行替代逻辑');
        // 这里可以添加自定义操作，比如截图、记录日志等
        // await page.screenshot({path: 'element_not_found.png'});
    }

    await browser.close();
})();

关键说明 #

• 判断元素存在性：page.$x()会返回匹配XPath的所有元素的ElementHandle数组，数组长度大于0则表示元素存在，否则不存在。
• 避免强制等待：移除原脚本中的await page.waitForXPath()，因为该方法会一直等待元素出现，超时后会抛出错误，无法进入“元素不存在”的分支逻辑。
• 可选：添加超时等待判断：如果需要等待一段时间再判断元素是否存在，可以用page.waitForFunction()结合XPath查询，示例如下：

  // 等待最多5秒，判断元素是否存在
  const elementExists = await page.waitForFunction(
    xpath => document.evaluate(xpath, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue !== null,
    {},
    "(//span[@class='CountTitle-number'])[1]"
  ).catch(() => false);
  
  if (elementExists) {
      // 元素存在的操作
  } else {
      // 元素不存在的操作
  }
  

  这个方法会在指定时间内等待元素出现，超时后返回false，不会抛出错误，适合需要等待页面加载完成再判断的场景。

内容的提问来源于stack exchange，提问作者Alucian Corrêa