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月11日 13:59:55

相关推荐

  • 深入理解 V8 Isolate::Scope:管理线程与 V8 隔离区的关键

    本文深入探讨了 v8 引擎中 `v8::isolate::scope` 的核心作用及其生命周期管理。通过分析一个常见的崩溃案例,我们阐明了 `isolate::scope` 如何确保 v8 操作在正确的隔离区上下文中执行,并强调了在每个需要与 v8 交互的线程上下文正确创建和管理作用域的重要性,以避…

    好文分享 2025年12月20日
    000
  • 在HTML表格中为动态生成元素实现星级评分功能

    本文档旨在解决在动态生成的HTML表格中,为每个元素实现独立的星级评分功能的问题。通过修改JavaScript代码,确保每个事件的评分选项具有唯一的ID和名称,从而避免评分冲突,实现对每个表格行中元素的独立评分。本文将提供修改后的代码和详细的解释,帮助开发者轻松实现这一功能。 问题分析 在动态生成的…

    好文分享 2025年12月20日
    000
  • JavaScript URL 构建:解决 Base URL 路径被剥离的问题

    本文旨在解决在使用 JavaScript `URL` 构造函数时,由于相对路径和 Base URL 格式不正确导致的路径剥离问题。我们将深入探讨 `URL` 构造函数的行为,并提供明确的解决方案,确保生成的 URL 包含预期的 Base URL 路径和查询参数。通过本文的学习,开发者可以避免常见的 …

    2025年12月20日
    000
  • Ajv URI 格式校验深度解析:理解其基于 RFC3986 的行为

    本文深入探讨 ajv 库在进行 `uri` 格式校验时的行为。通过分析一个常见疑问——为何 `https://a.=.c` 这样的字符串会被 ajv 判定为有效 uri,我们揭示了 ajv 的 `uri` 格式校验严格遵循 rfc3986 规范。文章将提供代码示例,并解释 rfc3986 对 uri…

    2025年12月20日
    000
  • 在React中集成jQuery插件:为何需要DOM元素包装器

    1. 引言:React与DOM操作的挑战 React通过其虚拟DOM和高效的协调(reconciliation)算法来管理用户界面,它鼓励开发者以声明式的方式构建UI,而不是直接操作DOM。然而,在实际项目中,我们有时需要集成一些历史悠久或功能强大的第三方库,尤其是那些直接操作DOM的jQuery插…

    2025年12月20日
    000
  • 创建富文本编辑器:execCommand的替代方案探讨

    本文探讨了在创建富文本编辑器时,`document.execCommand`被弃用后的替代方案。尽管`execCommand`已被标记为弃用,但由于其在富文本编辑领域的广泛应用和浏览器依赖性,它仍然是目前实现WYSIWYG编辑器最便捷的方法。本文将分析`execCommand`的现状,并展望未来可能…

    2025年12月20日
    000
  • 使用 React 的 map() 函数实现列表渲染并换行显示的正确方法

    本文旨在解决 React 中使用 `map()` 函数渲染列表时,元素没有换行显示的问题。通过分析原因和提供正确的代码示例,帮助开发者理解如何利用 `useEffect` hook 和一次性更新状态来高效地渲染列表,并确保每个元素都显示在新的一行。 在 React 中,我们经常需要使用 map() …

    2025年12月20日
    000
  • JavaScript 数组原地反转教程:理解与实现

    本教程深入探讨javascript数组的原地反转操作。我们将解析初学者常犯的错误,即混淆创建新数组与修改原始数组的区别。文章将介绍使用`array.prototype.reverse()`这一内置方法实现原地反转,并详细讲解如何通过双指针交换算法手动实现高效的原地反转,同时强调了`@return {…

    2025年12月20日
    000
  • 如何优雅地更新大型HTML元素的内容?

    本教程旨在解决在Web开发中,如何更清晰、更高效地更新大型HTML元素内容的问题。通过将内容分割成独立的HTML文件,并利用JavaScript的AJAX技术动态加载,可以避免在JavaScript代码中嵌入大量HTML代码,提高代码的可维护性和可读性。本文将详细介绍具体实现步骤,并提供示例代码,帮…

    2025年12月20日
    000
  • JavaScript 数组原地反转的实现与注意事项

    本文深入探讨 javascript 中数组反转的多种方法,重点区分原地修改与创建新数组的实现策略。我们将分析 `void` 返回类型在函数设计中的意义,介绍 `array.prototype.reverse()` 等内置方法,并详细讲解如何手动实现高效的原地反转算法,同时提及 `array.prot…

    2025年12月20日
    000
  • 如何利用Web Components技术创建可复用的自定义HTML元素?

    Web Components 通过自定义元素、影子 DOM 和 HTML 模板实现可复用、封装良好的独立组件。1. 使用 customElements.define() 注册带连字符的自定义标签;2. 类继承 HTMLElement 定义行为;3. 在构造函数中用 this.attachShadow…

    2025年12月20日
    000
  • 在动态生成的HTML表格中实现星级评分

    本文档旨在解决在动态生成的HTML表格中实现星级评分时遇到的问题,重点讲解如何确保每个表格行中的星级评分组件独立工作,互不影响。通过修改HTML元素的id和name属性,使每个评分组件具有唯一标识符,从而实现独立评分功能。 问题分析 在动态生成的HTML表格中,如果每个表格行中的星级评分组件的 id…

    2025年12月20日
    000
  • 在Node.js中访问和修改CSS规则:JSDOM与CSS AST解析

    在node.js环境中处理css规则不同于浏览器dom操作。本文将介绍两种主要方法:一是利用jsdom模拟浏览器环境,实现对`document.stylesheets`等dom api的访问;二是采用csstree库进行css抽象语法树(ast)解析,实现对css内容的深度分析、转换与生成。这两种方…

    2025年12月20日
    000
  • 如何在客户端安全地创建 Stripe Payment Link

    本文探讨了在纯静态网站环境下,如何在不暴露 Stripe Secret Key 的前提下,动态生成 Stripe Payment Link 的问题。由于 Stripe API 的安全机制限制,直接在客户端创建 Payment Link 存在安全风险。本文提供了两种替代方案:预先生成固定 Paymen…

    2025年12月20日
    000
  • JavaScript地理信息系统

    JavaScript GIS利用Web技术实现地图展示与空间分析,主流库包括Leaflet、OpenLayers、Mapbox GL JS和Google Maps API,支持地图加载、标记添加、GeoJSON渲染、交互操作及后端集成,可结合React、Vue等框架应用于城市规划、物流追踪、环境监测…

    2025年12月20日
    000
  • 如何在HTML文件中添加图片(Flask应用)

    本文旨在指导开发者如何在Flask框架下,正确地在HTML文件中嵌入本地图片。通过调整项目目录结构,并使用正确的路径引用方式,确保图片能够成功显示在网页上。本文将提供详细步骤和示例代码,助你解决图片显示问题。 在使用Flask框架开发Web应用时,经常需要在HTML页面中展示图片。如果图片文件位于本…

    2025年12月20日 好文分享
    000
  • JavaScript WebRTC实时通信开发

    WebRTC通过RTCPeerConnection、RTCDataChannel和getUserMedia实现浏览器间音视频通话与数据传输,需借助信令服务器交换SDP和ICE信息,完成点对点连接后即可传输媒体流或文本文件。 WebRTC(Web Real-Time Communication)是一项…

    2025年12月20日
    000
  • JavaScript地理定位服务开发

    JavaScript地理定位通过Geolocation API获取用户位置,需用户授权并在HTTPS环境下运行;使用getCurrentPosition()获取当前位置,watchPosition()持续监听位置变化,需处理用户拒绝、信号弱或超时等错误,并合理调用clearWatch()停止监听以节…

    2025年12月20日
    000
  • 前端自动化测试架构设计

    前端自动化测试架构需分层覆盖单元、组件、E2E和视觉回归测试,采用Vitest、Playwright等工具统一配置,集成CI/CD实现覆盖率报告与结果追踪,并通过页面对象模型、data-testid定位及定期维护提升可维护性。 前端自动化测试架构设计的核心是确保代码质量、提升开发效率,并在持续集成流…

    2025年12月20日
    000
  • JavaScript WebAssembly交互机制

    JavaScript 与 WebAssembly 通过共享内存、函数调用和数据传递实现高效协作:JS 调用 WASM 导出函数处理高性能任务,WASM 借助导入的 JS 函数操作 DOM;两者通过线性内存交换复杂数据,如字符串以 UTF-8 编码存入共享 ArrayBuffer,由指针定位并用 Te…

    2025年12月20日
    000

发表回复

登录后才能评论
关注微信