可通过代理构造函数的 prototype 实现继承体系方法调用的动态监控:拦截 get 获取函数属性并包装审计逻辑,同步处理 getPrototypeOf、has、ownKeys 等 trap 保障原型链完整与 instanceof 正常;支持逐级代理多层继承原型链,并提供开关、白名单、采样率等可配置审计策略。
可以通过 proxy 拦截原型对象的属性访问行为,在方法调用前注入审计逻辑,从而实现对整个继承体系中所有方法调用的动态监控。关键不是代理实例本身,而是代理其 prototype 或构造函数的原型链节点,使所有从该原型继承的方法都经过统一拦截点。
代理目标:构造函数的 prototype 对象
要覆盖整个继承体系,需在类定义后立即对其 prototype 进行代理,而非仅代理某个实例:
- 直接对
MyClass.prototype创建 Proxy,所有通过该原型链继承的方法(包括子类未重写的父类方法)都会触发get拦截 - 拦截时判断
key是否为函数类型(typeof target[key] === 'function'),是则包装为带审计逻辑的函数 - 包装函数内部记录调用时间、参数、调用栈(
new Error().stack),再执行原方法并捕获返回值或异常
保持原型链完整与 instanceof 正常工作
仅代理 prototype 的 get 不足以支撑完整语义,必须同步处理关键 trap:
-
getPrototypeOf:必须原样返回Object.getPrototypeOf(target),否则子类实例的原型链会被切断,instanceof判断失效 -
has和ownKeys:需透传,确保in操作符和for...in遍历行为不变 - 避免重写
constructor属性;若需保留,应在get中显式返回原始构造函数
支持多层继承的递归代理策略
若需审计整个继承树(如 A ← B ← C),不能只代理最顶层原型。可行做法是:
⚠️ 已弃用 — 该技能已拆分为两个独立技能,以提升模块化程度:**webchat-https-proxy**(HTTPS/WSS 反向代理)和 **webchat-voi...**
- 从最底层类开始,逐级向上遍历其原型链:
let p = Object.getPrototypeOf(C.prototype),直到为null - 对每层非
Object.prototype的原型对象,检查是否已被代理;若未代理,则用相同 handler 创建新 Proxy 并用Object.setPrototypeOf替换原原型 - 注意:替换后需确保子类
prototype的__proto__指向新代理对象,否则继承关系断裂
审计逻辑应隔离且可配置
实际使用中,审计行为需灵活开关、按需过滤:
- 用闭包保存审计开关(
enabled = true)、白名单(['save', 'validate'])、采样率(如仅记录 10% 调用) - 避免在审计函数中执行耗时操作(如发网络请求),建议将日志推入队列,由独立 flush 机制批量处理
- 对 getter/setter 方法,需在
get和settrap 中分别审计,注意receiver参数必须透传,防止 this 绑定丢失










