跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
C++Node.js大前端

Web 环境模拟实战:用 C++ Addon 完美还原 document.all

针对 Node.js 环境中模拟浏览器 document.all 对象时遇到的 typeof 检测难题,纯 JS 方案无法实现“存在但 typeof 为 undefined”的特性。通过编写 C++ Addon 调用 V8 引擎的 MarkAsUndetectable 接口,在底层解决了这一反直觉行为。结合 JSDOM 与原生 C++ 逻辑,实现了支持索引访问、函数调用及原型链伪造的完整模拟方案,有效绕过常见的反爬检测机制,同时探讨了原型链处理中的潜在限制与优化方向。

zhang发布于 2026/4/10更新于 2026/10/25125 浏览
Web 环境模拟实战:用 C++ Addon 完美还原 document.all

在 Web 反爬对抗中,环境模拟是绕不开的一环。之前尝试过魔改 Node.js 源码的思路,虽然可行但编译周期太长。这次决定先走轻量路线,通过 Node.js C++ Addon 的方式实现一套基础方案,后续再考虑移植到原生。这种方式的优势在于,只要编译好 .node 扩展,任何 Node 环境都能直接 require 使用。

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

document.all 是 IE4 时代的遗留产物。为了兼容旧网页,现代浏览器(Chrome/Firefox)保留了它,但 W3C 和厂商设计了一个非常反直觉的特性:Undetectable。这意味着它在 JS 层面既存在,又表现得像不存在。

在 Chrome 控制台里试一下就能感受到这种诡异:

// 既存在,又不存在
typeof document.all === 'undefined' // true
document.all === undefined          // false (严格相等)
document.all == undefined           // true (宽松相等)

// 看起来是 falsy,但能取值
if(document.all) { /* 不会执行 */ }
document.all.length                 // 正常返回数字
document.all[0]                     // 正常返回元素

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

常见的检测逻辑

对方想抓你,通常只需要一行代码:

// 绝杀检测
if(typeof document.all !== 'undefined' && document.all) {
    console.log("检测到模拟环境,封禁!");
}

或者更隐蔽的原型链检测:

// 原型链检测
if(Object.prototype.toString.call(document.all)!=="[object HTMLAllCollection]"){
    return false; // 伪造失败
}

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

既然 JS 层面无解,我们就下沉到 V8 引擎层面。V8 提供了 MarkAsUndetectable 接口,专门就是为了实现这种怪异行为的。

核心 C++ 实现

核心逻辑其实就这几步:

// 1. 创建对象模板
Local<ObjectTemplate> template = ObjectTemplate::New(isolate);

// 2. 注入灵魂:标记为 Undetectable
// 这一步之后,typeof 就会返回 undefined,且在布尔判断中为 false
template->MarkAsUndetectable();

// 3. 拦截函数调用:支持 document.all("id") 或 document.all(0)
template->SetCallAsFunctionHandler(CallHandler);

// 4. 拦截索引访问:支持 document.all[0]
template->SetHandler(IndexedPropertyHandlerConfiguration(IndexedGetter));

// 5. 实例化并导出
Local<Object> instance = template->NewInstance(context).ToLocalChecked();

通过这个 Addon 生成的对象,在 Node.js 环境里就能表现得和浏览器一模一样。

对接 JS 层

C++ 只负责提供'虽然存在但 typeof 是 undefined'的容器,具体的 DOM 查询逻辑(比如根据 ID 找元素)还是写在 JS 里比较方便。我们可以这样把两者结合起来:

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) {
    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);

// 替换 document.all
document = addon.watch(realDocument);
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 ---');
console.log('typeof document.all:', typeof document.all); // 预期:undefined
console.log('document.all === undefined:', document.all === undefined); // false
console.log('document.all == undefined:', document.all == undefined); // true
console.log('document.all == null:', document.all == null); // true
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(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");
console.log('document.all && "hidden":', document.all && "hidden");

console.log('\n--- 4. Prototype & Object Tag ---');
console.log('Object.prototype.toString.call(document.all):', Object.prototype.toString.call(document.all));
console.log('Symbol.toStringTag:', document.all[Symbol.toStringTag]);
console.log('document.all.constructor.name:', document.all.constructor ? document.all.constructor.name : 'undefined');

console.log('\n--- 5. Enumeration ---');
try {
    console.log('Object.keys(document.all).length:', Object.keys(document.all).length);
} catch(e) {
    console.log('Object.keys failed:', e.message);
}

验证结果

跑一下测试,看看效果是否符合预期:

[object HTMLAllCollection]
--- 1. Access & Call ---
[KhBox Trace] IndexedGetter called with index:0
myAllHandler arg 0 ✅ Pass
||| document.all[0]: HTMLHtmlElement {}
document.all["app"]:undefined
[KhBox Trace] CALL:khall(0)
myAllHandler arg 0 ✅ Pass
||| document.all(0): HTMLHtmlElement {}
[KhBox Trace] CALL:khall(app)
myAllHandler arg app ✅ Pass
||| document.all("app"): HTMLParagraphElement {}
document.all.length:0

--- 2. Typeof & Undefined Check ---
✅ Pass ||| typeof document.all:undefined
✅ Pass ||| document.all === undefined:false
✅ Pass ||| document.all == undefined:true
✅ Pass ||| document.all == null:true
✅ Pass ||| document.all === null:false

--- 3. Boolean Logic ---
Boolean(document.all):false
!!document.all:false
!document.all:true
Check: if (document.all) is FALSE [✅ Pass - Modern Behavior]
document.all || "fallback": fallback
document.all && "hidden": HTMLAllCollection {length:0...}

--- 4. Prototype & Object Tag ---
Object.prototype.toString.call(document.all):[object HTMLAllCollection]
Symbol.toStringTag: HTMLAllCollection
document.all.constructor.name: HTMLAllCollection

--- 5. Enumeration ---
Object.keys(document.all).length:2

新的问题与思考

这个 length 目前是 0,很好改,改成 document.getElementsByTagName('*').length 的值就可以了。不过要注意,这个 length 属性应该是在原型链上,而不是实例对象上。在 HTMLAllCollection 里面定义才符合规范。

所以,这个 addon 思路和魔改 Node 的最大缺陷就是:不知道某个方法是在实例,还是在它的哪一层原型上。 这必须要在 JS 层来处理。

不过,如果是和之前的思路结合,应该能省下非常多的代码。比如:

const handler = function(obj, prop, args) {
    const className = obj.constructor.name;
    const key = `${className}_${prop}`;
    
    // 1. 日志
    console.log(`{get: ${key}}`);
    
    // 2. 如果有自定义实现
    if(khBox.envFuncs[key]) {
        return khBox.envFuncs[key].apply(obj, args);
    }
    
    // 3. 否则走 JSDOM
    return Reflect.get(khBox.memory.jsdom[className], prop);
};

// 转到 C 层去拦截
khboxAddon.setupInterceptor(document, handler);

这样就简单地实现了自己的函数 + JSDOM 结合补全,且不用 Proxy 来层层追踪代理。因为 C 层自动加了 get、set 等的回调,自动输出调用链。相当于是实现了之前 JS 框架里的 proxy(获取调用关系)、dispatch(先保护后分发)、setnative(保护)等的工具函数。

唯一的问题就是找到原型上的所有方法并保存下来,把它写成符合这个思路的模板。后续会不断更改这个框架,争取早日完善成型。

目录

  1. 为什么 document.all 这么难模拟?
  2. 常见的检测逻辑
  3. 解决方案:从 C++ 层面入手
  4. 核心 C++ 实现
  5. 对接 JS 层
  6. 验证结果
  7. 新的问题与思考

更多推荐文章

查看全部
  • Quartus Prime FPGA 开发新手入门指南
  • SpringBoot 微服务重试常用解决方案汇总与使用详解
  • Python 为何成为 AI 开发首选?技术特性与生态全景解析
  • CodeX 二次验证手机号
  • 人工智能应用工程师(高级)课程体系与核心能力解读
  • 网络安全入门指南:技术基础与学习路径
  • 大模型日报:今日必读的 9 篇前沿论文
  • C++ 基础语法与算法初步:从循环到递归
  • 注意力机制与 Transformer 模型实战
  • HTML5+CSS3+JavaScript 实现高木同学圣诞树 GalGame 开发
  • Open WebUI 与 Ollama 模型文件默认存储路径说明
  • JDK 21 与 JDK 8 主要新特性对比
  • C++ Connector 与 MySQL:配置陷阱与性能优化深度解析
  • 近五年体内微纳米机器人肿瘤精准治疗综述:聚焦胶质母细胞瘤
  • 鸿蒙 HarmonyOS 与 Flutter 3.27.4 混合开发:开发环境配置
  • MySQL 图形化界面工具详解与选型指南
  • 大语言模型 InternLM2(书生·浦语)一键部署
  • 从零开始训练大型语言模型(LLM)实战指南
  • STM32 运行 AI 大模型的四种方案与案例
  • Project AirSim 无人机避障算法解析

相关免费在线工具

  • Base64 字符串编码/解码

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

  • Base64 文件转换器

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

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online