咨询：未深入研读CDP文档，能否在客户端获取元素nodeId？

结论：不行

NodeId是Chrome DevTools Protocol（CDP）的内部标识符，仅存在于浏览器后端进程中，前端JavaScript上下文完全没有权限或API能直接读取这个值——你没法在page.evaluate()里的客户端代码中拿到它。

适配你场景的替代方案 #

既然你不想用page.$("#test-id")或自定义data-*属性，这里提供两种可行思路：

1. 在后端直接通过CDP获取NodeId

跳过客户端定位，直接在Node.js端（Puppeteer环境）调用CDP接口定位元素并拿到NodeId：

const cdpSession = await page.target().createCDPSession();
// 获取文档根节点ID
const { root: { nodeId: rootNodeId } } = await cdpSession.send('DOM.getDocument');
// 查询目标元素的NodeId
const { nodeId } = await cdpSession.send('DOM.querySelector', {
  nodeId: rootNodeId,
  selector: '#test-id'
});
// 将NodeId转为ElementHandle（可选）
const { object } = await cdpSession.send('DOM.resolveNode', { nodeId });
const elementHandle = await page.evaluateHandle(() => window[object.objectId]);

2. 客户端返回元素唯一标识，后端再定位

如果必须在客户端先找到元素（比如复杂逻辑下只有前端能定位），可以让客户端返回元素的绝对XPath或其他唯一特征，后端用这个特征获取ElementHandle：

// 客户端生成并返回元素的绝对XPath
const elementXPath = await page.evaluate(() => {
  const el = document.getElementById('test-id');
  const generateXPath = (element) => {
    if (element.id) return `//*[@id="${element.id}"]`;
    let path = '';
    while (element && element.nodeType === Node.ELEMENT_NODE) {
      let siblingIndex = 1;
      let sibling = element.previousElementSibling;
      while (sibling) {
        if (sibling.tagName === element.tagName) siblingIndex++;
        sibling = sibling.previousElementSibling;
      }
      path = `/${element.tagName.toLowerCase()}[${siblingIndex}]${path}`;
      element = element.parentElement;
    }
    return path ? `/${path.substring(1)}` : '';
  };
  return generateXPath(el);
});
// 后端通过XPath获取ElementHandle
const [elementHandle] = await page.$x(elementXPath);

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