JavaScript装饰器与元数据编程

装饰器是JavaScript/TypeScript中用于扩展类、方法等行为的高阶函数,通过@expression语法在运行时修改目标结构。支持类、方法、属性、访问器和参数五种类型,常用于日志、权限、依赖注入等场景。结合reflect-metadata库可实现元数据编程,使用Reflect.metadata定义和读取键值对信息,TypeScript还支持design:type等设计时类型元数据。典型应用如依赖注入:通过@Inject装饰参数并利用emitDecoratorMetadata生成类型信息,容器按需实例化并注入依赖。需启用experimentalDecorators和emitDecoratorMetadata编译选项。该技术广泛用于Angular、NestJS等框架,提升代码可维护性与扩展性。

javascript装饰器与元数据编程

JavaScript 装饰器和元数据编程是现代前端开发中越来越重要的技术,尤其在使用 TypeScript 和框架如 Angular、NestJS 时广泛存在。它们让开发者可以在类、方法、属性等代码结构上附加额外行为或信息,实现更灵活的元编程能力。

装饰器是什么?

装饰器是一种特殊类型的声明,可以被附加到类声明、方法、访问器、属性或参数上。它使用 @expression 的形式,其中 expression 必须是一个函数,该函数会在运行时被调用,传入被装饰的 target、key 和 property descriptor 等信息。

装饰器本质是一个高阶函数,通过闭包捕获配置,并返回一个处理目标的函数。例如:

function Log(target: any, propertyName: string) {  console.log(`Property ${propertyName} of`, target);}

class User {@Logname = 'Alice';}

上面的例子中,@Log 将在类定义时执行,打印出被修饰的属性名。

立即学习“Java免费学习笔记(深入)”;

装饰器的类型与使用场景

JavaScript/TypeScript 支持多种装饰器,每种用于不同的语法结构:

类装饰器:作用于类构造函数,可用于修改类行为或替换类定义。常用于依赖注入或路由注册。方法装饰器:接收目标原型、方法名和描述符,适合做日志、权限控制、缓存等切面操作。访问器装饰器:应用于 getter/setter,可监控或拦截访问逻辑。属性装饰器:用于标记字段,通常不直接改变行为,而是记录元数据。参数装饰器:标注构造函数或方法中的某个参数,常用于依赖注入容器识别类型。

比如一个简单的性能监控方法装饰器:

function Measure(target: any, propertyKey: string, descriptor: PropertyDescriptor) {  const originalMethod = descriptor.value;

descriptor.value = function (...args: any[]) {console.time(propertyKey);const result = originalMethod.apply(this, args);console.timeEnd(propertyKey);return result;};

return descriptor;}

class Calculator {@Measurefib(n: number): number {if (n < 2) return n;return this.fib(n - 1) + this.fib(n - 2);}}

元数据反射(Metadata Reflection)

装饰器本身不能直接存储任意数据,但结合 reflect-metadata 库,可以实现真正的元数据编程。这个库允许你在类或方法上读写键值对形式的元数据。

启用元数据需要安装 reflect-metadata 并引入:

import 'reflect-metadata';

const TYPE_KEY = 'design:type';const ROLE_KEY = 'custom:role';

function Role(role: string) {return Reflect.metadata(ROLE_KEY, role);}

@Role('admin')class DashboardController {@Role('guest')getData() {}}

// 读取元数据const role = Reflect.getMetadata(ROLE_KEY, DashboardController.prototype, 'getData');console.log(role); // 'guest'

这里用到了两个层级的元数据:类上的角色和方法上的角色。Reflect 提供了 getMetadata、defineMetadata、hasMetadata 等 API,便于构建依赖注入、序列化、验证系统。

TypeScript 还内置支持一些设计时元数据,如 design:type、design:paramtypes、design:returntype,开启 emitDecoratorMetadata 后会自动注入类型信息。

实际应用:依赖注入示例

利用装饰器和元数据,可以实现轻量级依赖注入容器:

import 'reflect-metadata';

const INJECT_KEY = 'di:inject';

function Inject(token: any) {return (target: any, propertyKey: string | undefined, parameterIndex: number) => {const existingTokens = Reflect.getMetadata(INJECT_KEY, target, 'constructor') || [];existingTokens[parameterIndex] = token;Reflect.defineMetadata(INJECT_KEY, existingTokens, target, 'constructor');};}

class DatabaseService {}class LoggerService {}

class UserService {constructor(@Inject(DatabaseService) private db: DatabaseService,@Inject(LoggerService) private logger: LoggerService) {}}

// 容器解析依赖function createInstance(target: any): T {const tokens = Reflect.getMetadata(INJECT_KEY, target, 'constructor') || [];const dependencies = tokens.map((token: any) => new token());return new target(...dependencies);}

const userSvc = createInstance(UserService);

这个例子展示了如何通过参数装饰器标记依赖,并在运行时由容器自动解析并实例化。

基本上就这些。装饰器结合元数据提供了强大的抽象能力,虽然原生 JavaScript 还未正式支持(目前处于 Stage 3),但在 TypeScript 中已非常成熟,是构建可维护、可扩展框架的核心工具之一。注意合理使用,避免过度元编程导致调试困难。不复杂但容易忽略的是:确保正确配置 tsconfig.json 中的 experimentalDecorators 和 emitDecoratorMetadata 选项。基本上就这些。

以上就是JavaScript装饰器与元数据编程的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1531279.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月20日 22:42:45
下一篇 2025年12月20日 22:43:05

相关推荐

  • TypeScript 中如何约束对象为 CSS 属性?

    typescript 中如何约束对象为 css 属性 想要约束一个对象为 css 属性,以便在调用函数时得到自动补全提示,可以采用以下方法: 使用 react 的 cssproperties 类型 对于 react 项目,可以使用 react 提供的 cssproperties 类型: 立即学习“前…

    2025年12月24日
    300
  • 如何在 TypeScript 中约束对象为 CSS 属性?

    如何在 typescript 中约束对象为 css 属性? 在 typescript 中,为特定目的而约束对象类型是很重要的。在本文中,我们将探究如何将对象约束为包含 css 属性。 考虑以下函数: function setattrstoelement(el: htmlelement, attr: …

    2025年12月24日
    000
  • 如何使用 TypeScript 约束对象以匹配 CSS 属性?

    如何约束 typescript 对象以匹配 css 属性? setattrstoelement 函数接收两个参数,其中第二个参数应为 css 属性。对于 react 项目,可以使用 cssproperties 类型: import { cssproperties } from “react”;fun…

    2025年12月24日
    000
  • 为什么使用 :global 修改 Antd 样式无效?

    :global 修改 antd 样式为何无效 本文旨在帮助您解决在组件内使用:global修改 antd 全局样式未生效的问题。 问题描述 您在组件内使用:global修改 antd 按钮样式,但没有生效。完整代码可参考 https://codesandbox.io/s/fk7jnl 。 解决方案 …

    2025年12月24日
    000
  • 为什么在 React 组件中无法获得 Tailwind CSS 语法提示?

    为什么在 React 组件中无法获得 Tailwind CSS 语法提示? 你在 VSCode 中编写 HTML 文件时,可以正常获取 Tailwind CSS 语法提示。但当你尝试在 React 组件中编写 Tailwind CSS 时,这些提示却消失不见了。这是什么原因造成的? 解决方案 要解决…

    2025年12月24日
    000
  • 如何在 VSCode 中为 React 组件启用 Tailwind CSS 提示?

    在 vscode 中为 react 组件启用 tailwind css 提示 如果你在使用 vscode 编写 react 组件时,发现 tailwind css 提示无法正常显示,这里有一个解决方法: 安装 tailwind css intellisense 插件 这是实现代码提示的关键,确保你已…

    2025年12月24日
    200
  • 如何直接访问 Sass 地图变量的值?

    直接访问 sass 地图变量的值 在 sass 中,我们可以使用地图变量来存储一组键值对。而有时候,我们可能需要直接访问其中的某个值。 可以通过 map-get 函数直接从地图中获取特定的值。语法如下: map-get($map, $key) 其中: $map 是我们要获取值的 sass 地图变量。…

    2025年12月24日
    000
  • CSS 砌体 Catness

    css 就像技术中的其他东西一样 – 它总是在变化和发展。该领域正在进行的开发是 css 网格布局模块级别 3,也称为 css masonry 布局。 theo 制作了一段视频,介绍了它的开发方式以及苹果和谷歌就如何实施它进行的辩论。 所有这些让我很高兴尝试 css 砌体! webkit…

    好文分享 2025年12月24日
    000
  • 我如何编写 CSS 选择器

    CSS 方法有很多,但我都讨厌它们。有些多(顺风等),有些少(BEM、OOCSS 等)。但归根结底,它们都有缺陷。 当然,人们使用这些方法有充分的理由,并且解决的许多问题我也遇到过。因此,在这篇文章中,我想写下我自己的关于如何保持 CSS 井井有条的指南。 这并不是一个任何人都可以开始使用的完整描述…

    2025年12月24日
    000
  • 展望响应式布局的未来发展方向及前景

    随着移动设备的普及和互联网的快速发展,网页设计和开发领域也随之发生了巨大变化。在过去,设计师需要为不同的设备和屏幕尺寸创建多个版本的网页。然而,随着响应式布局的出现,这一挑战逐渐得到了解决。 响应式布局是一种网页设计和开发的方法,能够根据用户使用的设备和屏幕尺寸自动调整网页的布局和内容,以达到最佳浏…

    2025年12月24日
    000
  • 为什么前端固定定位会发生移动问题?

    前端固定定位为什么会出现移动现象? 在进行前端开发时,我们经常会使用CSS中的position属性来控制元素的定位。其中,固定定位(position: fixed)是一种常用的定位方式,它可以让元素相对于浏览器窗口进行定位,保持在页面的固定位置不动。 然而,有时候我们会遇到一个问题:在使用固定定位时…

    2025年12月24日
    000
  • 深入探讨前端开发中回流和重绘的重要性

    【标题】探索回流和重绘在前端开发中的关键作用 【导语】回流(reflow)和重绘(repaint)是前端开发中非常重要的概念,对于优化网页性能和提升用户体验有着至关重要的作用。本文将深入探讨回流和重绘的定义和原因,并结合具体的代码示例,让读者更好地理解它们在前端开发中的关键作用。 【正文】 一、回流…

    2025年12月24日
    000
  • CSS中绝对定位属性的解析与其在前端开发中的应用

    解析绝对定位属性 CSS 的特性及其在前端开发中的应用 一、绝对定位属性 CSS 的特性 绝对定位是 CSS 中常用的定位方式之一,它可以让元素脱离普通文档流,并通过指定的偏移量相对于包含它的父元素或根元素进行定位。绝对定位属性具有以下几个特性: 脱离文档流:绝对定位的元素脱离了普通文档流,不再占据…

    2025年12月24日 好文分享
    000
  • 前端开发中的应用与实践:使用Ajax函数

    Ajax函数在前端开发中的应用与实践 随着Web应用的快速发展,前端开发变得越来越重要。而Ajax作为一种前端开发技术,能够实现无需刷新页面的数据交互,成为了前端开发中不可或缺的工具。本文将介绍Ajax函数的基本原理,以及在前端开发中的应用与实践,并提供具体的代码示例。 Ajax函数的基本原理Aja…

    2025年12月24日
    000
  • 从初学到专业:掌握这五种前端CSS框架

    CSS是网站设计中重要的一部分,它控制着网站的外观和布局。前端开发人员为了让页面更加美观和易于使用,通常使用CSS框架。这篇文章将带领您了解这五种前端CSS框架,从入门到精通。 Bootstrap Bootstrap是最受欢迎的CSS框架之一。它由Twitter公司开发,具有可定制的响应式网格系统、…

    2025年12月24日
    200
  • 克服害怕做选择的恐惧症:这五个前端CSS框架将为你解决问题

    选择恐惧症?这五个前端CSS框架能帮你解决问题 近年来,前端开发者已经进入了一个黄金时代。随着互联网的快速发展,人们对于网页设计和用户体验的要求也越来越高。然而,要想快速高效地构建出漂亮的网页并不容易,特别是对于那些可能对CSS编码感到畏惧的人来说。所幸的是,前端开发者们早已为我们准备好了一些CSS…

    2025年12月24日
    200
  • 深入理解CSS框架与JS之间的关系

    深入理解CSS框架与JS之间的关系 在现代web开发中,CSS框架和JavaScript (JS) 是两个常用的工具。CSS框架通过提供一系列样式和布局选项,可以帮助我们快速构建美观的网页。而JS则提供了一套功能强大的脚本语言,可以为网页添加交互和动态效果。本文将深入探讨CSS框架和JS之间的关系,…

    2025年12月24日
    000
  • 项目实践:如何结合CSS和JavaScript打造优秀网页的经验总结

    项目实践:如何结合CSS和JavaScript打造优秀网页的经验总结 随着互联网的快速发展,网页设计已经成为了各行各业都离不开的一项技能。优秀的网页设计可以给用户留下深刻的印象,提升用户体验,增加用户的黏性和转化率。而要做出优秀的网页设计,除了对美学的理解和创意的运用外,还需要掌握一些基本的技能,如…

    2025年12月24日
    200
  • 前端开发必备:掌握CSS技巧的项目经验分享

    前端开发是近年来非常热门的职业方向之一,随着互联网的发展和技术的进步,前端开发人员的需求也越来越大。在前端开发中,掌握CSS技巧是非常重要的一部分,能够让网页呈现出更好的视觉效果和用户体验。本文将分享一些我在项目经验中学到的CSS技巧,希望对正在学习或者即将从事前端开发的同学有所帮助。 首先,我想分…

    2025年12月24日
    000
  • is与where选择器:提升前端编程效率的秘密武器

    is与where选择器:提升前端编程效率的秘密武器 在前端开发中,选择器是一种非常重要的工具。它们用于选择文档中的元素,从而对其进行操作和样式设置。随着前端技术的不断发展,选择器也在不断演化。而其中,is与where选择器成为了提升前端编程效率的秘密武器。 is选择器是CSS Selectors L…

    2025年12月24日
    000

发表回复

登录后才能评论
关注微信