diff --git a/docs/object.md b/docs/object.md index 77e1b71..97408d4 100644 --- a/docs/object.md +++ b/docs/object.md @@ -78,7 +78,7 @@ getPoint() // {x:1, y:10} ``` -CommonJS模块输出变量，就非常合适使用简洁写法。 +CommonJS 模块输出一组变量，就非常合适使用简洁写法。 ```javascript var ms = {}; @@ -139,11 +139,11 @@ var obj = { 上面代码中，`class`是字符串，所以不会因为它属于关键字，而导致语法解析报错。 -如果某个方法的值是一个Generator函数，前面需要加上星号。 +如果某个方法的值是一个 Generator 函数，前面需要加上星号。 ```javascript var obj = { - * m(){ + * m() { yield 'hello world'; } }; @@ -151,7 +151,7 @@ var obj = { ## 属性名表达式 -JavaScript语言定义对象的属性，有两种方法。 +JavaScript 定义对象的属性，有两种方法。 ```javascript // 方法一 @@ -300,9 +300,9 @@ obj[key2].name // "" ## Object.is() -ES5比较两个值是否相等，只有两个运算符：相等运算符（`==`）和严格相等运算符（`===`）。它们都有缺点，前者会自动转换数据类型，后者的`NaN`不等于自身，以及`+0`等于`-0`。JavaScript缺乏一种运算，在所有环境中，只要两个值是一样的，它们就应该相等。 +ES5 比较两个值是否相等，只有两个运算符：相等运算符（`==`）和严格相等运算符（`===`）。它们都有缺点，前者会自动转换数据类型，后者的`NaN`不等于自身，以及`+0`等于`-0`。JavaScript 缺乏一种运算，在所有环境中，只要两个值是一样的，它们就应该相等。 -ES6提出“Same-value equality”（同值相等）算法，用来解决这个问题。`Object.is`就是部署这个算法的新方法。它用来比较两个值是否严格相等，与严格比较运算符（===）的行为基本一致。 +ES6 提出“Same-value equality”（同值相等）算法，用来解决这个问题。`Object.is`就是部署这个算法的新方法。它用来比较两个值是否严格相等，与严格比较运算符（===）的行为基本一致。 ```javascript Object.is('foo', 'foo') @@ -321,7 +321,7 @@ Object.is(+0, -0) // false Object.is(NaN, NaN) // true ``` -ES5可以通过下面的代码，部署`Object.is`。 +ES5 可以通过下面的代码，部署`Object.is`。 ```javascript Object.defineProperty(Object, 'is', { @@ -464,7 +464,7 @@ Object.assign(target, source) 上面代码中，`target`对象的`a`属性被`source`对象的`a`属性整个替换掉了，而不会得到`{ a: { b: 'hello', d: 'e' } }`的结果。这通常不是开发者想要的，需要特别小心。 -有一些函数库提供`Object.assign`的定制版本（比如Lodash的`_.defaultsDeep`方法），可以解决浅拷贝的问题，得到深拷贝的合并。 +有一些函数库提供`Object.assign`的定制版本（比如 Lodash 的`_.defaultsDeep`方法），可以解决浅拷贝的问题，得到深拷贝的合并。 注意，`Object.assign`可以用来处理数组，但是会把数组视为对象。 @@ -512,7 +512,7 @@ SomeClass.prototype.anotherMethod = function () { }; ``` -上面代码使用了对象属性的简洁表示法，直接将两个函数放在大括号中，再使用assign方法添加到SomeClass.prototype之中。 +上面代码使用了对象属性的简洁表示法，直接将两个函数放在大括号中，再使用`assign`方法添加到`SomeClass.prototype`之中。 **（3）克隆对象** @@ -584,7 +584,9 @@ processContent({ url: {port: 8000} }) 上面代码的原意是将`url.port`改成8000，`url.host`不变。实际结果却是`options.url`覆盖掉`DEFAULTS.url`，所以`url.host`就不存在了。 -## 属性的可枚举性 +## 属性的可枚举性和遍历 + +### 可枚举性 对象的每个属性都有一个描述对象（Descriptor），用来控制该属性的行为。`Object.getOwnPropertyDescriptor`方法可以获取该属性的描述对象。 @@ -601,15 +603,14 @@ Object.getOwnPropertyDescriptor(obj, 'foo') 描述对象的`enumerable`属性，称为”可枚举性“，如果该属性为`false`，就表示某些操作会忽略当前属性。 -ES5 有三个操作会忽略`enumerable`为`false`的属性。 +目前，有四个操作会忽略`enumerable`为`false`的属性。 -- `for...in`循环：只遍历对象自身的和继承的可枚举的属性 -- `Object.keys()`：返回对象自身的所有可枚举的属性的键名 -- `JSON.stringify()`：只串行化对象自身的可枚举的属性 +- `for...in`循环：只遍历对象自身的和继承的可枚举的属性。 +- `Object.keys()`：返回对象自身的所有可枚举的属性的键名。 +- `JSON.stringify()`：只串行化对象自身的可枚举的属性。 +- `Object.assign()`： 忽略`enumerable`为`false`的属性，只拷贝对象自身的可枚举的属性。 -ES6 新增了一个操作`Object.assign()`，会忽略`enumerable`为`false`的属性，只拷贝对象自身的可枚举的属性。 - -这四个操作之中，只有`for...in`会返回继承的属性。实际上，引入`enumerable`的最初目的，就是让某些属性可以规避掉`for...in`操作。比如，对象原型的`toString`方法，以及数组的`length`属性，就通过这种手段，不会被`for...in`遍历到。 +这四个操作之中，前三个是 ES5 就有的，最后一个`Object.assign()`是 ES6 新增的。其中，只有`for...in`会返回继承的属性，其他三个方法都会忽略继承的属性，只处理对象自身的属性。实际上，引入“可枚举”（`enumerable`）这个概念的最初目的，就是让某些属性可以规避掉`for...in`操作，不然所有内部属性和方法都会被遍历到。比如，对象原型的`toString`方法，以及数组的`length`属性，就通过“可枚举性”，从而避免被`for...in`遍历到。 ```javascript Object.getOwnPropertyDescriptor(Object.prototype, 'toString').enumerable @@ -621,7 +622,7 @@ Object.getOwnPropertyDescriptor([], 'length').enumerable 上面代码中，`toString`和`length`属性的`enumerable`都是`false`，因此`for...in`不会遍历到这两个继承自原型的属性。 -另外，ES6规定，所有Class的原型的方法都是不可枚举的。 +另外，ES6 规定，所有 Class 的原型的方法都是不可枚举的。 ```javascript Object.getOwnPropertyDescriptor(class {foo() {}}.prototype, 'foo').enumerable @@ -630,7 +631,7 @@ Object.getOwnPropertyDescriptor(class {foo() {}}.prototype, 'foo').enumerable 总的来说，操作中引入继承的属性会让问题复杂化，大多数时候，我们只关心对象自身的属性。所以，尽量不要用`for...in`循环，而用`Object.keys()`代替。 -## 属性的遍历 +### 属性的遍历 ES6 一共有5种方法可以遍历对象的属性。 @@ -667,6 +668,168 @@ Reflect.ownKeys({ [Symbol()]:0, b:0, 10:0, 2:0, a:0 }) 上面代码中，`Reflect.ownKeys`方法返回一个数组，包含了参数对象的所有属性。这个数组的属性次序是这样的，首先是数值属性`2`和`10`，其次是字符串属性`b`和`a`，最后是 Symbol 属性。 +## Object.getOwnPropertyDescriptors() + +前面说过，`Object.getOwnPropertyDescriptor`方法会返回某个对象属性的描述对象（descriptor）。ES2017 引入了`Object.getOwnPropertyDescriptors`方法，返回指定对象所有自身属性（非继承属性）的描述对象。 + +```javascript +const obj = { + foo: 123, + get bar() { return 'abc' } +}; + +Object.getOwnPropertyDescriptors(obj) +// { foo: +// { value: 123, +// writable: true, +// enumerable: true, +// configurable: true }, +// bar: +// { get: [Function: bar], +// set: undefined, +// enumerable: true, +// configurable: true } } +``` + +上面代码中，`Object.getOwnPropertyDescriptors`方法返回一个对象，所有原对象的属性名都是该对象的属性名，对应的属性值就是该属性的描述对象。 + +该方法的实现非常容易。 + +```javascript +function getOwnPropertyDescriptors(obj) { + const result = {}; + for (let key of Reflect.ownKeys(obj)) { + result[key] = Object.getOwnPropertyDescriptor(obj, key); + } + return result; +} +``` + +该方法的引入目的，主要是为了解决`Object.assign()`无法正确拷贝`get`属性和`set`属性的问题。 + +```javascript +const source = { + set foo(value) { + console.log(value); + } +}; + +const target1 = {}; +Object.assign(target1, source); + +Object.getOwnPropertyDescriptor(target1, 'foo') +// { value: undefined, +// writable: true, +// enumerable: true, +// configurable: true } +``` + +上面代码中，`source`对象的`foo`属性的值是一个赋值函数，`Object.assign`方法将这个属性拷贝给`target1`对象，结果该属性的值变成了`undefined`。这是因为`Object.assign`方法总是拷贝一个属性的值，而不会拷贝它背后的赋值方法或取值方法。 + +这时，`Object.getOwnPropertyDescriptors`方法配合`Object.defineProperties`方法，就可以实现正确拷贝。 + +```javascript +const source = { + set foo(value) { + console.log(value); + } +}; + +const target2 = {}; +Object.defineProperties(target2, Object.getOwnPropertyDescriptors(source)); +Object.getOwnPropertyDescriptor(target2, 'foo') +// { get: undefined, +// set: [Function: foo], +// enumerable: true, +// configurable: true } +``` + +上面代码中，两个对象合并的逻辑可以写成一个函数。 + +```javascript +const shallowMerge = (target, source) => Object.defineProperties( + target, + Object.getOwnPropertyDescriptors(source) +); +``` + +`Object.getOwnPropertyDescriptors`方法的另一个用处，是配合`Object.create`方法，将对象属性克隆到一个新对象。这属于浅拷贝。 + +```javascript +const clone = Object.create(Object.getPrototypeOf(obj), + Object.getOwnPropertyDescriptors(obj)); + +// 或者 + +const shallowClone = (obj) => Object.create( + Object.getPrototypeOf(obj), + Object.getOwnPropertyDescriptors(obj) +); +``` + +上面代码会克隆对象`obj`。 + +另外，`Object.getOwnPropertyDescriptors`方法可以实现一个对象继承另一个对象。以前，继承另一个对象，常常写成下面这样。 + +```javascript +const obj = { + __proto__: prot, + foo: 123, +}; +``` + +ES6 规定`__proto__`只有浏览器要部署，其他环境不用部署。如果去除`__proto__`，上面代码就要改成下面这样。 + +```javascript +const obj = Object.create(prot); +obj.foo = 123; + +// 或者 + +const obj = Object.assign( + Object.create(prot), + { + foo: 123, + } +); +``` + +有了`Object.getOwnPropertyDescriptors`，我们就有了另一种写法。 + +```javascript +const obj = Object.create( + prot, + Object.getOwnPropertyDescriptors({ + foo: 123, + }) +); +``` + +`Object.getOwnPropertyDescriptors`也可以用来实现 Mixin（混入）模式。 + +```javascript +let mix = (object) => ({ + with: (...mixins) => mixins.reduce( + (c, mixin) => Object.create( + c, Object.getOwnPropertyDescriptors(mixin) + ), object) +}); + +// multiple mixins example +let a = {a: 'a'}; +let b = {b: 'b'}; +let c = {c: 'c'}; +let d = mix(c).with(a, b); + +d.c // "c" +d.b // "b" +d.a // "a" +``` + +上面代码返回一个新的对象`d`，代表了对象`a`和`b`被混入了对象`c`的操作。 + +出于完整性的考虑，`Object.getOwnPropertyDescriptors`进入标准以后，还会有`Reflect.getOwnPropertyDescriptors`方法。 + ## `__proto__`属性，Object.setPrototypeOf()，Object.getPrototypeOf() ### `__proto__`属性 @@ -687,7 +850,7 @@ obj.method = function() { ... }; 该属性没有写入 ES6 的正文，而是写入了附录，原因是`__proto__`前后的双下划线，说明它本质上是一个内部属性，而不是一个正式的对外的 API，只是由于浏览器广泛支持，才被加入了 ES6。标准明确规定，只有浏览器必须部署这个属性，其他运行环境不一定需要部署，而且新的代码最好认为这个属性是不存在的。因此，无论从语义的角度，还是从兼容性的角度，都不要使用这个属性，而是使用下面的`Object.setPrototypeOf()`（写操作）、`Object.getPrototypeOf()`（读操作）、`Object.create()`（生成操作）代替。 -在实现上，`__proto__`调用的是`Object.prototype.__proto__`，具体实现如下。 +实现上，`__proto__`调用的是`Object.prototype.__proto__`，具体实现如下。 ```javascript Object.defineProperty(Object.prototype, '__proto__', { @@ -1206,181 +1369,6 @@ let runtimeError = { }; ``` -## Object.getOwnPropertyDescriptors() - -ES5 一个`Object.getOwnPropertyDescriptor`方法，返回某个对象属性的描述对象（descriptor）。 - -```javascript -var obj = { p: 'a' }; - -Object.getOwnPropertyDescriptor(obj, 'p') -// Object { value: "a", -// writable: true, -// enumerable: true, -// configurable: true -// } -``` - -ES2017 引入了`Object.getOwnPropertyDescriptors`方法，返回指定对象所有自身属性（非继承属性）的描述对象。 - -```javascript -const obj = { - foo: 123, - get bar() { return 'abc' } -}; - -Object.getOwnPropertyDescriptors(obj) -// { foo: -// { value: 123, -// writable: true, -// enumerable: true, -// configurable: true }, -// bar: -// { get: [Function: bar], -// set: undefined, -// enumerable: true, -// configurable: true } } -``` - -上面代码中，`Object.getOwnPropertyDescriptors`方法返回一个对象，所有原对象的属性名都是该对象的属性名，对应的属性值就是该属性的描述对象。 - -该方法的实现非常容易。 - -```javascript -function getOwnPropertyDescriptors(obj) { - const result = {}; - for (let key of Reflect.ownKeys(obj)) { - result[key] = Object.getOwnPropertyDescriptor(obj, key); - } - return result; -} -``` - -该方法的引入目的，主要是为了解决`Object.assign()`无法正确拷贝`get`属性和`set`属性的问题。 - -```javascript -const source = { - set foo(value) { - console.log(value); - } -}; - -const target1 = {}; -Object.assign(target1, source); - -Object.getOwnPropertyDescriptor(target1, 'foo') -// { value: undefined, -// writable: true, -// enumerable: true, -// configurable: true } -``` - -上面代码中，`source`对象的`foo`属性的值是一个赋值函数，`Object.assign`方法将这个属性拷贝给`target1`对象，结果该属性的值变成了`undefined`。这是因为`Object.assign`方法总是拷贝一个属性的值，而不会拷贝它背后的赋值方法或取值方法。 - -这时，`Object.getOwnPropertyDescriptors`方法配合`Object.defineProperties`方法，就可以实现正确拷贝。 - -```javascript -const source = { - set foo(value) { - console.log(value); - } -}; - -const target2 = {}; -Object.defineProperties(target2, Object.getOwnPropertyDescriptors(source)); -Object.getOwnPropertyDescriptor(target2, 'foo') -// { get: undefined, -// set: [Function: foo], -// enumerable: true, -// configurable: true } -``` - -上面代码中，将两个对象合并的逻辑提炼出来，就是下面这样。 - -```javascript -const shallowMerge = (target, source) => Object.defineProperties( - target, - Object.getOwnPropertyDescriptors(source) -); -``` - -`Object.getOwnPropertyDescriptors`方法的另一个用处，是配合`Object.create`方法，将对象属性克隆到一个新对象。这属于浅拷贝。 - -```javascript -const clone = Object.create(Object.getPrototypeOf(obj), - Object.getOwnPropertyDescriptors(obj)); - -// 或者 - -const shallowClone = (obj) => Object.create( - Object.getPrototypeOf(obj), - Object.getOwnPropertyDescriptors(obj) -); -``` - -上面代码会克隆对象`obj`。 - -另外，`Object.getOwnPropertyDescriptors`方法可以实现一个对象继承另一个对象。以前，继承另一个对象，常常写成下面这样。 - -```javascript -const obj = { - __proto__: prot, - foo: 123, -}; -``` - -ES6 规定`__proto__`只有浏览器要部署，其他环境不用部署。如果去除`__proto__`，上面代码就要改成下面这样。 - -```javascript -const obj = Object.create(prot); -obj.foo = 123; - -// 或者 - -const obj = Object.assign( - Object.create(prot), - { - foo: 123, - } -); -``` - -有了`Object.getOwnPropertyDescriptors`，我们就有了另一种写法。 - -```javascript -const obj = Object.create( - prot, - Object.getOwnPropertyDescriptors({ - foo: 123, - }) -); -``` - -`Object.getOwnPropertyDescriptors`也可以用来实现 Mixin（混入）模式。 - -```javascript -let mix = (object) => ({ - with: (...mixins) => mixins.reduce( - (c, mixin) => Object.create( - c, Object.getOwnPropertyDescriptors(mixin) - ), object) -}); - -// multiple mixins example -let a = {a: 'a'}; -let b = {b: 'b'}; -let c = {c: 'c'}; -let d = mix(c).with(a, b); - -d.c // "c" -d.b // "b" -d.a // "a" -``` - -上面代码返回一个新的对象`d`，代表了对象`a`和`b`被混入了对象`c`的操作。 - -出于完整性的考虑，`Object.getOwnPropertyDescriptors`进入标准以后，还会有`Reflect.getOwnPropertyDescriptors`方法。 - ## Null 传导运算符 编程实务中，如果读取对象内部的某个属性，往往需要判断一下该对象是否存在。比如，要读取`message.body.user.firstName`，安全的写法是写成下面这样。