通用函数调用拦截器的核心是通过proxy或高阶函数包装目标函数,在执行前后插入自定义逻辑,同时保持原函数签名和行为不变;proxy适用于对象方法拦截,高阶函数最通用,装饰器提供声明式语法,需注意this绑定、箭头函数、generator等边界情况。

实现通用函数调用拦截器的核心,是通过代理(Proxy)或高阶函数包装目标函数,在执行前后插入自定义逻辑(如日志、权限校验、性能统计等),同时保持原函数签名和行为不变。
使用 Proxy 拦截方法调用(适用于对象方法)
Proxy 适合拦截整个对象的方法调用,尤其当目标是一组具有统一访问方式的方法时。它不修改原函数,而是创建一个代理对象,将所有方法调用转发并增强。
- 对目标对象创建 Proxy,拦截
gettrap,返回包装后的函数 - 每次取方法时动态包装:保留 this 绑定、参数透传、返回值原样返回
- 支持异步函数,需判断返回值是否为 Promise 并 await 处理
- 示例场景:给 API service 对象的所有方法自动添加请求日志和错误捕获
使用高阶函数封装单个函数(最通用、无依赖)
这是兼容性最好、适用范围最广的方式,适用于任意函数(同步/异步、箭头函数、普通函数、类方法绑定后等)。
- 接收原始函数和拦截逻辑(before、after、onError),返回新函数
- 新函数内部调用原函数,并在 try/catch 中包裹执行流程
- 注意保留原函数的 name、length 和 prototype(对构造函数重要)
- 支持可选配置:是否跳过特定调用、按参数条件启用拦截等
支持装饰器语法(TypeScript / Babel 环境)
若项目支持装饰器(如 TypeScript + experimentalDecorators),可写出更声明式的拦截写法。
- 定义 @Interceptor() 装饰器,作用于类方法,内部仍基于高阶函数实现
- 装饰器可接受配置项,例如 @Interceptor({ log: true, timeout: 5000 })
- 需配合 Reflect.metadata 或闭包存储拦截规则,避免污染实例
- 注意:装饰器目前为 Stage 3 提案,生产环境建议搭配 babel 插件
处理边界情况的关键细节
真正“通用”的拦截器必须应对 JavaScript 的灵活性:
- this 绑定:包装函数需正确传递 this,推荐用 call/apply 而非直接调用
- 箭头函数:无法被 Proxy 的 get 拦截(无 this),应优先选用高阶函数方案
- Generator 函数:拦截器需识别并包装其返回的迭代器,而非直接执行
- 函数重载或动态生成方法:Proxy 方案天然支持;高阶函数需确保每次调用都经过包装入口











