Object.defineProperty

The Object.defineProperty() method defines a new property directly on an object, or modifies an existing property on an object, and returns the object.

直接在一个对象上定义一个新的属性,或修改一个已经存在的属性。这个方法会返回该对象。

语法

Object.defineProperty(obj, prop, descriptor)

参数

  • Object obj 目标对象

  • String prop 需要定义的属性

  • Object descriptor 该属性拥有的特性,可设置的值有:

    • value 属性的值,默认为 undefined

    • writable 该属性是否可写,如果设置成 false,则任何对该属性改写的操作都无效(但不会报错),默认为 false

    • get 一旦目标对象访问该属性,就会调用这个方法,并返回结果。默认为 undefined

    • set 一旦目标对象设置该属性,就会调用这个方法。默认为 undeinfed

    • configurable 如果为false,则任何尝试删除目标属性或修改属性以下特性(writable, configurable, enumerable)的行为将被无效化,默认为 false

    • enumerable 是否能在for…in循环中遍历出来或在Object.keys中列举出来。默认为 false

注意:descriptor 中不能同时设置访问器 (getset) 和 wriablevalue,否则会报以下错误:

1
Invalid property.  A property cannot both have accessors and be writable or have a value

实际应用

我们知道,在 Express.js 升级到 4.0 之后,它把很多功能从核心库中移除了。当我们访问那些被移除的属性时,它会报错,告诉我们该属性已经被移除了。这个功能就是通过 Object.defineProperty 来实现的。看看源码吧:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
[
  'json',
  'urlencoded',
  'bodyParser',
  'compress',
  'cookieSession',
  'session',
  'logger',
  'cookieParser',
  'favicon',
  'responseTime',
  'errorHandler',
  'timeout',
  'methodOverride',
  'vhost',
  'csrf',
  'directory',
  'limit',
  'multipart',
  'staticCache',
].forEach(function (name) {
  Object.defineProperty(exports, name, {
    get: function () {
      throw new Error('Most middleware (like ' + name + ') is no longer bundled with Express and must be installed separately. Please see https://github.com/senchalabs/connect#middleware.');
    },
    configurable: true
  });
});

Object.defineProperties

The Object.defineProperties() method defines new or modifies existing properties directly on an object, returning the object.

Object.defineProperty 类似,只不过这个方法可以设置多个属性。

语法

Object.defineProperties(obj, props)

参数

  • Object obj 目标对象

  • Object props 要为目标对象添加的属性,其中 keyvalue 分别代表 Object.defineProperty 中的第二和第三个参数。

参考资料