核心原理：对象操作的拦截层

Proxy 充当目标实体的外层包装器，负责捕获并接管针对该实体的基础运算（如成员访问、赋值、构造器调用等）。实例化方式如下：

const wrapper = new Proxy(originalObj, interceptionRules);

其中第二个参数是一个包含多个钩子函数（Traps）的配置对象。每个钩子对应一种底层操作的重写规则，从而实现细粒度的行为控制。

常用拦截钩子清单

• get()：拦截属性或方法读取
• set()：拦截属性写入或修改
• apply()：拦截函数直接调用或 .call()/.apply() 执行
• has()：拦截 in 运算符检查

代码实践：读取劫持与日志追踪

以下示例演示如何在获取数据前插入监控逻辑：

// 原始数据结构
const sourceData = {
  userName: 'Alice',
  sessionToken: 'xyz-890'
};

// 定义拦截规则集
const auditRules = {
  get(src, fieldName) {
    console.log(`[Audit] 正在读取字段: ${fieldName}`);
    // 委托给标准读取流程
    return Reflect.get(...arguments);
  }
};

// 生成包装实例
const monitoredObj = new Proxy(sourceData, auditRules);

console.log(monitoredObj.userName); // 触发控制台输出 → Alice

代码实践：写入校验与类型约束

利用 set 钩子可以实现严格的数据入库验证：

const schemaValidator = {
  set(targetObj, key, newValue) {
    // 自定义业务规则：限制特定字段的类型
    if (key === 'score' && typeof newValue !== 'number') {
      throw new TypeError('分数必须为数值类型');
    }
    // 验证通过后交由引擎完成实际赋值
    return Reflect.set(targetObj, key, newValue);
  }
};

const validTarget = new Proxy({}, schemaValidator);
validTarget.score = 95;      // 正常执行
validTarget.score = '优秀';   // 抛出 TypeError

Reflect API 的设计价值

Reflect 是一套与 Proxy 陷阱一一对应的原生工具集，专门用于暴露底层的默认行为。它在代理模式中扮演了"安全回退"的角色，主要优势在于：

• 避免开发者重复实现复杂的底层内存操作
• 保证返回值语义符合 ECMAScript 规范
• 大幅简化透传型包装器的编写成本

代码实践：一键透传模式

由于 Reflect 本身提供了所有必需的钩子实现，可以直接将其作为处理器传入构造函数：

const rawConfig = { cacheKey: 'temp-value' };
// 直接将 Reflect 绑定为处理器对象
const passThroughProxy = new Proxy(rawConfig, Reflect);

// 任何未显式重写的操作都会自动映射到 rawConfig
console.log(passThroughProxy.cacheKey); // 直接返回 temp-value

典型工程场景

1. 自动化表单校验：在用户输入阶段实时拦截赋值行为
2. 状态变更审计：无侵入地记录对象生命周期内的所有读写轨迹
3. 惰性属性生成：按需计算并缓存复杂运算结果

代码实践：数组方法增强

扩展内置方法时，需特别注意作用域绑定与参数透传：

const baseList = [];
const listWrapper = {
  get(src, methodName) {
    if (methodName === 'push') {
      return function(...insertedItems) {
        console.log(`[Tracker] 新增条目: ${insertedItems.join(', ')}`);
        // 保持原有 this 指向，正确派发参数
        return Reflect.apply(src[methodName], src, insertedItems);
      };
    }
    return Reflect.get(...arguments);
  }
};

const trackedList = new Proxy(baseList, listWrapper);
trackedList.push(42, 7); // 触发日志 → 列表变为 [42, 7]

运行时约束与不变式检查

代理实现并非随心所欲，必须遵守 ECMAScript 定义的陷阱不变式（Trap Invariants）。例如 defineProperty 钩子必须返回布尔值以指示操作成败。违反规范将直接导致运行时报错。

代码实践：违反不变式的典型反例

const brokenHandler = {
  defineProperty(trg, prop, desc) {
    console.log('Attempting property definition');
    // 错误：缺失布尔值返回，也未委托给 Reflect
  }
};

const ruleProxy = new Proxy({}, brokenHandler);
Object.defineProperty(ruleProxy, 'status', { value: 'active' }); 
// 此处将抛出 TypeError，因为钩子未遵循规范契约

协作流程说明