TypeScript装饰器详解:类、属性、方法及参数装饰器的实现与用法

作者:代码拾荒

时间:2026-10-26

浏览:181

本文深入解析TypeScript中的装饰器机制,涵盖类、属性、方法及参数四种核心装饰器的定义与调用时机。通过普通装饰器与装饰器工厂的对比,展示如何扩展类行为、修改属性描述符及拦截参数。结合具体代码示例,阐明装饰器在ES7标准下的应用,帮助开发者掌握动态修改类结构的高级技巧。

文章目录

一、装饰器

装饰器属于一种特殊的声明形式,可附加至类声明、方法、属性或参数之上,进而改变类的运行行为。简而言之,装饰器即一种注入式方法,用于拓展类、属性、方法或参数的功能。常见的装饰器类型包括类装饰器、属性装饰器、方法装饰器以及参数装饰器。在书写方式上,主要分为无法传参的普通装饰器和支持传参的装饰器工厂两种形式。

作为过去几年JavaScript领域最重要的成就之一,装饰器已被纳入ES7标准特性。

二、类装饰器:

类装饰器在类声明之前被声明(紧靠着类声明)。

类装饰器应用于类构造函数,可以用来监视,修改或替换类定义。 传入一个参数

1、 类装饰器:普通装饰器(无法传参)

function logClass(params: any) {

    console.log(params);
    // params 就是当前类
    params.prototype.apiUrl = '动态扩展的属性';
    params.prototype.run = function () {
        console.log('我是一个run方法');
    }

}

@logClass
class HttpClient {
    constructor() {
    }
    getData() {

    }
}
var http: any = new HttpClient();
console.log(http.apiUrl);
http.run();

2、 类装饰器:装饰器工厂(可传参)

function logClass(params: string) {
    return function (target: any) {
        console.log(target);
        console.log(params);
        target.prototype.apiUrl = params;
    }
}

@logClass('http://www.itying.com/api')
class HttpClient {
    constructor() {
    }

    getData() {

    }
}

var http: any = new HttpClient();
console.log(http.apiUrl);

下面是一个用类装饰器重载构造函数的例子。

类装饰器表达式会在运行时当作函数被调用,类的构造函数作为其唯一的参数。

如果类装饰器返回一个值,它会使用提供的构造函数来替换类的声明。

function logClass(target: any) {
    console.log(target);
    return class extends target {
        apiUrl: any = '我是修改后的数据';
        getData() {
            this.apiUrl = this.apiUrl + '----';
            console.log(this.apiUrl);
        }
    }
}


@logClass
class HttpClient {
    public apiUrl: string | undefined;
    constructor() {
        this.apiUrl = '我是构造函数里面的apiUrl';
    }
    getData() {
        console.log(this.apiUrl);
    }
}

var http = new HttpClient();
http.getData();

三、属性装饰器

属性装饰器表达式会在运行时当作函数被调用,传入下列2个参数: 1、对于静态成员来说是类的构造函数,对于实例成员是类的原型对象。 2、成员的名字。

//类装饰器
function logClass(params: string) {
    return function (target: any) {
        // console.log(target);
        // console.log(params);       

    }
}

//属性装饰器
function logProperty(params: any) {
    return function (target: any, attr: any) {
        console.log(target);
        console.log(attr);
        target[attr] = params;
    }
}
@logClass('xxxx')
class HttpClient {
    @logProperty('http://itying.com')
    public url: any | undefined;
    constructor() {
    }
    getData() {
        console.log(this.url);
    }
}
var http = new HttpClient();
http.getData();

四、方法装饰器

它会被应用到方法的 属性描述符上,可以用来监视,修改或者替换方法定义。

方法装饰会在运行时传入下列3个参数: 1、对于静态成员来说是类的构造函数,对于实例成员是类的原型对象。 2、成员的名字。 3、成员的属性描述符。

五、方法参数装饰器

参数装饰器表达式会在运行时当作函数被调用,传入下列3个参数:

1、对于静态成员来说是类的构造函数,对于实例成员是类的原型对象。 2、参数的名字。 3、参数在函数参数列表中的索引。

到此这篇关于TypeScript装饰器的文章就介绍到这了。希望对大家的学习有所帮助,也希望大家多多支持本站。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章