装饰器是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 等框架需确保对应插件已正确集成
常见实用场景与写法
装饰器本身不执行逻辑，而是把增强逻辑“注入”到目标上。典型用法包括日志、权限校验、防抖、自动注册、序列化控制等。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
立即学习“Java免费学习笔记（深入）”；
-
方法装饰器示例（防抖）：
function debounce(wait) {<br> return function(target, key, descriptor) {<br> const original = descriptor.value;<br> descriptor.value = function(...args) {<br> if (this._debounceTimer) clearTimeout(this._debounceTimer);<br> this._debounceTimer = setTimeout(() => original.apply(this, args), wait);<br> };<br> };<br> }
使用：@debounce(300) handleClick() { ... } -
类装饰器示例（自动注册组件）：
function register(name) {<br> return function(constructor) {<br> customElements.define(name, constructor);<br> };<br>}
使用：@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 和调试体验
基本上就这些。装饰器本质是让“横切关注点”更清晰地附着在代码结构上，用得好能提升可读性与复用性，但别为了用而用 —— 简单逻辑直接写反而更直白。
