装饰器是JavaScript中用于修改类、方法、属性或参数行为的语法特性,处于TC39第四阶段提案,需Babel或TypeScript等工具编译支持;以@开头,按类型接收不同参数,执行于定义时而非运行时。

装饰器是 JavaScript 中一种用于修改类、方法、属性或参数行为的语法特性,目前处于 TC39 第四阶段提案(已进入 ECMAScript 标准草案),但尚未正式纳入所有环境的默认支持。它不是运行时函数调用,而是在定义时“标记”目标,配合工具(如 Babel、TypeScript)编译后生效。
装饰器的基本形式
装饰器是一个以 @ 开头的表达式,写在类、方法、访问器、属性或参数前,紧邻其声明。它必须是可调用的(通常是函数),接收特定参数并可返回新描述符或修改原行为。
- 类装饰器:接收构造函数作为唯一参数
- 方法/访问器装饰器:接收目标对象(原型或构造函数)、属性名、属性描述符
- 属性装饰器:接收目标对象和属性名(注意:不传描述符,无法直接拦截赋值)
- 参数装饰器:接收目标对象、方法名、参数索引(仅用于元数据收集,不改变执行逻辑)
启用装饰器需要配置工具链
浏览器和 Node.js 原生暂不支持装饰器语法。实际使用需借助构建工具:
- TypeScript:在 tsconfig.json 中开启 "experimentalDecorators": true 和 "emitDecoratorMetadata": true
- Babel:安装 @babel/plugin-proposal-decorators,并在 .babelrc 中启用,推荐使用 legacy: false(符合当前提案)
- Vite / Webpack 等框架需确保对应插件已正确集成
常见实用场景与写法
装饰器本身不执行逻辑,而是把增强逻辑“注入”到目标上。典型用法包括日志、权限校验、防抖、自动注册、序列化控制等。
采用HttpClient向服务器端action请求数据,当然调用服务器端方法获取数据并不止这一种。WebService也可以为我们提供所需数据,那么什么是webService呢?,它是一种基于SAOP协议的远程调用标准,通过webservice可以将不同操作系统平台,不同语言,不同技术整合到一起。 实现Android与服务器端数据交互,我们在PC机器java客户端中,需要一些库,比如XFire,Axis2,CXF等等来支持访问WebService,但是这些库并不适合我们资源有限的android手机客户端,
立即学习“Java免费学习笔记(深入)”;
-
方法装饰器示例(防抖):
function debounce(wait) {
return function(target, key, descriptor) {
const original = descriptor.value;
descriptor.value = function(...args) {
if (this._debounceTimer) clearTimeout(this._debounceTimer);
this._debounceTimer = setTimeout(() => original.apply(this, args), wait);
};
};
}
使用:@debounce(300) handleClick() { ... } -
类装饰器示例(自动注册组件):
function register(name) {
return function(constructor) {
customElements.define(name, constructor);
};
}
使用:@register('my-button') class MyButton extends HTMLElement { ... } -
属性装饰器 + 元数据(常配合 reflect-metadata):
可用于标记字段是否需要序列化、校验规则等,运行时通过 Reflect.getMetadata() 读取
注意事项与限制
装饰器是静态语法糖,不能动态添加;它不改变 JS 原语语义,也不提供运行时拦截能力(如 Proxy 那样)。很多效果仍需配合其他机制实现:
- 属性装饰器无法拦截 get/set —— 需搭配 accessor 装饰器 或手动定义 getter/setter
- 装饰器函数执行时机是类定义时,不是实例化时,因此不能访问 this 实例状态(除非在方法内部闭包中)
- 多个装饰器从下往上(近到远)执行,类似高阶函数嵌套:
@A @B @C method()相当于A(B(C(method))) - 纯前端项目慎用复杂装饰器逻辑,可能影响 tree-shaking 和调试体验
基本上就这些。装饰器本质是让“横切关注点”更清晰地附着在代码结构上,用得好能提升可读性与复用性,但别为了用而用 —— 简单逻辑直接写反而更直白。










