Node-RED函数节点出现Cannot find name 'document'语法错误的解决咨询

你遇到的错误是因为Node-RED函数节点默认采用Node.js环境的TypeScript检查规则，而page.evaluate()的回调函数实际是在浏览器DOM环境中执行的，TypeScript无法识别这个上下文差异，所以提示找不到document。以下是比// @ts-ignore更优的处理方式：

方案1：添加类型断言 #

直接在回调里给document做类型断言，让TypeScript识别它的DOM类型：

const data = await page.evaluate(() => (document as Document).querySelector('*').outerHTML);

或者拆分写法，可读性更好：

const data = await page.evaluate(() => {
  const domDocument = document as Document;
  return domDocument.querySelector('*').outerHTML;
});

方案2：配置TypeScript的lib选项 #

如果你的Node-RED支持自定义TypeScript编译配置（比如通过全局settings.js或函数节点的高级设置），可以修改编译选项，把dom库加入检查范围：
在TypeScript配置文件（如tsconfig.json）中添加：

{
  "compilerOptions": {
    "lib": ["es2020", "dom"]
  }
}

注意：部分Node-RED部署场景可能没有直接暴露全局tsconfig的入口，这种情况下方案1会更实用。

方案3：使用字符串形式的回调（不推荐） #

把page.evaluate的回调写成字符串，TypeScript不会检查字符串内部的代码：

const data = await page.evaluate(`document.querySelector('*').outerHTML`);

这种方式虽然能消除错误，但不利于代码维护和语法检查，仅适合简单场景。

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