javascript的装饰器是什么_如何使用它们增强类与方法的属性【教程】

夏萱君_4985

夏萱君_4985

2026-01-17

574人浏览

原创

JavaScript装饰器仍为Stage 3提案,浏览器原生不支持,需Babel或TypeScript编译;仅适用于类及成员,不支持普通函数;方法装饰器接收target、propertyKey、descriptor三参数,在类定义时同步执行。

javascript的装饰器是什么_如何使用它们增强类与方法的属性【教程】

JavaScript 的装饰器目前仍是 Stage 3 提案,未被正式纳入标准,所有浏览器原生都不支持,必须通过 Babel(@babel/plugin-proposal-decorators)或 TypeScript 编译才能运行。

装饰器只能用在类和类成员上,不能用于普通函数

这是最容易混淆的一点:你不能写 @log function foo() {} —— 这会直接报语法错误。装饰器的语法糖只作用于类声明、方法、访问器、属性(仅 TS 支持字段装饰器)和参数(实验性,极少用)。

实际可用的场景只有:

  • 类本身:@sealed class MyClass {}
  • 类方法:class C { @readonly method() {} }
  • 类 getter/setter:get @cached value() {}
  • TypeScript 中的字段:class C { @observable name = 'a'; }(需启用 useDefineForClassFields)

注意:Babel 默认不支持字段装饰器,TypeScript 需配置 "experimentalDecorators": true 和 "useDefineForClassFields": true 才能解析 @decorator field 语法。

装饰器函数接收什么参数?执行时机在哪?

方法装饰器(最常用)接收三个参数:target(原型对象)、propertyKey(方法名字符串)、descriptor(属性描述符)。它在类定义阶段执行,不是在方法调用时。

例如这个日志装饰器:

Build Java agent transport gateways with Atmosphere
Build Java agent transport gateways with Atmosphere

使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

下载
function log(target, propertyKey, descriptor) {
  const original = descriptor.value;
  descriptor.value = function (...args) {
    console.log(`Calling ${String(propertyKey)} with`, args);
    return original.apply(this, args);
  };
  return descriptor;
}

class Calculator {
  @log
  add(a, b) {
    return a + b;
  }
}

关键点:

  • descriptor.value 是原始方法,必须返回修改后的 descriptor 才生效
  • 不要漏掉 return descriptor,否则方法会被设为 undefined
  • 装饰器函数本身是同步执行的,在模块加载时就完成包装,不是懒加载

Babel 和 TypeScript 的装饰器行为不一致

这是线上出问题的高发区。Babel 的装饰器默认使用「legacy」模式(类似 TS 早期行为),而 TypeScript 5.0+ 默认使用「2023」语义(更贴近提案最终方向),二者对字段初始化、this 绑定、装饰器执行顺序的处理不同。

若你在 Babel 中用了 @init 装饰字段,又在 TS 中编译,大概率会发现值没被正确赋值。解决办法:

  • Babel 配置中显式指定 {"version": "2023"}(需 Babel 7.23+)
  • TypeScript 中保持 "experimentalDecorators": true,但避免混合使用字段装饰器和复杂初始化逻辑
  • 生产环境尽量避免依赖装饰器做关键初始化,改用构造函数或 init() 显式调用

装饰器不是语法糖的终点,而是元编程的入口——但它依赖工具链、版本对齐和明确的执行时序。一旦跨环境部署,@ 符号背后藏着的其实是两套编译器对同一份提案的不同解读。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

java速学教程(入门到精通)
java速学教程(入门到精通)

java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

2026.02.13

332

17

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

2026.02.25

560

17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

2026.03.13

411

19

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

2026.06.03

346

29

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

2026.06.16

778

8

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1958

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3244

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6424

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

6649

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习