在AppleScript的Safari网页抓取中，document.evaluate无返回结果该如何改写？

我之前在Safari里用AppleScript结合XPath抓取内容时，也碰到过一模一样的问题！浏览器控制台里XPath能正常返回文本，但AppleScript里就是拿不到结果，核心原因其实是AppleScript不会自动解析DOM文本节点的内容——控制台会帮你把文本节点展开显示成它的内容，但AppleScript拿到的是原始的节点对象，必须手动提取它的nodeValue属性才行。

问题根源 #

当你用document.evaluate指定XPathResult.FIRST_ORDERED_NODE_TYPE时，返回的是一个文本节点对象，而不是直接的文本内容。浏览器控制台会自动显示节点的nodeValue，但AppleScript只会返回节点对象本身（在AppleScript里可能表现为missing value或者空输出）。

解决方案：显式提取nodeValue #

你只需要在singleNodeValue后面加上.nodeValue，就能拿到实际的文本内容了。同时为了避免节点不存在时抛出错误，建议用可选链操作符?.或者条件判断处理null情况。

针对你的示例XPath改写 #

原来的代码：

log (do JavaScript "document.evaluate('//h1/span/text()[normalize-space()]', document.body, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue;" in front document)

改写后：

log (do JavaScript "document.evaluate('//h1/span/text()[normalize-space()]', document.body, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue?.nodeValue;" in front document)

针对你的复杂查询改写 #

对于你需要的复杂XPath语句，可以写成带条件判断的形式，确保节点不存在时返回空字符串或者自定义提示：

set metricText to do JavaScript "
  const targetNode = document.evaluate(
    \"//p[contains(., 'Metrics')]/following-sibling::p[1]/text()[normalize-space()]\",
    document.body,
    null,
    XPathResult.FIRST_ORDERED_NODE_TYPE,
    null
  ).singleNodeValue;
  // 如果节点存在就返回nodeValue，否则返回空字符串
  targetNode ? targetNode.nodeValue : '';
" in front document
log metricText

完整测试示例 #

结合你提供的示例HTML，这里有一个完整的AppleScript测试脚本，你可以直接运行验证：

tell application "Safari"
  -- 加载测试HTML页面（用data URL直接生成）
  set testPageContent to "<html> <body> <h1> <span>Test Entry</span> </h1> </body> </html>"
  set URL of front document to "data:text/html," & testPageContent
  
  -- 测试querySelector方法（作为对照）
  log "querySelector结果: " & (do JavaScript "document.querySelector('h1 > span').innerHTML;" in front document)
  
  -- 测试改写后的XPath方法
  set xpathResult to do JavaScript "
    const textNode = document.evaluate(
      '//h1/span/text()[normalize-space()]',
      document.body,
      null,
      XPathResult.FIRST_ORDERED_NODE_TYPE,
      null
    ).singleNodeValue;
    textNode ? textNode.nodeValue : '未找到匹配的文本节点';
  " in front document
  log "XPath结果: " & xpathResult
end tell

运行后，AppleScript编辑器的日志里应该会同时输出两种方法的结果，都是Test Entry。

额外注意事项 #

• 如果你的XPath语句里包含双引号，记得在JavaScript代码里转义成\"，或者用单引号包裹XPath字符串（前提是XPath本身不包含单引号）。
• 当处理可能不存在的节点时，一定要加条件判断，否则AppleScript可能会抛出“无法获取nodeValue”的错误。

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