Node.js 环境下通过 C++ Addon 模拟 document.all 的实现

探讨了在 Node.js 环境中模拟浏览器 document.all 对象的难点与解决方案。由于 JS 层面无法同时满足 typeof 为 undefined 且对象存在，作者采用 C++ Addon 结合 V8 引擎的 MarkAsUndetectable 接口实现了该功能。通过原生扩展拦截函数调用和索引访问，成功复现了现代浏览器的反直觉行为，并提供了完整的测试验证代码及后续优化思路。

人间过客发布于 2026/4/5更新于 2026/4/1710 浏览

为解决编译耗时问题，选择通过 Node.js C++ Addon 方式实现轻量版模拟。通过 addon，可以在任何环境中直接导入 const addon = require('./addon') 即可使用。这个./addon 是编译好的 addon.node 扩展。

为什么 document.all 这么难模拟？

document.all 是 IE4 时代的遗留产物。为了兼容旧网页，现代浏览器（Chrome/Firefox）保留了它，但为了不鼓励开发者使用，W3C 和浏览器厂商搞了一个非常反直觉的设计：'Undetectable'特性。

在 Chrome 控制台里试一下就知道有多诡异：

// 既存在，又不存在
typeof document.all === 'undefined' // true
document.all === undefined // false (严格相等)
document.all == undefined // true (宽松相等)
// 看起来是 falsy，但能取值
if(document.all){/* 不会执行 */}
document.all.length // 正常返回数字
document.all[0] // 正常返回元素

这就是 Node.js 纯 JS 模拟的死穴。

无论怎么用 Proxy 拦截，或者用 Object.defineProperty，在 JS 层面你永远无法让一个对象的 typeof 变成 'undefined'。JSDOM 至今没有完美支持这一点（它返回的是 'object'），这就是很多反爬脚本检测 JSDOM 的核心依据。

常见的检测逻辑

对方想抓你，只需要一行代码：

// 绝杀检测
if(typeof document.all !== 'undefined' && document.all) {
  .();
}

相关免费在线工具

Keycode 信息

查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online

Escape 与 Native 编解码

JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online

JavaScript / HTML 格式化

使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online

JavaScript 压缩与混淆

Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online

Base64 字符串编码/解码

将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online

Base64 文件转换器

将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online

const {JSDOM} = require('jsdom'); const addon = require('./addon'); const dom = new JSDOM(`<!DOCTYPE html><p>Hello world</p></html>`); window = dom.window; // 保存原始 document 引用 const realDocument = dom.window.document; function myAllHandler(arg) { // 使用原始 document 的方法 console.log('myAllHandler arg', arg); if(arg === undefined) { return realDocument.getElementsByTagName('*'); } if(typeof arg === 'number') { const all = realDocument.getElementsByTagName('*'); return all[arg] || null; } if(typeof arg === 'string') { const byId = realDocument.getElementById(arg); if(byId) return byId; const byName = realDocument.getElementsByName(arg); if(byName && byName.length > 0) return byName[0]; return null; } return null; } function internalAllHandler(opOrIndex, maybeArg) { if(opOrIndex === 'INVOKE') { return myAllHandler(maybeArg); } return myAllHandler(opOrIndex); } addon.SetAllHandler(internalAllHandler); addon.SetTraceLog(true); // 调用链日志 addon.SetVerboseLog(false); // 详细日志 // 直接使用 addon.khall，不经过 watch // 替换 document.all document = addon.watch(realDocument); // 然后在 proxy 上直接设置（绕过 watcher） Object.defineProperty(document, 'all', { get: function() { return addon.khall; }, configurable: true }); console.log(Object.prototype.toString.call(document.all)); console.log('\n--- 1. Access & Call ---'); // 索引访问 console.log('document.all[0]:', document.all[0]); // 字符串键访问 console.log('document.all["app"]:', document.all["app"]); // 函数式调用 - 数字 console.log('document.all(0):', document.all(0)); // 函数式调用 - 字符串 console.log('document.all("app"):', document.all("app")); // 长度 console.log('document.all.length:', document.all.length); console.log('\n--- 2. Typeof & Undefined Check ---'); // 预期：'undefined' (尽管它是一个对象/函数) console.log('typeof document.all:', typeof document.all); // 预期：true (因为 typeof 是 undefined) console.log('document.all === undefined:', document.all === undefined); // 预期：true console.log('document.all == undefined:', document.all == undefined); // 预期：true console.log('document.all == null:', document.all == null); // 反向验证：它实际上不是 null console.log('document.all === null:', document.all === null); // 应该是 false console.log('\n--- 3. Boolean Logic ---'); // 强制转换 console.log('Boolean(document.all):', Boolean(document.all)); // 预期：false console.log('!!document.all:', !!document.all); // 预期：false console.log('!document.all:', !document.all); // 预期：true // if 语句行为 if(document.all) { console.log('Check: if (document.all) is TRUE [❌ Fail or Old IE]'); } else { console.log('Check: if (document.all) is FALSE [✅ Pass - Modern Behavior]'); } // 逻辑运算 console.log('document.all || "fallback":', document.all || "fallback"); // 预期："fallback" console.log('document.all && "hidden":', document.all && "hidden"); // 预期：document.all (因为它是 falsy) console.log('\n--- 4. Prototype & Object Tag ---'); // 预期：[object HTMLAllCollection] console.log('Object.prototype.toString.call(document.all):', Object.prototype.toString.call(document.all)); // 预期：HTMLAllCollection if(Symbol.toStringTag in document.all) { console.log('Symbol.toStringTag:', document.all[Symbol.toStringTag]); } // 检查构造函数 console.log('document.all.constructor.toString:', document.all.constructor ? document.all.constructor.toString() : 'undefined'); console.log('document.all.constructor.name:', document.all.constructor ? document.all.constructor.name : 'undefined'); console.log('\n--- 5. Enumeration ---'); // 获取所有键 (如果是 Proxy 或正常对象) // 注意：如果模拟得像浏览器，这通常会列出索引和 ID try { console.log('Object.keys(document.all).length:', Object.keys(document.all).length); } catch(e) { console.log('Object.keys failed:', e.message); }

Node.js 环境下通过 C++ Addon 模拟 document.all 的实现

为什么 document.all 这么难模拟？

常见的检测逻辑

更多推荐文章

相关免费在线工具

解决方案：从 C++ 层面入手

核心 C++ 实现

对接 JS 层

验证结果

新的问题

Node.js 环境下通过 C++ Addon 模拟 document.all 的实现

为什么 document.all 这么难模拟？

常见的检测逻辑

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

解决方案：从 C++ 层面入手

核心 C++ 实现

对接 JS 层

验证结果

新的问题