edit destructuring

2025-05-24 18:32:22 +00:00 · 2014-05-14 12:27:11 +08:00 · 2014-05-14 12:27:11 +08:00 · 632542b94b
commit 632542b94b
parent 5752f09ec5
3 changed files with 199 additions and 33 deletions
--- a/docs/destructuring.md
+++ b/docs/destructuring.md
@ -1,8 +1,10 @@
-# 多变量的模式赋值
+# 变量的解构赋值

-ES6允许按照一定模式，一次性对多个变量进行赋值，这又称为解构（Destructuring）。
+## 数组的解构赋值

-正常情况下，为多个变量赋值，只能一次次分开赋值。
+ES6允许按照一定模式，从数组和对象中提取值，对变量进行赋值，这被称为解构（Destructuring）。
+
+以前，为变量赋值，只能直接指定值。

 ```javascript

@ -20,59 +22,160 @@ 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] = [];
-
-console.log(missing)
-// true
-
-var { x = 3 } = {};
-console.log(x)
-// 3
+var [foo] = [];
+var [foo] = 1;
+var [foo] = 'Hello';
+var [foo] = false;
+var [foo] = NaN;

 ```

-模式赋值不仅可以用于数组，还可以用于对象。
+以上几种情况都属于解构不成功，foo的值都会等于undefined。但是，如果对undefined或null进行解构，就会报错。

 ```javascript

-var { foo, bar } = { foo: "lorem", bar: "ipsum" };
+// 报错
+var [foo] = undefined;
+var [foo] = null;

-foo // "lorem"
-bar // "ipsum"
+```
+
+这是因为解构只能用于数组或对象。其他原始类型的值都可以转为相应的对象，但是，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 { bar, foo } = { foo: "aaa", bar: "bbb" };
+foo // "aaa"
+bar // "bbb"
+
+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"

 ```

-这种写法的用途很多。
+对象的解构也可以指定默认值。

-（1）交换变量的值
+```javascript
+
+var { x = 3 } = {};
+x // 3
+
+```
+
+如果要将一个已经声明的变量用于解构赋值，必须非常小心。
+
+```javascript
+
+// 错误的写法
+
+var x;
+{x} = {x:1};
+// SyntaxError: syntax error
+
+```
+
+上面代码的写法会报错，因为JavaScript引擎会将`{x}`理解成一个代码块，从而发生语法错误。只有不将大括号写在行首，才能避免这个问题。
+
+```javascript
+
+// 正确的写法
+
+({x}) = {x:1};
+// 或者
+({x} = {x:1});
+
+```
+
+## 用途
+
+变量的解构赋值用途很多。
+
+**（1）交换变量的值**

 ```javascript

@ -80,29 +183,46 @@ y // "World"

 ```

-（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");
+
+```
--- a/docs/reference.md
+++ b/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)
--- a/sidebar.md
+++ b/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)