edit destructuring

Author: ruanyf

docs/destructuring.md

@@ -1,8 +1,10 @@
-# 多变量的模式赋值
+# 变量的解构赋值
 
-ES6允许按照一定模式，一次性对多个变量进行赋值，这又称为解构（Destructuring）。
+## 数组的解构赋值
 
-正常情况下，为多个变量赋值，只能一次次分开赋值。
+ES6允许按照一定模式，从数组和对象中提取值，对变量进行赋值，这被称为解构（Destructuring）。
+
+以前，为变量赋值，只能直接指定值。
 
 ```javascript
 
@@ -20,89 +22,207 @@ var [a, b, c] = [1, 2, 3];
 
 ```
 
-本质上，这种写法属于模式匹配，只要等号两边的模式相同，左边的变量就会被赋予对应的值。下面是一些嵌套数组进行模式赋值的例子。
+上面代码表示，可以从数组中提取值，按照对应位置，对变量赋值。
+
+本质上，这种写法属于“模式匹配”，只要等号两边的模式相同，左边的变量就会被赋予对应的值。下面是一些使用嵌套数组进行解构的例子。
 
 ```javascript
 
-var [foo, [[bar], baz]] = [1, [[2], 3]]
+var [foo, [[bar], baz]] = [1, [[2], 3]];
+foo // 1
+bar // 2
+baz // 3
 
-var [,,third] = ["foo", "bar", "baz"]
+var [,,third] = ["foo", "bar", "baz"];
+third // "baz"
 
-var [head, ...tail] = [1, 2, 3, 4]
+var [head, ...tail] = [1, 2, 3, 4];
+head // 1
+tail // [2, 3, 4]
 
 ```
 
-模式赋值还允许指定默认值。
+如果解构不成功，变量的值就等于undefined。
 
 ```javascript
 
-var [missing = true] = [];
+var [foo] = [];
+var [foo] = 1;
+var [foo] = 'Hello';
+var [foo] = false;
+var [foo] = NaN;
 
-console.log(missing)
-// true
+```
 
-var { x = 3 } = {};
-console.log(x)
-// 3
+以上几种情况都属于解构不成功，foo的值都会等于undefined。但是，如果对undefined或null进行解构，就会报错。
+
+```javascript
+
+// 报错
+var [foo] = undefined;
+var [foo] = null;
+
+```
+
+这是因为解构只能用于数组或对象。其他原始类型的值都可以转为相应的对象，但是，undefined和null不能转为对象，因此报错。
+
+解构赋值允许指定默认值。
+
+```javascript
+
+var [foo = true] = [];
+foo // true
+
+```
+
+解构赋值不仅适用于var命令，也适用于let和const命令。
+
+```javascript
+
+var [v1, v2, ..., vN ] = array;
+let [v1, v2, ..., vN ] = array;
+const [v1, v2, ..., vN ] = array;
+
+```
+
+## 对象的解构赋值
+
+解构不仅可以用于数组，还可以用于对象。
+
+```javascript
+
+var { foo, bar } = { foo: "aaa", bar: "bbb" };
+foo // "aaa"
+bar // "bbb"
 
 ```
 
-模式赋值不仅可以用于数组，还可以用于对象。
+对象的解构与数组有一个重要的不同。数组的元素是按次序排列的，变量的取值由它的位置决定；而对象的属性没有次序，变量必须与属性同名，才能取到正确的值。
 
 ```javascript
 
-var { foo, bar } = { foo: "lorem", bar: "ipsum" };
+var { bar, foo } = { foo: "aaa", bar: "bbb" };
+foo // "aaa"
+bar // "bbb"
 
-foo // "lorem"
-bar // "ipsum"
+var { baz } = { foo: "aaa", bar: "bbb" };
+baz // undefined
+
+```
+
+上面代码的第一个例子，等号左边的两个变量的次序，与等号右边两个同名属性的次序不一致，但是对取值完全没有影响。第二个例子的变量没有对应的同名属性，导致取不到值，最后等于`undefined`。
+
+如果变量名与属性名不一致，必须写成下面这样。
+
+```javascript
+
+var { foo: baz } = { foo: "aaa", bar: "bbb" };
+baz // "aaa"
+
+```
+
+和数组一样，解构也可以用于嵌套结构的对象。
+
+```javascript
 
 var o = {
-  p1: [
+  p: [
     "Hello",
-    { p2: "World" }
+    { y: "World" }
   ]
 };
 
-var { a: [x, { y }] } = o;
-
+var { p: [x, { y }] } = o;
 x // "Hello"
 y // "World"
 
 ```
 
-这种写法的用途很多。
+对象的解构也可以指定默认值。
+
+```javascript
+
+var { x = 3 } = {};
+x // 3
+
+```
 
-（1）交换变量的值
+如果要将一个已经声明的变量用于解构赋值，必须非常小心。
+
+```javascript
+
+// 错误的写法
+
+var x;
+{x} = {x:1};
+// SyntaxError: syntax error
+
+```
+
+上面代码的写法会报错，因为JavaScript引擎会将`{x}`理解成一个代码块，从而发生语法错误。只有不将大括号写在行首，才能避免这个问题。
+
+```javascript
+
+// 正确的写法
+
+({x}) = {x:1};
+// 或者
+({x} = {x:1});
+
+```
+
+## 用途
+
+变量的解构赋值用途很多。
+
+**（1）交换变量的值**
 
 ```javascript
 
 [x, y] = [y, x]; 
 
 ```
 
-（2）从函数返回多个值
+**（2）从函数返回多个值**
+
+函数只能返回一个值，如果要返回多个值，只能将它们放在数组或对象里返回。有了解构赋值，取出这些值就非常方便。
 
 ```javascript
 
+// 返回一个数组
+
 function example() {
     return [1, 2, 3];
 }
-
 var [a, b, c] = example();
 
+// 返回一个对象
+
+function example() {
+  return {
+    foo: 1,
+    bar: 2
+  };
+}
+var { foo, bar } = example();
+
 ```
 
-（3）函数参数的定义
+**（3）函数参数的定义**
 
 ```javascript
 
-function f({p1, p2, p3}) {
+function f({x, y, z}) {
   // ...
 }
 
+f({x:1, y:2, z:3})
+
 ```
 
-（4）函数参数的默认值
+这种写法对提取JSON对象中的数据，尤其有用。
+
+**（4）函数参数的默认值**
 
 ```javascript
 
@@ -119,3 +239,49 @@ jQuery.ajax = function (url, {
 };
 
 ```
+
+指定参数的默认值，就避免了在函数体内部再写`var foo = config.foo || 'default foo';`这样的语句。
+
+**（5）遍历Map结构**
+
+任何部署了Iterator接口的对象，都可以用for...of循环遍历。Map结构原生支持Iterator接口，配合变量的结构赋值，获取键名和键值就非常方便。
+
+```javascript
+
+var map = new Map();
+map.set('first', 'hello');
+map.set('second', 'world');
+
+for (let [key, value] of map) {
+  console.log(key + " is " + value);
+}
+// first is hello
+// second is world
+
+```
+
+如果只想获取键名，或者只想获取键值，可以写成下面这样。
+
+```javascript
+
+// 获取键名
+for (let [key] of map) {
+  // ...
+}
+
+// 获取键值
+for (let [,value] of map) {
+  // ...
+}
+
+```
+
+**（6）输入模块的指定方法**
+
+加载模块时，往往需要指定输入那些方法。解构赋值使得输入语句非常清晰。
+
+```javascript
+
+const { SourceMapConsumer, SourceNode } = require("source-map");
+
+```

docs/reference.md

@@ -19,7 +19,7 @@
 
 ## 语法点
 
-- Nick Fitzgerald, [Destructuring Assignment in ECMAScript 6](http://fitzgeraldnick.com/weblog/50/)
+- Nick Fitzgerald, [Destructuring Assignment in ECMAScript 6](http://fitzgeraldnick.com/weblog/50/): 详细介绍解构赋值的用法
 - Nicholas C. Zakas, [Understanding ECMAScript 6 arrow functions](http://www.nczonline.net/blog/2013/09/10/understanding-ecmascript-6-arrow-functions/)
 - Jack Franklin, [Real Life ES6 - Arrow Functions](http://javascriptplayground.com/blog/2014/04/real-life-es6-arrow-fn/)
 - Axel Rauschmayer, [Handling required parameters in ECMAScript 6](http://www.2ality.com/2014/04/required-parameters-es6.html)

sidebar.md

@@ -8,7 +8,7 @@
 1. [前言](#README)
 1. [ECMAScript 6简介](#docs/intro)
 1. [let和const命令](#docs/let)
-1. [多变量的模式赋值](#docs/destructuring)
+1. [变量的解构赋值](#docs/destructuring)
 1. [字符串的扩展](#docs/string)
 1. [数值的扩展](#docs/number)
 1. [数组的扩展](#docs/array)