ECMAScript 6(七)

Proxy & Reflect

Posted by     "Jordon Li" on Monday, December 23, 2019

TOC

ECMAScript 6 简介

ECMAScript 6.0(以下简称 ES6)是 JavaScript 语言的下一代标准,已经在 2015 年 6 月正式发布了。它的目标,是使得 JavaScript 语言可以用来编写复杂的大型应用程序,成为企业级开发语言。

Proxy

Proxy

  • 基本用法: Proxy 用于修改某些操作的默认行为,等同于在语言层面做出修改,所以属于一种“元编程”(meta programming),即对编程语言进行编程。 Proxy 可以理解成,在目标对象之前架设一层“拦截”,外界对该对象的访问,都必须先通过这层拦截,因此提供了一种机制,可以对外界的访问进行过滤和改写。
    //Proxy 构造函数
    var proxy = new Proxy(target, handler);
    

target参数表示所要拦截的目标对象,handler参数也是一个对象,用来定制拦截行为。

//example
var obj = new Proxy({}, {
  get: function (target, propKey, receiver) {
    console.log(`getting ${propKey}!`);
    return Reflect.get(target, propKey, receiver);
  },
  set: function (target, propKey, value, receiver) {
    console.log(`setting ${propKey}!`);
    return Reflect.set(target, propKey, value, receiver);
  }
});

Proxy.revocable()

  • 基本用法: Proxy.revocable方法返回一个可取消的 Proxy 实例。
    let target = {};
    let handler = {};
    
    let {proxy, revoke} = Proxy.revocable(target, handler);
    
    proxy.foo = 123;
    proxy.foo 
    // 123
    
    revoke(); //取消Proxy实例
    proxy.foo 
    // TypeError: Revoked
    

实例方法(支持的拦截handler)

get(target, propKey, receiver)

  • 基本用法: get方法用于拦截某个属性的读取操作,可以接受三个参数: 目标对象(target)、属性名(propKey)和 proxy 实例本身(严格地说,是操作行为所针对的对象)(receiver可选)。
    var person = {
      name: "张三"
    };
    
    var proxy = new Proxy(person, {
      get: function(target, propKey) {
        if (propKey in target) {
          return target[propKey];
        } else {
          throw new ReferenceError("Prop name \"" + propKey + "\" does not exist.");
        }
      }
    });
    
    proxy.name // "张三"
    proxy.age // 抛出一个错误
    

set(target, propKey, value, receiver)

  • 基本用法: set方法用来拦截某个属性的赋值操作,可以接受四个参数: 目标对象(target)、属性名(propKey)、属性值(value)和 Proxy 实例本身(receiver可选)。
    let validator = {
      set: function(obj, prop, value) {
        if (prop === 'age') {
          if (!Number.isInteger(value)) {
            throw new TypeError('The age is not an integer');
          }
          if (value > 200) {
            throw new RangeError('The age seems invalid');
          }
        }
    
        // 对于满足条件的 age 属性以及其他属性,直接保存
        obj[prop] = value;
      }
    };
    
    let person = new Proxy({}, validator);
    

apply(target, object, args)

  • 基本用法: apply方法拦截函数的调用(invoke)、callapply操作,可以接受三个参数: 目标对象(target)、目标对象的上下文对象(this)和目标对象的参数数组(args)。
      var twice = {
        apply (target, ctx, args) {
          return Reflect.apply(...arguments) * 2;
        }
      };
      function sum (left, right) {
        return left + right;
      };
      var proxy = new Proxy(sum, twice);
      proxy(1, 2) // 6
      proxy.call(null, 5, 6) // 22
      proxy.apply(null, [7, 8]) // 30
    

has(target, propKey)

  • 基本用法: has方法用来拦截HasProperty操作,即判断对象是否具有某个属性时,这个方法会生效。典型的操作就是in运算符。has方法可以接受两个参数: 目标对象(target)、需查询的属性名(propKey)。
    var handler = {
      has (target, key) {
        if (key[0] === '_') {
          return false;
        }
        return key in target;
      }
    };
    var target = { _prop: 'foo', prop: 'foo' };
    var proxy = new Proxy(target, handler);
    '_prop' in proxy // false
    

    值得注意的是,has方法拦截的是HasProperty操作,而不是HasOwnProperty操作,即has方法不判断一个属性是对象自身的属性,还是继承的属性。

construct(target, args)

  • 基本用法: construct方法用于拦截new命令,可以接受两个参数: 目标对象(target)、构造函数的参数对象(args)。
    var p = new Proxy(function () {}, {
      construct: function(target, args) {
        console.log('called: ' + args.join(', '));
        return { value: args[0] * 10 };
      }
    });
    
    (new p(1)).value
    // "called: 1"
    // 10
    
    //construct方法返回的必须是一个对象,否则会报错。
    var p = new Proxy(function() {}, {
      construct: function(target, argumentsList) {
        return 1;
      }
    });
    
    new p() // 报错
    

deleteProperty(target, propKey)

  • 基本用法: deleteProperty方法用于拦截delete操作,如果这个方法抛出错误或者返回false,当前属性就无法被delete命令删除。
    var handler = {
      deleteProperty (target, key) {
        invariant(key, 'delete');
        delete target[key];
        return true;
      }
    };
    function invariant (key, action) {
      if (key[0] === '_') {
        throw new Error(`Invalid attempt to ${action} private "${key}" property`);
      }
    }
    
    var target = { _prop: 'foo' };
    var proxy = new Proxy(target, handler);
    delete proxy._prop
    // Error: Invalid attempt to delete private "_prop" property
    

defineProperty(target, propKey, propDesc)

  • 基本用法: defineProperty方法拦截了Object.defineProperty操作。
    var handler = {
      defineProperty (target, key, descriptor) {
        return false;
      }
    };
    var target = {};
    var proxy = new Proxy(target, handler);
    proxy.foo = 'bar' // 不会生效
    

getOwnPropertyDescriptor(target, propKey)

  • 基本用法: getOwnPropertyDescriptor方法拦截Object.getOwnPropertyDescriptor(),返回一个属性描述对象或者undefined
    var handler = {
      getOwnPropertyDescriptor (target, key) {
        if (key[0] === '_') {
          return;
        }
        return Object.getOwnPropertyDescriptor(target, key);
      }
    };
    var target = { _foo: 'bar', baz: 'tar' };
    var proxy = new Proxy(target, handler);
    Object.getOwnPropertyDescriptor(proxy, 'wat')
    // undefined
    Object.getOwnPropertyDescriptor(proxy, '_foo')
    // undefined
    Object.getOwnPropertyDescriptor(proxy, 'baz')
    // { value: 'tar', writable: true, enumerable: true, configurable: true }
    

getPrototypeOf(target)

  • 基本用法: getPrototypeOf方法主要用来拦截获取对象原型。具体来说,拦截下面这些操作:
    • Object.prototype.proto
    • Object.prototype.isPrototypeOf()
    • Object.getPrototypeOf()
    • Reflect.getPrototypeOf()
    • instanceof 注意,getPrototypeOf方法的返回值必须是对象或者null,否则报错。
    var proto = {};
    var p = new Proxy({}, {
      getPrototypeOf(target) {
        return proto;
      }
    });
    Object.getPrototypeOf(p) === proto // true
    

isExtensible(target)

  • 基本用法: isExtensible方法拦截Object.isExtensible操作。注意,该方法只能返回布尔值,否则返回值会被自动转为布尔值。
    var p = new Proxy({}, {
      isExtensible: function(target) {
        console.log("called");
        return true;
      }
    });
    
    Object.isExtensible(p)
    // "called"
    // true
    

ownKeys(target)

  • 基本用法: ownKeys方法用来拦截对象自身属性的读取操作。具体来说,拦截以下操作:
    • Object.getOwnPropertyNames()
    • Object.getOwnPropertySymbols()
    • Object.keys()
    • for…in循环
    var p = new Proxy({}, {
      ownKeys: function(target) {
        return ['a', 'b', 'c'];
      }
    });
    
    Object.getOwnPropertyNames(p)
    // [ 'a', 'b', 'c' ]
    

preventExtensions(target)

  • 基本用法: preventExtensions方法拦截Object.preventExtensions()。该方法必须返回一个布尔值,否则会被自动转为布尔值。这个方法有一个限制,只有目标对象不可扩展时(即Object.isExtensible(proxy)false),proxy.preventExtensions才能返回true,否则会报错。为了防止出现这个问题,通常要在proxy.preventExtensions方法里面,调用一次Object.preventExtensions
    var proxy = new Proxy({}, {
      preventExtensions: function(target) {
        console.log('called');
        Object.preventExtensions(target);
        return true;
      }
    });
    
    Object.preventExtensions(proxy)
    // "called"
    // Proxy {}
    

setPrototypeOf(target, proto)

  • 基本用法: setPrototypeOf方法主要用来拦截Object.setPrototypeOf方法。
    var handler = {
      setPrototypeOf (target, proto) {
        throw new Error('Changing the prototype is forbidden');
      }
    };
    var proto = {};
    var target = function () {};
    var proxy = new Proxy(target, handler);
    Object.setPrototypeOf(proxy, proto);
    // Error: Changing the prototype is forbidden
    

this 问题

  • 基本用法: 虽然 Proxy 可以代理针对目标对象的访问,但它不是目标对象的透明代理,即不做任何拦截的情况下,也无法保证与目标对象的行为一致。主要原因就是在 Proxy 代理的情况下,目标对象内部的this关键字会指向 Proxy 代理。
    const target = {
      m: function () {
        console.log(this === proxy);
      }
    };
    const handler = {};
    
    const proxy = new Proxy(target, handler);
    
    target.m() // false
    proxy.m()  // true
    

Reflect

Reflect

  • 基本用法: Reflect对象与Proxy对象一样,也是 ES6 为了操作对象而提供的新APIReflect对象的设计目的有这样几个:
    • Object对象的一些明显属于语言内部的方法(比如Object.defineProperty),放到Reflect对象上。现阶段,某些方法同时在ObjectReflect对象上部署,未来的新方法将只部署在Reflect对象上。也就是说,从Reflect对象上可以拿到语言内部的方法。
    • 修改某些Object方法的返回结果,让其变得更合理。
    //比如,Object.defineProperty(obj, name, desc)在无法定义属性时,会抛出一个错误,
    //而Reflect.defineProperty(obj, name, desc)则会返回false。
    // 老写法
    try {
      Object.defineProperty(target, property, attributes);
      // success
    } catch (e) {
      // failure
    }
    
    // 新写法
    if (Reflect.defineProperty(target, property, attributes)) {
      // success
    } else {
      // failure
    }
    
    • Object操作都变成函数行为。
    //某些Object操作是命令式,比如name in obj和delete obj[name],
    //而Reflect.has(obj, name)和Reflect.deleteProperty(obj, name)让它们变成了函数行为。
    // 老写法
    'assign' in Object // true
    
    // 新写法
    Reflect.has(Object, 'assign') // true
    
    • Reflect对象的方法与Proxy对象的方法一一对应,只要是Proxy对象的方法,就能在Reflect对象上找到对应的方法。这就让Proxy对象可以方便地调用对应的Reflect方法,完成默认行为,作为修改行为的基础。也就是说,不管Proxy怎么修改默认行为,你总可以在Reflect上获取默认行为。
    Proxy(target, {
      set: function(target, name, value, receiver) {
        var success = Reflect.set(target, name, value, receiver); //完成默认行为
        //制定拦截行为
        if (success) {
          console.log('property ' + name + ' on ' + target + ' set to ' + value);
        }
        return success;
      }
    });
    

静态方法

Reflect对象一共有 13 个静态方法,大部分与Object对象的同名方法的作用都是相同的,而且它与Proxy对象的方法是一一对应的:

  • Reflect.apply(target, thisArg, args)
  • Reflect.construct(target, args)
  • Reflect.get(target, name, receiver)
  • Reflect.set(target, name, value, receiver)
  • Reflect.defineProperty(target, name, desc)
  • Reflect.deleteProperty(target, name)
  • Reflect.has(target, name)
  • Reflect.ownKeys(target)
  • Reflect.isExtensible(target)
  • Reflect.preventExtensions(target)
  • Reflect.getOwnPropertyDescriptor(target, name)
  • Reflect.getPrototypeOf(target)
  • Reflect.setPrototypeOf(target, prototype)

「下次一定」

下次一定

使用微信扫描二维码完成支付