写点什么

从 0 开始的 TypeScriptの十二:装饰器

用户头像
空城机
关注
发布于: 4 小时前
从0开始的TypeScriptの十二:装饰器

装饰器/修饰器 Decorator

定义:装饰器是一种特殊类型的声明,能够被附加到类的声明、方法、属性或参数上,可以修改类的属性


通俗的讲装饰器就是一个方法:可以注入到类、方法、属性参数上来扩展类、属性、方法、参数的功能。装饰器是实现 AOP(面向切面)编程的一种重要方式。


通过注入的对象不同,可以将装饰器分为:


  • 类装饰器

  • 类属性装饰器

  • 类方法装饰器

  • 类方法参数装饰器


装饰器的写法:


  • 普通装饰器(无法传参)

  • 装饰器工厂(可传参)


装饰器目前已经是ES7的标准特性之一了,但是在使用时需要用Babel进行转换,或者在tsconfig.json编译选项中打开experimentalDecorators,然后使用tsc进行编译


"experimentalDecorators": true // 启用对 ES7 装饰器的实验性支持


参考:《阮一峰ECMAScript6入门教程 -- 修饰器》




类装饰器

类装饰器:类装饰器在类声明前被声明(紧靠着类声明),是一个对类进行处理的函数


类装饰器应用于类构造函数,可以用了见识,修改或替换类定义。类装饰器表达式会在运行时被当作函数调用,类的构造函数是其唯一的参数(对于装饰器)

普通装饰器

定义一个普通装饰器Decorator普通装饰器不能传参


虽然在Decorator方法定义时有参数,但是在调用装饰器时不需要传参,因为参数params其实是之后要修饰的类class

function Decorator(params: any) {    console.log(params);    // 给类添加原型链属性    params.prototype.color = '#f00'}
复制代码


使用修饰方法是在类上一行添加@装饰器名

@Decoratorclass Animal {    constructor() {    }}
复制代码


如果想传参就会有错误提示:![节点](./../noteMd/img/普通装饰器传参.png]


现在把使用了装饰器的类进行实例生成:

let animal:any = new Animal();console.log(animal);
复制代码


生成的animal__proto__就存在装饰器赋予的 color 属性了


装饰器工厂

上面的普通装饰器使用时不能传参,但是可以使用装饰器工厂定义来进行传参。


装饰器工厂其实可以理解为:在装饰器外部再封装一个函数,外部函数可以传入参数,内部才是真正的装饰器


装饰器工厂:使用时可传入参数,下面把参数赋给params,把类赋给target。并且在使用时也可以只用(),内部不传参数


像下面的例子中,其实就是对两个装饰器进行判断,外部其实是一个传入参数的函数

function Decorator2(...params: string[]) {    if (params.length > 2) {        return (target:any):void=>{            target.prototype.color = params;        }    } else {        return (target:any):void=>{            target.prototype.color = params[0];        }    }}
复制代码


类:

@Decorator2('#f00', '#0f0', '#00f')class Time {    constructor() {    }}let time0 = new Time();console.log(time0);
复制代码



装饰器重构构造函数

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


下面构造器中,返回的是class extends target。 这样look属性和Look()方法都被重新修改了,实例也是使用的重构后的方法和属性


function Decorator3(target: any) {    return class extends target{        look = '修改数据';        Look() {            console.log('123');        }    }}@Decorator3class Doing {    look: string;    constructor(look:string) {        this.look = look;    }    Look() {        console.log(this.look);    }}
let done = new Doing('正在看什么');console.log(done.look); // 修改数据done.Look(); // 123
复制代码




类属性装饰器

属性装饰器表达式徽章运行时当函数被调用,传入两个参数:


  • 对静态成员是类的构造函数,对实例成员是类的原型对象

  • 成员的名字


下面例子中,第一个target会打印constructor构造函数,第二个attr会打印bed。然后将bed修改为草席,这样实例中的 bed 就会统一变成草席

function Decorator4(target:any, attr:any) {    console.log(target);    console.log(attr);    target[attr] = '草席'}class Sleep {    @Decorator4    bed: string|undefined;}let sleep = new Sleep();console.log(sleep.bed);
复制代码





类方法装饰器

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


方法装饰器在运行是时传入三种参数:


  • 对静态成员是类的构造函数,对实例成员是类的原型对象

  • 成员的名字

  • 成员的属性描述符


方法装饰器:

function Decorator5(target:any, attr:any, desc:any) {    console.log(target);    console.log(attr);    console.log(desc);}
复制代码


在类的方法上进行使用:

class Doing {    constructor() {    }    @Decorator5    Look():void {        console.log(123);    }}
复制代码


打印的结果(这里在使用时,我使用了webpack打包后的 js):


在属性描述符中有下面的内容:


  • configurable:当且仅当该属性的 configurable 键值为 true 时,该属性的描述符才能够被改变,同时该属性也能从对应的对象上被删除。默认为 false。

  • enumerable:当且仅当该属性的 enumerable 键值为 true 时,该属性才会出现在对象的枚举属性中。默认为 false。

  • value:该属性对应的值。可以是任何有效的 JavaScript 值(数值,对象,函数等)。默认为 undefined。

  • writable:当且仅当该属性的 writable 键值为 true 时,属性的值,也就是上面的 value,才能被赋值运算符 (en-US)改变。默认为 false。


如果要使用方法装饰器修改当前方法,主要就是使用desc的内容。当前方法其实是descvalue


例子:方法装饰器修改当前方法,并且原方法继续执行

function Decorator5(target:any, attr:any, desc:any) {    let oldmethod = desc.value;    desc.value = function(...args:string[]){        console.log(args);        oldmethod.apply(this, args)    }}
复制代码




类方法参数装饰器

参数装饰器汇总运行时当作函数调用,传入三个参数:


  • 对静态成员是类的构造函数,对实例成员是类的原型对象

  • 方法的名字

  • 参数在函数参数列表中的索引


例子:

function Decorator6(target:any, attr:any, index:any) {    console.log(target);    console.log(attr);    console.log(index);}
复制代码


在调用时写入方法的()

Look(@Decorator6 ...args:string[]):void {    console.log(123);}
复制代码


输出:


发布于: 4 小时前阅读数: 9
用户头像

空城机

关注

曾经沧海难为水,只是当时已惘然 2021.03.22 加入

业余作者,在线水文 主要干前端的活,业余会学学python 欢迎各位关注,互相学习,互相进步

评论

发布
暂无评论
从0开始的TypeScriptの十二:装饰器