资讯专栏INFORMATION COLUMN

从ES6重新认识JavaScript设计模式: 装饰器模式

wendux / 628人阅读

摘要:什么是装饰器模式向一个现有的对象添加新的功能,同时又不改变其结构的设计模式被称为装饰器模式,它是作为现有的类的一个包装。中的装饰器模式中有一个的提案,使用一个以开头的函数对中的及其属性方法进行修饰。

1 什么是装饰器模式

向一个现有的对象添加新的功能,同时又不改变其结构的设计模式被称为装饰器模式(Decorator Pattern),它是作为现有的类的一个包装(Wrapper)。

可以将装饰器理解为游戏人物购买的装备,例如LOL中的英雄刚开始游戏时只有基础的攻击力和法强。但是在购买的装备后,在触发攻击和技能时,能够享受到装备带来的输出加成。我们可以理解为购买的装备给英雄的攻击和技能的相关方法进行了装饰。

这里推荐一篇淘宝前端团队的博文,很有趣的以钢铁侠的例子来讲解了装饰者模式。

2 ESnext中的装饰器模式

ESnext中有一个Decorator的提案,使用一个以 @ 开头的函数对ES6中的class及其属性、方法进行修饰。Decorator的详细语法请参考阮一峰的《ECMASciprt入门 —— Decorator》。

目前Decorator的语法还只是一个提案,如果期望现在使用装饰器模式,需要安装配合babel + webpack并结合插件实现。

npm安装依赖

npm install babel-core babel-loader babel-plugin-transform-decorators babel-plugin-transform-decorators-legacy babel-preset-env

配置.babelrc文件

{
  "presets": ["env"],
  "plugins": ["transform-decorators-legacy"]
}

webpack.config.js中添加babel-loader

  module: {
    rules: [
      { test: /.js$/, exclude: /node_modules/, loader: "babel-loader" }
    ],
  }

如果你使用的IDE为Visual Studio Code,可能还需要在项目根目录下添加以下tsconfig.json文件来组织一个ts检查的报错。

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "allowJs": true,
    "lib": [
      "es6"
    ],
  }
}

下面我将实现3个装饰器,分别为@autobind@debounce@deprecate

2.1 @autobind实现this指向原对象

在JavaScript中,this的指向问题一直是一个老生常谈的话题,在Vue或React这类框架的使用过程中,新手很有可能一不小心就丢失了this的指向导致方法调用错误。例如下面一段代码:

class Person {
  getPerson() {
    return this;
  }
}

let person = new Person();
let { getPerson } = person;

console.log(getPerson() === person); // false

上面的代码中, getPerson方法中的this默认指向Person类的实例,但是如果将Person通过解构赋值的方式提取出来,那么此时的this指向为undefined。所以最终的打印结果为false

此时我们可以实现一个autobind的函数,用来装饰getPerson这个方法,实现this永远指向Person的实例。

function autobind(target, key, descriptor) {
  var fn = descriptor.value;
  var configurable = descriptor.configurable;
  var enumerable = descriptor.enumerable;

  // 返回descriptor
  return {
    configurable: configurable,
    enumerable: enumerable,
    get: function get() {
      // 将该方法绑定this
      var boundFn = fn.bind(this);
      // 使用Object.defineProperty重新定义该方法
      Object.defineProperty(this, key, {
        configurable: true,
        writable: true,
        enumerable: false,
        value: boundFn
      })

      return boundFn;
    }
  }
}

我们通过bind实现了this的绑定,并在get中利用Object.defineProperty重写了该方法,将value定义为通过bind绑定后的函数boundFn,以此实现了this永远指向实例。下面我们为getPerson方法加上装饰并调用。

class Person {
  @autobind
  getPerson() {
    return this;
  }
}

let person = new Person();
let { getPerson } = person;

console.log(getPerson() === person); // true
2.2 @debounce实现函数防抖

函数防抖(debounce)在前端项目中有着很多的应用,例如在resizescroll等事件中操作DOM,或对用户输入实现实时ajax搜索等会被高频的触发,前者会对浏览器性能产生直观的影响,后者会对服务器产生较大的压力,我们期望这类高频连续触发的事件在触发结束后再做出响应,这就是函数防抖的应用。

class Editor {
  constructor() {
    this.content = "";
  }

  updateContent(content) {
    console.log(content);
    this.content = content;
    // 后面有一些消耗性能的操作
  }
}

const editor1 = new Editor();
editor1.updateContent(1);
setTimeout(() => { editor1.updateContent(2); }, 400);


const editor2= new Editor();
editor2.updateContent(3);
setTimeout(() => { editor2.updateContent(4); }, 600);

// 打印结果: 1 3 2 4

上面的代码中我们定义了Editor这个类,其中updateContent方法会在用户输入时执行并可能有一些消耗性能的DOM操作,这里我们在该方法内部打印了传入的参数以验证调用过程。可以看到4次的调用结果分别为1 3 2 4

下面我们实现一个debounce函数,该方法传入一个数字类型的timeout参数。

function debounce(timeout) {
  const instanceMap = new Map(); // 创建一个Map的数据结构,将实例化对象作为key

  return function (target, key, descriptor) {

    return Object.assign({}, descriptor, {
      value: function value() {

        // 清除延时器
        clearTimeout(instanceMap.get(this));
        // 设置延时器
        instanceMap.set(this, setTimeout(() => {
          // 调用该方法
          descriptor.value.apply(this, arguments);
          // 将延时器设置为 null
          instanceMap.set(this, null);
        }, timeout));
      }
    })
  }
}

上面的方法中,我们采用了ES6提供的Map数据结构去实现实例化对象和延时器的映射。在函数的内部,首先清除延时器,接着设置延时执行函数,这是实现debounce的通用方法,下面我们来测试一下debounce装饰器。

class Editor {
  constructor() {
    this.content = "";
  }

  @debounce(500)  
  updateContent(content) {
    console.log(content);
    this.content = content;
  }
}

const editor1 = new Editor();
editor1.updateContent(1);
setTimeout(() => { editor1.updateContent(2); }, 400);


const editor2= new Editor();
editor2.updateContent(3);
setTimeout(() => { editor2.updateContent(4); }, 600);

//打印结果: 3 2 4

上面调用了4次updateContent方法,打印结果为3 2 41由于在400ms内被重复调用而没有被打印,这符合我们的参数为500的预期。

2.3 @deprecate实现警告提示

在使用第三方库的过程中,我们会时不时的在控制台遇见一些警告,这些警告用来提醒开发者所调用的方法会在下个版本中被弃用。这样的一行打印信息也许我们的常规做法是在方法内部添加一行代码即可,这样其实在源码阅读上并不友好,也不符合单一职责原则。如果在需要抛出警告的方法前面加一个@deprecate的装饰器来实现警告,会友好得多。

下面我们来实现一个@deprecate的装饰器,其实这类的装饰器也可以扩展成为打印日志装饰器@log,上报信息装饰器@fetchInfo等。

function deprecate(deprecatedObj) {

  return function(target, key, descriptor) {
    const deprecatedInfo = deprecatedObj.info;
    const deprecatedUrl = deprecatedObj.url;
    // 警告信息
    const txt = `DEPRECATION ${target.constructor.name}#${key}: ${deprecatedInfo}. ${deprecatedUrl ? "See "+ deprecatedUrl + " for more detail" : ""}`;
    
    return Object.assign({}, descriptor, {
      value: function value() {
        // 打印警告信息
        console.warn(txt);
        descriptor.value.apply(this, arguments);
      }
    })
  }
}

上面的deprecate函数接受一个对象参数,该参数分别有infourl两个键值,其中info填入警告信息,url为选填的详情网页地址。下面我们来为一个名为MyLib的库的deprecatedMethod方法添加该装饰器吧!

class MyLib {
  @deprecate({
    info: "The methods will be deprecated in next version", 
    url: "http://www.baidu.com"
  })
  deprecatedMethod(txt) {
    console.log(txt)
  }
}

const lib = new MyLib();
lib.deprecatedMethod("调用了一个要在下个版本被移除的方法");
// DEPRECATION MyLib#deprecatedMethod: The methods will be deprecated in next version. See http://www.baidu.com for more detail
// 调用了一个要在下个版本被移除的方法
3 总结

通过ESnext中的装饰器实现装饰器模式,不仅有为类扩充功能的作用,而且在阅读源码的过程中起到了提示作用。上面所举到的例子只是结合装饰器的新语法和装饰器模式做了一个简单封装,请勿用于生产环境。如果你现在已经体会到了装饰器模式的好处,并想在项目中大量使用,不妨看一下core-decorators这个库,其中封装了很多常用的装饰器.

参考文献

IMWeb的前端博客:浅谈JS中的装饰器模式

淘宝前端团队:ES7 Decorator 装饰者模式

阮一峰:ECMAScript 6 入门

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/96841.html

相关文章

  • 装饰模式的应用:react高阶组件和ES6 装饰

    摘要:装饰者模式参与者装饰者和被装饰者共同的父类,是一个接口或者抽象类,用来定义基本行为定义具体对象,即被装饰者抽象装饰者,继承自,从外类来扩展。三装饰器高阶组件可以看做是装饰器模式在的实现。 一 装饰者模式 优先使用对象组合而不是类继承。 --《设计模式》 1.什么是装饰者模式 定义:动态的给对象添加一些额外的属性或行为。相比于使用继承,装饰者模式更加灵活。 2.装饰者模式参与者 Co...

    YuboonaZhang 评论0 收藏0
  • 设计模式(通往高手之路的必备技能)

    摘要:设计模式的定义在面向对象软件设计过程中针对特定问题的简洁而优雅的解决方案。从前由于使用的局限性,和做的应用相对简单,不被重视,就更谈不上设计模式的问题。 ‘从大处着眼,从小处着手’,以前对这句话一知半解,自从踏出校门走入社会,开始工作以来,有了越来越深的理解,偶有发现这句话用在程序开发中也有用,所以,近段时间开始尝试着分析jQuery源码,分析angularjs源码,学习设计模式。 设...

    paraller 评论0 收藏0
  • 每天一个设计模式装饰模式

    摘要:作者按每天一个设计模式旨在初步领会设计模式的精髓,目前采用和两种语言实现。诚然,每种设计模式都有多种实现方式,但此小册只记录最直截了当的实现方式原文地址是每天一个设计模式之装饰者模式欢迎关注个人技术博客。 作者按:《每天一个设计模式》旨在初步领会设计模式的精髓,目前采用javascript和python两种语言实现。诚然,每种设计模式都有多种实现方式,但此小册只记录最直截了当的实现方式...

    brianway 评论0 收藏0
  • 每天一个设计模式装饰模式

    摘要:作者按每天一个设计模式旨在初步领会设计模式的精髓,目前采用和两种语言实现。诚然,每种设计模式都有多种实现方式,但此小册只记录最直截了当的实现方式原文地址是每天一个设计模式之装饰者模式欢迎关注个人技术博客。 作者按:《每天一个设计模式》旨在初步领会设计模式的精髓,目前采用javascript和python两种语言实现。诚然,每种设计模式都有多种实现方式,但此小册只记录最直截了当的实现方式...

    shleyZ 评论0 收藏0

发表评论

0条评论

wendux

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<