book/es6tutorial
1
0
Fork 0
mirror of https://github.com/ruanyf/es6tutorial.git synced 2025-05-24 18:32:22 +00:00
Code Issues Releases Wiki Activity

edit destructuring and iterator

Browse Source
This commit is contained in:
ruanyf 2015-08-30 15:13:43 +08:00
parent 5a5f9d8d49
commit 6b1ee303ff
4 changed files with 95 additions and 77 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
docs/destructuring.md
View File

@ -44,13 +44,10 @@ tail // [2, 3, 4]
```javascript ```javascript
var [foo] = []; var [foo] = [];
var [foo] = 1;
var [foo] = false;
var [foo] = NaN;
var [bar, foo] = [1]; var [bar, foo] = [1];
``` ```
以上几种情况都属于解构不成功，foo的值都会等于undefined。这是因为原始类型的值，会自动转为对象，比如数值1转为`new Number(1)`，从而导致foo取到undefined。 以上两种情况都属于解构不成功，foo的值都会等于undefined。
另一种情况是不完全解构，即等号左边的模式，只匹配一部分的等号右边的数组。这种情况下，解构依然可以成功。 另一种情况是不完全解构，即等号左边的模式，只匹配一部分的等号右边的数组。这种情况下，解构依然可以成功。
@ -65,18 +62,19 @@ b // 2
d // 4 d // 4
``` ```
上面代码的两个例子，都属于不完全解构，但是可以成功。 上面两个例子，都属于不完全解构，但是可以成功。
如果对undefined或null进行解构，会报错。 如果等号的右边不是数组（或者严格地说，不是可遍历的结构，参见《Iterator》一章），那么将会报错。
```javascript ```javascript
// 报错 // 报错
let [foo] = 1;
let [foo] = false;
let [foo] = NaN;
let [foo] = undefined; let [foo] = undefined;
let [foo] = null; let [foo] = null;
``` ```
这是因为解构只能用于数组或对象。其他原始类型的值都可以转为相应的对象，但是，undefined和null不能转为对象，因此报错。
解构赋值允许指定默认值。 解构赋值允许指定默认值。
```javascript ```javascript
@ -207,6 +205,27 @@ x // null
上面代码中，如果x属性等于null，就不严格相等于undefined，导致默认值不会生效。 上面代码中，如果x属性等于null，就不严格相等于undefined，导致默认值不会生效。
如果解构失败，变量的值等于undefined。
```javascript
var {foo} = {bar: 'baz'}
foo // undefined
```
如果解构模式是嵌套的对象，而且子对象所在的父属性不存在，那么将会报错。
```javascript
// 报错
var {foo: {bar}} = {baz: 'baz'}
```
上面代码中，等号左边对象的foo属性，对应一个子对象。该子对象的bar属性，解构时会报错。原因很简单，因为foo这时等于undefined，再取子属性就会报错，请看下面的代码。
```javascript
var _tmp = {baz: 'baz'};
_tmp.foo.bar // 报错
```
如果要将一个已经声明的变量用于解构赋值，必须非常小心。 如果要将一个已经声明的变量用于解构赋值，必须非常小心。
```javascript ```javascript

18
docs/intro.md
View File

@ -116,6 +116,11 @@ $ node --v8-options | grep harmony
```bash ```bash
$ npm install -g es-checker $ npm install -g es-checker
$ es-checker $ es-checker
=========================================
Passes 24 feature Dectations
Your runtime supports 57% of ECMAScript 6
=========================================
``` ```
## Babel转码器 ## Babel转码器
@ -207,6 +212,19 @@ Babel配合Browserify一起使用，可以生成浏览器能够直接加载的
$ browserify script.js -t babelify --outfile bundle.js $ browserify script.js -t babelify --outfile bundle.js
``` ```
在`package.json`设置下面的代码，就不用每次命令行都输入参数了。
```javascript
{
// ...
"browserify": {
"transform": [
["babelify", { "stage": [0] }]
]
}
}
``
## Traceur转码器 ## Traceur转码器
Google公司的[Traceur](https://github.com/google/traceur-compiler)转码器，也可以将ES6代码转为ES5代码。 Google公司的[Traceur](https://github.com/google/traceur-compiler)转码器，也可以将ES6代码转为ES5代码。

117
docs/iterator.md
View File

@ -6,19 +6,19 @@ JavaScript原有的表示“集合”的数据结构，主要是数组（Array
遍历器（Iterator）就是这样一种机制。它是一种接口，为各种不同的数据结构提供统一的访问机制。任何数据结构只要部署Iterator接口，就可以完成遍历操作（即依次处理该数据结构的所有成员）。 遍历器（Iterator）就是这样一种机制。它是一种接口，为各种不同的数据结构提供统一的访问机制。任何数据结构只要部署Iterator接口，就可以完成遍历操作（即依次处理该数据结构的所有成员）。
Iterator的作用有三个：一是为各种数据结构，提供一个统一的、简便的访问接口；二是使得数据结构的成员能够按某种次序排列；三是ES6创造了一种新的遍历命令for...of循环，Iterator接口主要供for...of消费。 Iterator的作用有三个：一是为各种数据结构，提供一个统一的、简便的访问接口；二是使得数据结构的成员能够按某种次序排列；三是ES6创造了一种新的遍历命令`for...of`循环，Iterator接口主要供`for...of`消费。
Iterator的遍历过程是这样的。 Iterator的遍历过程是这样的。
（1）创建一个指针，指向当前数据结构的起始位置。也就是说，遍历器的返回值是一个指针对象。 （1）创建一个指针对象，指向当前数据结构的起始位置。也就是说，遍历器对象本质上，就是一个指针对象。
（2）第一次调用指针对象的next方法，可以将指针指向数据结构的第一个成员。 （2）第一次调用指针对象的next方法，可以将指针指向数据结构的第一个成员。
（3）第二次调用指针对象的next方法，指针就指向数据结构的第二个成员。 （3）第二次调用指针对象的next方法，指针就指向数据结构的第二个成员。
（4）调用指针对象的next方法，直到它指向数据结构的结束位置。 （4）不断调用指针对象的next方法，直到它指向数据结构的结束位置。
每一次调用next方法，都会返回当前成员的信息，具体来说，就是返回一个包含value和done两个属性的对象。其中，value属性是当前成员的值，done属性是一个布尔值，表示遍历是否结束。 每一次调用next方法，都会返回数据结构的当前成员的信息。具体来说，就是返回一个包含value和done两个属性的对象。其中，value属性是当前成员的值，done属性是一个布尔值，表示遍历是否结束。
下面是一个模拟next方法返回值的例子。 下面是一个模拟next方法返回值的例子。
@ -41,15 +41,15 @@ it.next() // { value: "b", done: false }
it.next() // { value: undefined, done: true } it.next() // { value: undefined, done: true }
``` ```
上面代码定义了一个makeIterator函数，它的作用就是返回数组的指针对象。对数组`['a', 'b']`执行这个函数，就会返回该数组的指针对象it。 上面代码定义了一个makeIterator函数，它是一个遍历器生成函数，作用就是返回一个遍历器对象。对数组`['a', 'b']`执行这个函数，就会返回该数组的遍历器对象（即指针对象）it。
指针对象的next方法，用来移动指针。开始时，指针指向数组的开始位置。然后，每次调用next方法，指针就会指向数组的下一个成员。第一次调用，指向a；第二次调用，指向b。 指针对象的next方法，用来移动指针。开始时，指针指向数组的开始位置。然后，每次调用next方法，指针就会指向数组的下一个成员。第一次调用，指向a；第二次调用，指向b。
next方法返回一个对象，表示当前数据成员的信息。这个对象具有value和done两个属性，value属性返回当前位置的成员，done属性是一个布尔值，表示遍历是否结束，即是否还有必要再一次调用next方法。 next方法返回一个对象，表示当前数据成员的信息。这个对象具有value和done两个属性，value属性返回当前位置的成员，done属性是一个布尔值，表示遍历是否结束，即是否还有必要再一次调用next方法。
总之，指针对象具有next方法。调用next方法，就可以遍历事先给定的数据结构。 总之，调用指针对象的next方法，就可以遍历事先给定的数据结构。
由于Iterator只是把接口规格加到数据结构之上，所以，遍历器与它所遍历的那个数据结构，实际上是分开的，完全可以写出没有对应数据结构的遍历器，或者说用遍历器模拟出数据结构。下面是一个无限运行的遍历器例子。 由于Iterator只是把接口规格加到数据结构之上，所以，遍历器与它所遍历的那个数据结构，实际上是分开的，完全可以写出没有对应数据结构的遍历器对象，或者说用遍历器对象模拟出数据结构。下面是一个无限运行的遍历器对象的例子。
```javascript ```javascript
function idMaker(){ function idMaker(){
@ -70,9 +70,9 @@ it.next().value // '2'
// ... // ...
``` ```
上面的例子中，遍历器idMaker函数返回的指针对象，并没有对应的数据结构，或者说遍历器自己描述了一个数据结构出来。 上面的例子中，遍历器生成函数idMaker，返回一个遍历器对象（即指针对象）。但是并没有对应的数据结构，或者说，遍历器对象自己描述了一个数据结构出来。
在ES6中，有些数据结构原生提供遍历器（比如数组），即不用任何处理，就可以被for...of循环遍历，有些就不行（比如对象）。原因在于，这些数据结构原生部署了Symbol.iterator属性（详见下文），另外一些数据结构没有。凡是部署了Symbol.iterator属性的数据结构，就称为部署了遍历器接口。调用这个接口，就会返回一个指针对象。 在ES6中，有些数据结构原生具备Iterator接口（比如数组），即不用任何处理，就可以被for...of循环遍历，有些就不行（比如对象）。原因在于，这些数据结构原生部署了Symbol.iterator属性（详见下文），另外一些数据结构没有。凡是部署了Symbol.iterator属性的数据结构，就称为部署了遍历器接口。调用这个接口，就会返回一个遍历器对象。
如果使用TypeScript的写法，遍历器接口（Iterable）、指针对象（Iterator）和next方法返回值的规格可以描述如下。 如果使用TypeScript的写法，遍历器接口（Iterable）、指针对象（Iterator）和next方法返回值的规格可以描述如下。
@ -93,9 +93,9 @@ interface IterationResult {
## 数据结构的默认Iterator接口 ## 数据结构的默认Iterator接口
Iterator接口的目的，就是为所有数据结构，提供了一种统一的访问机制，即for...of循环（详见下文）。当使用for...of循环遍历某种数据结构时，该循环会自动去寻找Iterator接口。 Iterator接口的目的，就是为所有数据结构，提供了一种统一的访问机制，即`for...of`循环（详见下文）。当使用`for...of`循环遍历某种数据结构时，该循环会自动去寻找Iterator接口。
ES6规定，默认的Iterator接口部署在数据结构的`Symbol.iterator`属性，或者说，一个数据结构只要具有`Symbol.iterator`属性，就可以认为是“可遍历的”（iterable）。调用`Symbol.iterator`方法，就会得到当前数据结构的默认遍历器。`Symbol.iterator`本身是一个表达式，返回Symbol对象的iterator属性，这是一个预定义好的、类型为Symbol的特殊值，所以要放在方括号内（请参考Symbol一章）。 ES6规定，默认的Iterator接口部署在数据结构的`Symbol.iterator`属性，或者说，一个数据结构只要具有`Symbol.iterator`属性，就可以认为是“可遍历的”（iterable）。调用`Symbol.iterator`方法，就会得到当前数据结构默认的遍历器生成函数。`Symbol.iterator`本身是一个表达式，返回Symbol对象的iterator属性，这是一个预定义好的、类型为Symbol的特殊值，所以要放在方括号内（请参考Symbol一章）。
在ES6中，有三类数据结构原生具备Iterator接口：数组、某些类似数组的对象、Set和Map结构。 在ES6中，有三类数据结构原生具备Iterator接口：数组、某些类似数组的对象、Set和Map结构。
@ -109,13 +109,13 @@ iter.next() // { value: 'c', done: false }
iter.next() // { value: undefined, done: true } iter.next() // { value: undefined, done: true }
``` ```
上面代码中，变量arr是一个数组，原生就具有遍历器接口，部署在arr的Symbol.iterator属性上面。所以，调用这个属性，就得到遍历器。 上面代码中，变量arr是一个数组，原生就具有遍历器接口，部署在arr的Symbol.iterator属性上面。所以，调用这个属性，就得到遍历器对象。
上面提到，原生就部署iterator接口的数据结构有三类，对于这三类数据结构，不用自己写遍历器，for...of循环会自动遍历它们。除此之外，其他数据结构（主要是对象）的Iterator接口，都需要自己在Symbol.iterator属性上面部署，这样才会被for...of循环遍历。 上面提到，原生就部署iterator接口的数据结构有三类，对于这三类数据结构，不用自己写遍历器生成函数，for...of循环会自动遍历它们。除此之外，其他数据结构（主要是对象）的Iterator接口，都需要自己在Symbol.iterator属性上面部署，这样才会被`for...of`循环遍历。
对象（Object）之所以没有默认部署Iterator接口，是因为对象的哪个属性先遍历，哪个属性后遍历是不确定的，需要开发者手动指定。本质上，遍历器是一种线性处理，对于任何非线性的数据结构，部署遍历器接口，就等于部署一种线性转换。不过，严格地说，对象部署遍历器接口并不是很必要，因为这时对象实际上被当作Map结构使用，ES5没有Map结构，而ES6原生提供了。 对象（Object）之所以没有默认部署Iterator接口，是因为对象的哪个属性先遍历，哪个属性后遍历是不确定的，需要开发者手动指定。本质上，遍历器是一种线性处理，对于任何非线性的数据结构，部署遍历器接口，就等于部署一种线性转换。不过，严格地说，对象部署遍历器接口并不是很必要，因为这时对象实际上被当作Map结构使用，ES5没有Map结构，而ES6原生提供了。
一个对象如果要有可被for...of循环调用的Iterator接口，就必须在Symbol.iterator的属性上部署遍历器方法（原型链上的对象具有该方法也可）。 一个对象如果要有可被`for...of`循环调用的Iterator接口，就必须在Symbol.iterator的属性上部署遍历器生成方法（原型链上的对象具有该方法也可）。
```javascript ```javascript
class RangeIterator { class RangeIterator {
@ -146,7 +146,7 @@ for (var value of range(0, 3)) {
} }
``` ```
上面代码是一个类部署Iterator接口的写法。Symbol.iterator属性对应一个函数，执行后返回当前对象的遍历器。 上面代码是一个类部署Iterator接口的写法。Symbol.iterator属性对应一个函数，执行后返回当前对象的遍历器对象。
下面是通过遍历器实现指针结构的例子。 下面是通过遍历器实现指针结构的例子。
@ -233,7 +233,7 @@ NodeList.prototype[Symbol.iterator] = [][Symbol.iterator];
[...document.querySelectorAll('div')] // 可以执行了 [...document.querySelectorAll('div')] // 可以执行了
``` ```
如果Symbol.iterator方法返回的不是遍历器，解释引擎将会报错。 如果Symbol.iterator方法对应的不是遍历器生成函数（即会返回一个遍历器对象），解释引擎将会报错。
```javascript ```javascript
var obj = {}; var obj = {};
@ -243,9 +243,9 @@ obj[Symbol.iterator] = () => 1;
[...obj] // TypeError: [] is not a function [...obj] // TypeError: [] is not a function
``` ```
上面代码中，变量obj的Symbol.iterator方法返回的不是遍历器，因此报错。 上面代码中，变量obj的Symbol.iterator方法对应的不是遍历器生成函数，因此报错。
有了遍历器接口，数据结构就可以用for...of循环遍历（详见下文），也可以使用while循环遍历。 有了遍历器接口，数据结构就可以用`for...of`循环遍历（详见下文），也可以使用while循环遍历。
```javascript ```javascript
var $iterator = ITERABLE[Symbol.iterator](); var $iterator = ITERABLE[Symbol.iterator]();
@ -257,7 +257,7 @@ while (!$result.done) {
} }
``` ```
上面代码中，ITERABLE代表某种可遍历的数据结构，$iterator是它的遍历器。遍历器每次移动指针（next方法），都检查一下返回值的done属性，如果遍历还没结束，就移动遍历器的指针到下一步（next方法），不断循环。 上面代码中，ITERABLE代表某种可遍历的数据结构，$iterator是它的遍历器对象。遍历器对象每次移动指针（next方法），都检查一下返回值的done属性，如果遍历还没结束，就移动遍历器对象的指针到下一步（next方法），不断循环。
## 调用默认Iterator接口的场合 ## 调用默认Iterator接口的场合
@ -332,7 +332,7 @@ iterator.next() // { value: undefined, done: true }
## 原生具备Iterator接口的数据结构 ## 原生具备Iterator接口的数据结构
《数组的扩展》一章中提到，ES6对数组提供entries()、keys()和values()三个方法，就是返回三个遍历器。 《数组的扩展》一章中提到，ES6对数组提供entries()、keys()和values()三个方法，就是返回三个遍历器对象。
```javascript ```javascript
var arr = [1, 5, 7]; var arr = [1, 5, 7];
@ -345,7 +345,7 @@ arrEntries === arrEntries[Symbol.iterator]()
// true // true
``` ```
上面代码中，entries方法返回的是一个遍历器（iterator），本质上就是调用了`Symbol.iterator`方法。 上面代码中，entries方法返回的是一个遍历器对象（iterator），本质上就是调用了`Symbol.iterator`方法。
字符串是一个类似数组的对象，也原生具有Iterator接口。 字符串是一个类似数组的对象，也原生具有Iterator接口。
@ -361,7 +361,7 @@ iterator.next() // { value: "i", done: false }
iterator.next() // { value: undefined, done: true } iterator.next() // { value: undefined, done: true }
``` ```
上面代码中，调用`Symbol.iterator`方法返回一个遍历器，在这个遍历器上可以调用next方法，实现对于字符串的遍历。 上面代码中，调用`Symbol.iterator`方法返回一个遍历器对象，在这个遍历器上可以调用next方法，实现对于字符串的遍历。
可以覆盖原生的`Symbol.iterator`方法，达到修改遍历器行为的目的。 可以覆盖原生的`Symbol.iterator`方法，达到修改遍历器行为的目的。
@ -422,26 +422,25 @@ for (let x of obj) {
上面代码中，`Symbol.iterator`方法几乎不用部署任何代码，只要用yield命令给出每一步的返回值即可。 上面代码中，`Symbol.iterator`方法几乎不用部署任何代码，只要用yield命令给出每一步的返回值即可。
## 遍历器的return()，throw() ## 遍历器对象的return()，throw()
遍历器返回的指针对象除了具有next方法，还可以具有return方法和throw方法。其中，next方法是必须部署的，return方法和throw方法是否部署是可选的。 遍历器对象除了具有next方法，还可以具有return方法和throw方法。如果你自己写遍历器生成函数，那么next方法是必须部署的，return方法和throw方法是否部署是可选的。
return方法的使用场合是，如果for...of循环提前退出（通常是因为出错，或者有break语句或continue语句），就会调用return方法。如果一个对象在完成遍历前，需要清理或释放资源，就可以部署return方法。 return方法的使用场合是，如果`for...of`循环提前退出（通常是因为出错，或者有break语句或continue语句），就会调用return方法。如果一个对象在完成遍历前，需要清理或释放资源，就可以部署return方法。
throw方法主要是配合Generator函数使用，一般的遍历器用不到这个方法。请参阅《Generator函数》一章。 throw方法主要是配合Generator函数使用，一般的遍历器对象用不到这个方法。请参阅《Generator函数》一章。
## for...of循环 ## for...of循环
ES6借鉴C++、Java、C#和Python语言，引入了for...of循环，作为遍历所有数据结构的统一的方法。一个数据结构只要部署了`Symbol.iterator`方法，就被视为具有iterator接口，就可以用for...of循环遍历它的成员。也就是说，for...of循环内部调用的是数据结构的`Symbol.iterator`方法。 ES6借鉴C++、Java、C#和Python语言，引入了`for...of`循环，作为遍历所有数据结构的统一的方法。一个数据结构只要部署了`Symbol.iterator`属性，就被视为具有iterator接口，就可以用`for...of`循环遍历它的成员。也就是说，`for...of`循环内部调用的是数据结构的`Symbol.iterator`方法。
for...of循环可以使用的范围包括数组、Set和Map结构、某些类似数组的对象（比如arguments对象、DOM NodeList对象）、后文的Generator对象，以及字符串。 for...of循环可以使用的范围包括数组、Set和Map结构、某些类似数组的对象（比如arguments对象、DOM NodeList对象）、后文的Generator对象，以及字符串。
### 数组 ### 数组
数组原生具备iterator接口，for...of循环本质上就是调用这个接口产生的遍历器，可以用下面的代码证明。 数组原生具备iterator接口，`for...of`循环本质上就是调用这个接口产生的遍历器，可以用下面的代码证明。
```javascript ```javascript
const arr = ['red', 'green', 'blue']; const arr = ['red', 'green', 'blue'];
let iterator = arr[Symbol.iterator](); let iterator = arr[Symbol.iterator]();
@ -452,28 +451,24 @@ for(let v of arr) {
for(let v of iterator) { for(let v of iterator) {
console.log(v); // red green blue console.log(v); // red green blue
} }
``` ```
上面代码的for...of循环的两种写法是等价的。 上面代码的`for...of`循环的两种写法是等价的。
for...of循环可以代替数组实例的forEach方法。 `for...of`循环可以代替数组实例的`forEach`方法。
```javascript ```javascript
const arr = ['red', 'green', 'blue']; const arr = ['red', 'green', 'blue'];
arr.forEach(function (element, index) { arr.forEach(function (element, index) {
console.log(element); // red green blue console.log(element); // red green blue
console.log(index); // 0 1 2 console.log(index); // 0 1 2
}); });
``` ```
JavaScript原有的for...in循环，只能获得对象的键名，不能直接获取键值。ES6提供for...of循环，允许遍历获得键值。 JavaScript原有的`for...in`循环，只能获得对象的键名，不能直接获取键值。ES6提供for...of循环，允许遍历获得键值。
```javascript ```javascript
var arr = ["a", "b", "c", "d"]; var arr = ["a", "b", "c", "d"];
for (a in arr) { for (a in arr) {
@ -483,17 +478,15 @@ for (a in arr) {
for (a of arr) { for (a of arr) {
console.log(a); // a b c d console.log(a); // a b c d
} }
``` ```
上面代码表明，for...in循环读取键名，for...of循环读取键值。如果要通过for...of循环，获取数组的索引，可以借助数组实例的entries方法和keys方法，参见《数组的扩展》章节。 上面代码表明，`for...in`循环读取键名，`for...of`循环读取键值。如果要通过`for...of`循环，获取数组的索引，可以借助数组实例的`entries`方法和`keys`方法，参见《数组的扩展》章节。
### Set和Map结构 ### Set和Map结构
Set和Map结构也原生具有Iterator接口，可以直接使用for...of循环。 Set和Map结构也原生具有Iterator接口，可以直接使用`for...of`循环。
```javascript ```javascript
var engines = Set(["Gecko", "Trident", "Webkit", "Webkit"]); var engines = Set(["Gecko", "Trident", "Webkit", "Webkit"]);
for (var e of engines) { for (var e of engines) {
console.log(e); console.log(e);
@ -512,13 +505,11 @@ for (var [name, value] of es6) {
// edition: 6 // edition: 6
// committee: TC39 // committee: TC39
// standard: ECMA-262 // standard: ECMA-262
``` ```
上面代码演示了如何遍历Set结构和Map结构。值得注意的地方有两个，首先，遍历的顺序是按照各个成员被添加进数据结构的顺序。其次，Set结构遍历时，返回的是一个值，而Map结构遍历时，返回的是一个数组，该数组的两个成员分别为当前Map成员的键名和键值。 上面代码演示了如何遍历Set结构和Map结构。值得注意的地方有两个，首先，遍历的顺序是按照各个成员被添加进数据结构的顺序。其次，Set结构遍历时，返回的是一个值，而Map结构遍历时，返回的是一个数组，该数组的两个成员分别为当前Map成员的键名和键值。
```javascript ```javascript
let map = new Map().set('a', 1).set('b', 2); let map = new Map().set('a', 1).set('b', 2);
for (let pair of map) { for (let pair of map) {
console.log(pair); console.log(pair);
@ -535,16 +526,15 @@ for (let [key, value] of map) {
### 计算生成的数据结构 ### 计算生成的数据结构
有些数据结构是在现有数据结构的基础上，计算生成的。比如，ES6的数组、Set、Map都部署了以下三个方法，调用后都返回遍历器。 有些数据结构是在现有数据结构的基础上，计算生成的。比如，ES6的数组、Set、Map都部署了以下三个方法，调用后都返回遍历器对象。
- entries() 返回一个遍历器，用来遍历 [键名, 键值] 组成的数组。对于数组，键名就是索引值；对于Set，键名与键值相同。Map结构的iterator接口，默认就是调用entries方法。 - `entries()` 返回一个遍历器对象，用来遍历`[键名, 键值]`组成的数组。对于数组，键名就是索引值；对于Set，键名与键值相同。Map结构的iterator接口，默认就是调用entries方法。
- keys() 返回一个遍历器，用来遍历所有的键名。 - `keys()` 返回一个遍历器对象，用来遍历所有的键名。
- values() 返回一个遍历器，用来遍历所有的键值。 - `values()` 返回一个遍历器对象，用来遍历所有的键值。
这三个方法调用后生成的遍历器，所遍历的都是计算生成的数据结构。 这三个方法调用后生成的遍历器对象，所遍历的都是计算生成的数据结构。
```javascript ```javascript
let arr = ['a', 'b', 'c']; let arr = ['a', 'b', 'c'];
for (let pair of arr.entries()) { for (let pair of arr.entries()) {
console.log(pair); console.log(pair);
@ -552,15 +542,13 @@ for (let pair of arr.entries()) {
// [0, 'a'] // [0, 'a']
// [1, 'b'] // [1, 'b']
// [2, 'c'] // [2, 'c']
``` ```
### 类似数组的对象 ### 类似数组的对象
类似数组的对象包括好几类。下面是for...of循环用于字符串、DOM NodeList对象、arguments对象的例子。 类似数组的对象包括好几类。下面是`for...of`循环用于字符串、DOM NodeList对象、arguments对象的例子。
```javascript ```javascript
// 字符串 // 字符串
let str = "hello"; let str = "hello";
@ -584,25 +572,21 @@ function printArgs() {
printArgs('a', 'b'); printArgs('a', 'b');
// 'a' // 'a'
// 'b' // 'b'
``` ```
对于字符串来说，for...of循环还有一个特点，就是会正确识别32位UTF-16字符。 对于字符串来说，`for...of`循环还有一个特点，就是会正确识别32位UTF-16字符。
```javascript ```javascript
for (let x of 'a\uD83D\uDC0A') { for (let x of 'a\uD83D\uDC0A') {
console.log(x); console.log(x);
} }
// 'a' // 'a'
// '\uD83D\uDC0A' // '\uD83D\uDC0A'
``` ```
并不是所有类似数组的对象都具有iterator接口，一个简便的解决方法，就是使用Array.from方法将其转为数组。 并不是所有类似数组的对象都具有iterator接口，一个简便的解决方法，就是使用Array.from方法将其转为数组。
```javascript ```javascript
let arrayLike = { length: 2, 0: 'a', 1: 'b' }; let arrayLike = { length: 2, 0: 'a', 1: 'b' };
// 报错 // 报错
@ -614,15 +598,13 @@ for (let x of arrayLike) {
for (let x of Array.from(arrayLike)) { for (let x of Array.from(arrayLike)) {
console.log(x); console.log(x);
} }
``` ```
### 对象 ### 对象
对于普通的对象，for...of结构不能直接使用，会报错，必须部署了iterator接口后才能使用。但是，这样情况下，for...in循环依然可以用来遍历键名。 对于普通的对象，`for...of`结构不能直接使用，会报错，必须部署了iterator接口后才能使用。但是，这样情况下，`for...in`循环依然可以用来遍历键名。
```javascript ```javascript
var es6 = { var es6 = {
edition: 6, edition: 6,
committee: "TC39", committee: "TC39",
@ -640,10 +622,9 @@ for (e of es6) {
console.log(e); console.log(e);
} }
// TypeError: es6 is not iterable // TypeError: es6 is not iterable
``` ```
上面代码表示，对于普通的对象，for...in循环可以遍历键名，for...of循环会报错。 上面代码表示，对于普通的对象，`for...in`循环可以遍历键名，`for...of`循环会报错。
一种解决方法是，使用`Object.keys`方法将对象的键名生成一个数组，然后遍历这个数组。 一种解决方法是，使用`Object.keys`方法将对象的键名生成一个数组，然后遍历这个数组。
@ -653,7 +634,7 @@ for (var key of Object.keys(someObject)) {
} }
``` ```
在对象上部署iterator接口的代码，参见本章前面部分。一个方便的方法是将数组的`Symbol.iterator`属性，直接赋值给其他对象的`Symbol.iterator`属性。比如，想要让for...of循环遍历jQuery对象，只要加上下面这一行就可以了。 在对象上部署iterator接口的代码，参见本章前面部分。一个方便的方法是将数组的`Symbol.iterator`属性，直接赋值给其他对象的`Symbol.iterator`属性。比如，想要让`for...of`环遍历jQuery对象，只要加上下面这一行就可以了。
```javascript ```javascript
jQuery.prototype[Symbol.iterator] = jQuery.prototype[Symbol.iterator] =
@ -695,9 +676,9 @@ myArray.forEach(function (value) {
}); });
``` ```
这种写法的问题在于，无法中途跳出forEach循环，break命令或return命令都不能奏效。 这种写法的问题在于，无法中途跳出`forEach`循环，break命令或return命令都不能奏效。
for...in循环可以遍历数组的键名。 `for...in`循环可以遍历数组的键名。
```javascript ```javascript
for (var index in myArray) { for (var index in myArray) {
@ -713,9 +694,9 @@ for...in循环有几个缺点。
3）某些情况下，for...in循环会以任意顺序遍历键名。 3）某些情况下，for...in循环会以任意顺序遍历键名。
总之，for...in循环主要是为遍历对象而设计的，不适用于遍历数组。 总之，`for...in`循环主要是为遍历对象而设计的，不适用于遍历数组。
for...of循环相比上面几种做法，有一些显著的优点。 `for...of`循环相比上面几种做法，有一些显著的优点。
```javascript ```javascript
for (let value of myArray) { for (let value of myArray) {
@ -727,7 +708,7 @@ for (let value of myArray) {
- 不同用于forEach方法，它可以与break、continue和return配合使用。 - 不同用于forEach方法，它可以与break、continue和return配合使用。
- 提供了遍历所有数据结构的统一操作接口。 - 提供了遍历所有数据结构的统一操作接口。
下面是一个使用break语句，跳出for...of循环的例子。 下面是一个使用break语句，跳出`for...of`循环的例子。
```javascript ```javascript
for (var n of fibonacci) { for (var n of fibonacci) {
@ -737,4 +718,4 @@ for (var n of fibonacci) {
} }
``` ```
上面的例子，会输出斐波纳契数列小于等于1000的项。如果当前项大于1000，就会使用break语句跳出for...of循环。 上面的例子，会输出斐波纳契数列小于等于1000的项。如果当前项大于1000，就会使用break语句跳出`for...of`循环。

2
docs/module.md
View File

@ -296,7 +296,7 @@ export { area as circleArea } from 'circle';
module math from "circleplus"; module math from "circleplus";
import exp from "circleplus"; import exp from "circleplus";
console.log(exp(math.PI)); console.log(exp(math.E));
``` ```
上面代码中的"import exp"表示，将circleplus模块的默认方法加载为exp方法。 上面代码中的"import exp"表示，将circleplus模块的默认方法加载为exp方法。