diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 000000000..86cf8936f --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,23 @@ +{ + // 使用 IntelliSense 了解相关属性。 + // 悬停以查看现有属性的描述。 + // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387 + "version": "0.2.0", + "configurations": [ + { + "name": "ts-node", + "type": "node", + "request": "launch", + "args": [ + "${relativeFile}" + ], + "runtimeArgs": [ + "-r", + "ts-node/register" + ], + "cwd": "${workspaceRoot}", + "protocol": "inspector", + "internalConsoleOptions": "openOnSessionStart" + } + ] +} \ No newline at end of file diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/01-\344\272\213\344\273\266\345\276\252\347\216\257.md" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/01-\344\272\213\344\273\266\345\276\252\347\216\257.md" new file mode 100644 index 000000000..6b6e08b8a --- /dev/null +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/01-\344\272\213\344\273\266\345\276\252\347\216\257.md" @@ -0,0 +1,115 @@ +# 事件循环 + +事件循环,在W3C中描述为 `Event Loop`,Chrome的实现源码中定义为 `Message Loop`,因此事件循环也称为消息循环,是**浏览器渲染主线程**的工作方式。 + + + +## 1. 浏览器的进程模型 + +浏览器是一个多进程多线程的应用程序,核心的进程是**浏览器进程**、**网络进程**、**渲染进程** + +**浏览器进程**:负责浏览器软件的UI界面显示、用户交互、子进程管理等。浏览器进程内部会启动多个线程处理不同任务。 + +**网络进程**:负责加载网络资源。 + +**渲染进程**:(重点) 渲染进程启动后,会开启一个**渲染主线程**,主线程负责执行 HTML、CSS、JS。默认情况下,浏览器会为每个标签页开启一个**新的渲染进程**,以保证标签页隔离 (未来可能改为一个站点一个进程)。 + + + +## 2. 渲染主线程的异步处理 + +渲染主线程是浏览器中最繁忙的线程,处理的任务包括但不限于: + ++ 解析 HTML ++ 解析 CSS ++ 计算样式 ++ 布局 ++ 处理图层 ++ 帧绘制 ++ 执行全局 JS 代码 ++ 执行事件处理函数 ++ 执行计时器的回调函数 ++ ...... + +JS运行在浏览器的单个渲染进程的渲染主线程中,而渲染主线程只有一个!注意,js的单线程,是因为执行在浏览器的渲染主线程,并不代表浏览器是单进程/线程的。 + +因此,JS是一门 **单线程** 的语言,浏览器采用异步而非同步的方式来避免阻塞,如计时器、网络、事件监听。 + +主线程将任务交给其他线程处理,完成后将事先传递的回调函数包装成任务,加入到消息队列的末尾排队,等待主线程调度执行。 + +**总结**: + +1. **单线程是异步产生的原因** + +2. **事件循环是异步的实现方式** + + + +**异步的场景**:`setTimeout`、`setInterval`、`XHR`、`Fetch`、`addEventListener` 等 + +![](./img/01-event_loop.jpg) + + + +## 3. JS 阻塞渲染 + +如下面的案例,虽然 h1 已经设置了 text 内容,但会在 3s 后才显示,因为 **JS执行和渲染都在浏览器的渲染主线程上执行**,在执行了 h1 内容设置后,向消息队列(message queue)中插入了新的渲染任务,但需要在 delay 完成后,渲染主线程才会执行渲染。 + +```javascript +var h1 = document.querySelector(...); +var btn = document.querySelector(...); + +// 死循环一段时间 +function delay(duration) { + var start = Date.now(); + while(Date.now() - start < duration) {} +} + +btn.onclick = function() { + h1.textContent = 'xxx'; + delay(3000); +} +``` + + + +## 4. 任务没有优先级,但消息队列有优先级 + +每个任务都有一个任务类型,同一类型的任务必须在一个队列,一个队列可能有多种类型的任务,在一次事件循环中,浏览器可以根据实际情况从不同的队列中取出任务执行。 + +浏览器必须准备好一个**微队列**(microTask),微队列中的任务优先于所有其他任务执行。 + +随着浏览器复杂度急剧提升,W3C不再使用宏队列的说法。 + +目前 chrome 中至少包含了以下队列: + ++ **微队列**:[最高] 存放需要最快执行的任务 ++ **交互队列**:[高] 存放用户交互后产生的事件处理任务 ++ **延时队列**:[中] 存放定时器回调 + +添加任务到微队列的方式主要为:`Promise`、`MutationObserver`,如 + +```javascript +// 立即添加函数到微队列 +Promise.resolve().then(函数) +``` + +案例: + +```javascript +function delay(duration) { + var start = Date.now(); + while(Date.now() - start < duration) {} +} +setTimeout(function() { // 添加到延迟队列 + console.log(1); +}, 0); +Promise.resolve().then(function() { // 添加到微队列 + console.log(2); +}); +delay(1000); // 死循环1s +console.log(3); // 当前任务中执行 +// 1s 后输出 3 2 1 +``` + + diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/02-\346\265\217\350\247\210\345\231\250\346\270\262\346\237\223\345\216\237\347\220\206.md" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/02-\346\265\217\350\247\210\345\231\250\346\270\262\346\237\223\345\216\237\347\220\206.md" new file mode 100644 index 000000000..fe6725d8e --- /dev/null +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/02-\346\265\217\350\247\210\345\231\250\346\270\262\346\237\223\345\216\237\347\220\206.md" @@ -0,0 +1,78 @@ +# 浏览器渲染原理 + +## 1. 渲染过程 + +![](./img/02.jpg) + +### 1.1 【解析 HTML】 为 DOM 和 CSSOM + +首先解析 HTML,解析过程中遇到 CSS 解析 CSS,遇到 JS 执行 JS。为提高解析效率,浏览器在开始解析前,会启动一个预解析线程,率先下载 HTML 中的外部 CSS 文件和 JS 文件。 + +若主线程解析到 link 位置时 CSS 文件还未下载解析完成则会跳过。因为下载和解析 CSS 是在预解析线程中进行的,所以 **CSS 不会阻塞渲染主线程对 HTML 的解析**。 + +主线程解析到 script 位置时会停止解析 HTML,等待 JS 文件下载结束,并将全局代码解析执行完成后,才继续解析 HTML。这是因为 JS 代码的执行过程可能会修改当前的 DOM 树,所以 DOM 树的生成必须暂停,所以 **JS 会阻塞渲染主线程对 HTML 的解析**。 + +解析 HTML 完成后,会得到 **DOM 树** 和 **CSSOM 树**,浏览器的默认样式、内部样式、外部样式、行内样式均会包含在 CSSOM 树中。 + +### 1.2 【样式计算】得到带样式的 DOM + +主线程会遍历得到的 DOM 树,依次为树中的每个节点计算出最终样式,称之为 **Computed Style**。在此过程中,很多预设值会变成绝对值,比如 red 会变成 rgb(255,0,0); 相对单位会变成绝对单位,比如 em 会变成 px。 + +样式计算完成后,会得到一棵带有样式的 DOM 树。 + +> js 操作 stylesheet +> +> ```javascript +> document.styleSheets +> getComputedStyle(document.body) +> ``` + +### 1.3 【布局】生成 layout 布局树 + +布局阶段会依次遍历 DOM 树的每一个节点,计算每个节点的几何信息,如节点的宽高、相对包含块的位置。 + +大部分时候,DOM 树和布局树并非一一对应。比如 `display:none` 节点不会生成到布局树;比如使用了伪元素选择器,虽然 DOM 树中不存在这些伪元素节点,但它们拥有几何信息,所以会生成到布局树中;还有匿名行盒、匿名块盒等等都会导致 DOM 树和布局树无法一一对应。 + +![](./img/03.jpg) + +### 1.4 【分层】 + +主线程会使用一套复杂的策略对整个布局树进行分层。分层会影响后续的布局树变化的处理,当某层变动只改某层能提升性能,但层次过多也会消耗性能。滚动条、堆叠上下文、transform、opacity 等样式都会或多或少的影响分层结果,可以通过 `will-change` 属性更大程度的影响分层结果,如在css中添加 `will-change: transform` 属性告诉浏览器将来 transform 可能变化,由浏览器决定是否分层。 + +### 1.5 【绘制】生成绘制指令集传递给合成线程 + +主线程会为每个层单独生成绘制指令集,完成后主线程将每个图层的绘制信息提交给合成线程,剩余工作将由合成线程完成。 + +### 1.6 【分块】合成线程分块 + +合成线程首先将每个图层划分为更多的小区域,它会从线程池中拿取多个线程来完成分块工作。 + +### 1.7 【光栅化】GPU光栅化 + +合成线程会将块信息交给 GPU 进程,GPU 进程会开启多个线程极速完成光栅化,得到一块一块的位图,默认会优先处理靠近视口区域的块。 + +### 1.8 【draw】合成线程根据位图生成指引并由GPU绘制到屏幕 + +合成线程拿到每个层、每个块的位图后,生成一个个"指引(quad)"信息,用于标识出每个位图在屏幕的绘制位置,以及旋转、缩放等变形的处理。 + +由于 `transform` 变形发生在合成线程,与渲染主线程无关,所以效率高。 + +最后合成线程会把 quad 提交给 GPU 进程,由 GPU 进程产生系统调用,提交给 GPU 硬件,完成最终的屏幕成像。 + + + +## 2. transform 高效的原因 + +如前面说述,transform 既不影响布局也不影响绘制指令,只影响渲染流程最后的绘制阶段。由于 draw 阶段在合成线程中,所以 transform 的变化几乎不会影响忙碌的渲染主线程。 + + + +## 3. reflow(重排) & repaint(重绘) + +`reflow`:当进行了影响布局树的操作后,需要重新计算 layout 布局树。浏览器会合并布局属性的修改操作,当 JS 代码全部完成后再异步统一计算。但为了让 JS 获取布局属性时取到最新的布局信息,在获取属性时会立即 reflow。 + +`repaint`:当修改了可见样式后需要重新计算绘制指令。 + +由于元素的布局信息也属于可见样式,所以 **reflow 一定会引起 repaint**,要尽量减少 reflow。 + +![](./img/04.jpg) diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/03-\345\261\236\346\200\247\346\217\217\350\277\260\347\254\246.md" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/03-\345\261\236\346\200\247\346\217\217\350\277\260\347\254\246.md" new file mode 100755 index 000000000..19db7be31 --- /dev/null +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/03-\345\261\236\346\200\247\346\217\217\350\277\260\347\254\246.md" @@ -0,0 +1,62 @@ +# 属性描述符 + +## 1. 属性描述符的获取与设置 + +```javascript +var obj = { a: 1, b: 2 }; + +// 获取属性描述符 +Object.getOwnPropertyDescriptor(obj, 'a'); +// { value: 1, writable: true, enumerable: true, configurable: true } + +// 设置属性描述符 +Object.defineProperty(obj, 'a', { + // value: 3, // Cannot both specify accessors and a value or writable attribute + // writable: false, // 不可重写 + enumerable: false, // 不可遍历 + configurable: false, // 属性描述符不可再修改 + get: function() { // getter + return 4; + }, + set: function() { // setter + throw new Error('属性只读'); + }, +}); +``` + +## 2. 案例:属性描述符的应用 + +```javascript +class Demo { + constructor (g) { + g = { ...g }; + Object.freeze(g); //【1】clone后冻结,避免改变原对象 + Object.defineProperty(this, 'data', { + get: function() { + return g; + }, + set: function() { + throw new Error('data 属性只读'); + }, + configurable: false, // 属性描述符不可再修改 + }); + + this.testForFreeze = 1; + // Object.freeze(this); //【2】冻结,但也会影响现有的属性方法 + Object.seal(this); //【3】密封,不能给对象添加/删除属性和方法,不能修改现有属性和方法的配置 + } +} + +var g = new Demo({ + price: 1, +}); + +g.data.price = 2; +g.testForFreeze = 2; // Object.freeze 后不会生效,但 Object.seal 不影响 +g.testForSeal = 2; // Object.freeze 和 Object.seal 后都不会生效 + +Object.freeze(Demo.prototype); //【4】冻结原型链 +Demo.prototype.testForPrototype = 1; +console.log(g.testForPrototype); // undefined +``` + diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/04-CSS\345\214\205\345\220\253\345\235\227.md" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/04-CSS\345\214\205\345\220\253\345\235\227.md" new file mode 100644 index 000000000..330dde7dc --- /dev/null +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/04-CSS\345\214\205\345\220\253\345\235\227.md" @@ -0,0 +1,132 @@ +# CSS包含块 + +元素的尺寸和位置,会受它的包含块影响。对于一些属性,例如 width, height, padding, margin,当绝对定位元素(position: absolute/fixed)的偏移值为百分比值时,由元素的包含块计算得来。 + +包含块分两种: + ++ **初始包含块(initial containing block)**,即根元素(HTML元素)所在的包含块,浏览器中等于视口 viewport 大小,定位基点在画布原点(视口左上角)。 + ++ **非根元素包含块**,判定方式分以下规则: + +1. 元素 `position: relative/static`,包含块为最近的**块容器** (block container) 的**内容区域**(content area) + +2. 元素 `position: fixed`,包含块为视口 + +3. 元素 `position: absolute`,包含块为最近的 `position` 的值非 `static` (即值为 `fixed`/`absolute`/`relative`/`sticky`) 的祖先元素的内边距区域 + +案例: + +```html + +
+
+
+
+
+ +``` + +`div.item2` 的包含块为 `div.container` 而非 `div.item`。 + +此外,对于非根元素,包含块还有一种规则:元素 `position: absolute/fixed`,包含块也可能为满足以下条件的最近父级元素的内边距区域: + +- `transform` 或 `perspective` 值不为 `none` +- `will-change: transform/perspective;` +- `filter` 值不为 `none` 或 `will-change: filter;`(仅 Firefox) +- `contain: paint;` + +案例: + +```html + +
+
+
+
+
+ +``` + +此时,`div.item2` 的包含块为 `div.item`。 + + + +CSS 规范中所举的例子如下: + +```html + + + Illustration of containing blocks + + +
+

This is text in the first paragraph...

+

+ This is text + + in the + second + paragraph. + +

+
+ + +``` + +在没有添加任何 CSS 代码的情况下,元素对应的包含块为: + +| 元素 | 包含块 | 参照规则 | 说明 | +| ------- | --------------------------- | -------- | ------------------ | +| html | initial C.B. (UA-dependent) | 0 | | +| body | html | 1 | | +| div1 | body | 1 | | +| p1 | div1 | 1 | | +| p2 | div1 | 1 | | +| em1 | p2 | 1 | | +| strong1 | **p2** | 1 | 最近块容器的内容区 | + +接下来添加如下 CSS: + +```css +#div1 { + position: absolute; + left: 50px; +} +``` + +变化如下: + +| 元素 | 包含块 | 参照规则 | 说明 | +| ---- | --------------------------- | -------- | -------------------------------- | +| div1 | initial C.B. (UA-dependent) | 3 | 最近的非static祖先元素内边距区域 | + +继续修改 CSS: + +```css +#div1 { + position: absolute; + left: 50px; +} +#em1 { + position: absolute; + left: 100px; +} +``` + +变化如下: + +| 元素 | 包含块 | 参照规则 | 说明 | +| ------- | --------------------------- | -------- | -------------------------------- | +| div1 | initial C.B. (UA-dependent) | | | +| em1 | div1 | 3 | 最近的非static祖先元素内边距区域 | +| strong1 | em1 | 1 | 最近块容器的内容区 | + +其他参考案例:*https://developer.mozilla.org/zh-CN/docs/Web/CSS/Containing_block* + + + + + + + diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/05-\350\264\255\347\211\251\350\275\246\345\212\250\347\224\273.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/05-\350\264\255\347\211\251\350\275\246\345\212\250\347\224\273.html" new file mode 100755 index 000000000..53a7eee38 --- /dev/null +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/05-\350\264\255\347\211\251\350\275\246\345\212\250\347\224\273.html" @@ -0,0 +1,162 @@ + + + + + + 购物车动画 + + + +
+ + + + \ No newline at end of file diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/06-vue\344\274\230\345\214\226.md" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/06-vue\344\274\230\345\214\226.md" new file mode 100755 index 000000000..ed7a9059f --- /dev/null +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/06-vue\344\274\230\345\214\226.md" @@ -0,0 +1,154 @@ +# vue优化 + +## 1. 使用key + +为循环生成的列表指定稳定且唯一的key,减少删除、新增、改动元素 + + + +## 2. 使用冻结的对象 + +使用 chrome 性能工具分析,若在 Main 渲染主线程中黄色的js响应化执行时间过长,可以使用冻结避免对象响应化。 + +```javascript +var obj = { a: 1, b: 2 } +Object.freeze(obj); +obj.a = 3; +console.log(obj.a); // 1 +Object.isFrozen(obj); // true + +// 在vue中使用 + +export default { + data() { + frozenData: [] + }, + methods: { + setData() { + var obj = {}; + ... + this.frozenData = Object.freeze(obj); // 避免了 proxySetter + } + } +} +``` + + + +## 3. 使用函数式组件 + +[函数式组件](https://v2.cn.vuejs.org/v2/guide/render-function.html#%E5%87%BD%E6%95%B0%E5%BC%8F%E7%BB%84%E4%BB%B6),主要减少内存占用,不会调用 `new VueComponent`,不会出现在组件树中 + +添加 `functional: true` 配置,用于纯渲染组件,无data,只有props + + + +## 4. 使用计算属性和变量本地化 + +缓存在模板中多次使用的数据,可以使用计算属性,因为会自动缓存,对于会多次引用的变量可以保存起来,减少 `this.xxx` 的使用,减少依赖收集次数。因为响应式对象每次使用 `this.xxx` 都会触发 `getter`,然后执行依赖收集的相关代码 + + + +## 5. 非实时绑定的表单项 + +在没有必要使用 `v-model` (oninput)时使用 `v-model.lazy` (onchange) 或使用单向 value 代替 + + + +## 6. 保持对象引用稳定 + +尽量避免上层组件的数据变动,vue的判定变化源码: + +```javascript +function hasChanged(x, y) { + if (x === y) { + return x === 0 && 1 / x !== 1 / y; // +0 === -0 为 true,但 1/+0=Infinity, 1/-0=-Infinity,所以 1/+!==1/-0 + } else { + return x === x || y === y; // 不能直接返回 true,因为 NaN === NaN 为 false,x === x 可以排除 NaN + } +} +``` + +也要注意细分组件避免多余的渲染 + + + +## 7. v-show 替代 v-if + +对于内部包含大量dom节点的元素效果明显 + + + +## 8. 使用延迟装载(defer) + +对于重组件,初始化时分批绘制,在重组件上使用 `v-if="defer(n)"` 表示在第n帧后绘制。 + +defer函数记录当前执行 `requestAnimationFrame` 的次数 + + + +## 9. 子组件分割 + +对于耗费性能的部分可以分割为子组件,在子组件内部未发生变化时,不会触发耗费性能的逻辑执行。 + +```vue + + +``` + + + +## 10. 第三方插件按需引入 + + + +## 11. 路由懒加载 + +```javascript +const router = new VueRouter({ + routes: [ + { path: '/home', component: () => import('@/components/Home') }, + { path: '/login', component: require('@/components/Home').default } + ] +}); +``` + + + +## 12. 使用 keep-alive + +在路由来回跳转时,可以通过内置组件 `` 来把组件缓存起来,在组件切换的时候不进行卸载,提升性能 + +- 也可以用 `include/exclude` 来 缓存/不缓存 指定组件 +- 可通过两个生命周期 `activated/deactivated` 来获取当前组件状态 + + + +## 10. 长列表优化 + +根据索引,只渲染可视区域的dom元素 + + + +## 11. 打包体积优化 + + + + + + + + + diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/01-event_loop.jpg" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/01-event_loop.jpg" new file mode 100644 index 000000000..a01027c6f Binary files /dev/null and "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/01-event_loop.jpg" differ diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/02.jpg" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/02.jpg" new file mode 100644 index 000000000..d7a98e857 Binary files /dev/null and "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/02.jpg" differ diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/03.jpg" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/03.jpg" new file mode 100644 index 000000000..1b0e95dd4 Binary files /dev/null and "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/03.jpg" differ diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/04.jpg" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/04.jpg" new file mode 100644 index 000000000..8178427d7 Binary files /dev/null and "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/04.jpg" differ diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/img.pptx" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/img.pptx" new file mode 100755 index 000000000..a740cba95 Binary files /dev/null and "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/2023\345\274\272\345\214\226/img/img.pptx" differ diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\346\240\274\345\274\217\345\244\204\347\220\206/01-\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\346\240\274\345\274\217\345\244\204\347\220\206/01-\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.html" index 03cd0332d..368e2b1db 100644 --- "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\346\240\274\345\274\217\345\244\204\347\220\206/01-\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.html" +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\346\240\274\345\274\217\345\244\204\347\220\206/01-\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.html" @@ -7,28 +7,34 @@ \ No newline at end of file diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/06-\344\274\252\346\225\260\347\273\204.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/06-\344\274\252\346\225\260\347\273\204.html" index 3197fd1da..426b2e47a 100644 --- "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/06-\344\274\252\346\225\260\347\273\204.html" +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/06-\344\274\252\346\225\260\347\273\204.html" @@ -1,3 +1,10 @@ + @@ -6,6 +13,9 @@ \ No newline at end of file diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Number.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Number.html" index f89fbfa62..a16ddafe8 100644 --- "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Number.html" +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Number.html" @@ -45,6 +45,26 @@ console.log(Number.NaN);//NaN console.log(Number.constructor);//function Function() { [native code] } console.log(Number.prototype);//Number {[[PrimitiveValue]]: 0} +/** + * 属性 (es6) + */ +// Number.EPSILON 极小的常量,表示 1 与大于 1 的最小浮点数之间的差 +// MAX_SAFE_INTEGER / MIN_SAFE_INTEGER 最大/最小安全整数 + +// Number.EPSILON +// 极小的常量,表示 1 与大于 1 的最小浮点数之间的差,实际上是 JavaScript 能够表示的最小精度 +// 它的值接近于 2.2204460492503130808472633361816E-16,或者 2-52 +0.1 + 0.2 === 0.3; // false +equal = (Math.abs(0.1 - 0.3 + 0.2) < Number.EPSILON); // true 在误差范围内即视为相等 + +// MAX_SAFE_INTEGER / MIN_SAFE_INTEGER 最大/最小安全整数 +// 安全整数表示在 JavaScript 中能够精确表示的整数,安全整数的范围在 2 的 -53 次方到 2 的 53 次方之间(不包括两个端点),超过这个范围的整数无法精确表示 +// 最大安全整数,2^53-1 +Number.MAX_SAFE_INTEGER + 1 === Number.MAX_SAFE_INTEGER + 2; // true +Number.MAX_SAFE_INTEGER === Number.MAX_SAFE_INTEGER + 1; // false +// 最小安全整数,-(2^53-1) +Number.MIN_SAFE_INTEGER + 1 === Number.MIN_SAFE_INTEGER + 2; // false +Number.MIN_SAFE_INTEGER === Number.MIN_SAFE_INTEGER - 1; // false /** * isNaN @@ -86,6 +106,38 @@ console.log(Number(7777).toPrecision(5));//7777.0 var str = num.toString(2); // 二进制 console.log(str); // 11.00100100001111110011111000000011011100001100110111 +/** + * 方法 (es6) + */ +// Number.isFinite() 检查一个数值是否为有限(finite),即不是Infinity +// Number.isNaN() 检查一个值是否为NaN +// Number.parseInt() 和全局方法相同,用于全局变量的模块化 +// Number.parseFloat() 和全局方法相同,用于全局变量的模块化 +// Number.isInteger() 判断一个数值是否为整数 +// Number.isSafeInteger() 判断一个整数是否在安全范围内 +Number.isFinite(0.8); // true +Number.isFinite(NaN); // false +Number.isFinite(Infinity); // false +Number.isFinite(-Infinity); // false +Number.isFinite('15'); // false +Number.isFinite(true); // false +Number.isNaN(NaN) // true +Number.isNaN(15) // false +Number.isNaN('15') // false +Number.isNaN(true) // false +Number.isNaN(9/NaN) // true +Number.isNaN('true' / 0) // true +Number.isNaN('true' / 'true') // true +Number.parseInt === parseInt // true +Number.parseFloat === parseFloat // true + +/** + * 进制 (es6) + * 二进制表示法新写法: 前缀 0b 或 0B + * 八进制表示法新写法: 前缀 0o 或 0O + */ +0b111110111 === 503 // true 二进制0b +0o767 === 503 // true 八进制0o /** * 类型转换,转换成数字 diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Object.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Object.html" index 2cabf3650..4725619ba 100644 --- "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Object.html" +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/Object.html" @@ -8,6 +8,7 @@ \ No newline at end of file diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/arguments.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/arguments.html" index 84d4a8f06..4050c6a83 100644 --- "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/arguments.html" +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\346\225\260\346\215\256\347\261\273\345\236\213\344\270\216\350\275\254\346\215\242/arguments.html" @@ -1,3 +1,10 @@ + @@ -7,17 +14,6 @@ //函数内部的一个对象 arguments //当函数调用的时候,系统会将所有传入的实参,依次存入这个数组对象 -//【要求】允许函数调用时传入任意个数参数,并且函数返回这些数字中最大的数字 -function max(){ - // console.log(arguments); - var maxNum = arguments[0]; - for (var i = 1; i < arguments.length; i++) { - maxNum = maxNum > arguments[i] ? maxNum :arguments[i]; - } - return maxNum; -} -console.log(max(1, 2, 34, 5, 6));//34 - //【要求】数组去重 var distinct = new Function(` var arr = []; @@ -30,6 +26,31 @@ `); console.log(distinct(1, 2, 34, 34, 5, 5));//[1, 2, 34, 5] +/** + * 默认参数表达式 & 参数长度 + */ +function f (x, y = 7, z = x + y) { // 默认参数表达式 + console.log(arguments.length) // 4 传入的参数个数,和形参无关 + console.log(f.length) // 1 第一个带默认参数前的参数个数 + return x * 10 + z +} +console.log(f(1, undefined, 3, 4)) // 13 + +/** + * 参数遍历 + */ +function sum () { + let num = 0 + Array.prototype.forEach.call(arguments, function (item) { + num += item * 2 + }) + Array.from(arguments).forEach(function (item) { + num += item * 2 + }) + return num +} +console.log(sum(1,2,3)) // 24 + diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\350\257\255\350\250\200\347\211\271\346\200\247/07-\344\275\234\347\224\250\345\237\237.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\350\257\255\350\250\200\347\211\271\346\200\247/07-\344\275\234\347\224\250\345\237\237.html" index 000c90fb4..e7da2b31b 100644 --- "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\350\257\255\350\250\200\347\211\271\346\200\247/07-\344\275\234\347\224\250\345\237\237.html" +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\350\257\255\350\250\200\347\211\271\346\200\247/07-\344\275\234\347\224\250\345\237\237.html" @@ -4,6 +4,13 @@ Title - - - -
-
-

-

- - \ No newline at end of file diff --git "a/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\351\253\230\347\272\247\347\211\271\346\200\247/03-\344\270\212\344\270\213\346\226\207\350\260\203\347\224\250\346\250\241\345\274\217call&apply&bind.html" "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\351\253\230\347\272\247\347\211\271\346\200\247/03-\344\270\212\344\270\213\346\226\207\350\260\203\347\224\250\346\250\241\345\274\217call&apply&bind.html" new file mode 100644 index 000000000..e564ab07b --- /dev/null +++ "b/01-JS\350\257\255\350\250\200\345\237\272\347\241\200/\351\253\230\347\272\247\347\211\271\346\200\247/03-\344\270\212\344\270\213\346\226\207\350\260\203\347\224\250\346\250\241\345\274\217call&apply&bind.html" @@ -0,0 +1,114 @@ + + + + +Title + + + + + +
+
+

+

+ + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/01-let&const.html" "b/02-ES\346\226\260\347\211\271\346\200\247/01-let&const.html" new file mode 100644 index 000000000..cae7957e3 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/01-let&const.html" @@ -0,0 +1,50 @@ + + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/02-\350\247\243\346\236\204\350\265\213\345\200\274.html" "b/02-ES\346\226\260\347\211\271\346\200\247/02-\350\247\243\346\236\204\350\265\213\345\200\274.html" new file mode 100644 index 000000000..9a4ac7881 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/02-\350\247\243\346\236\204\350\265\213\345\200\274.html" @@ -0,0 +1,82 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/03-Symbol.html" "b/02-ES\346\226\260\347\211\271\346\200\247/03-Symbol.html" new file mode 100644 index 000000000..07bdf1095 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/03-Symbol.html" @@ -0,0 +1,107 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/04-Map&Set.html" "b/02-ES\346\226\260\347\211\271\346\200\247/04-Map&Set.html" new file mode 100644 index 000000000..3ff0bc29b --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/04-Map&Set.html" @@ -0,0 +1,153 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/05-Proxy.html" "b/02-ES\346\226\260\347\211\271\346\200\247/05-Proxy.html" new file mode 100644 index 000000000..1e8c61cfb --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/05-Proxy.html" @@ -0,0 +1,155 @@ + + + + + + + + + es6 + + + + 详细 api 参考 Reflect & Proxy + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/05-Reflect&Proxy.html" "b/02-ES\346\226\260\347\211\271\346\200\247/05-Reflect&Proxy.html" new file mode 100644 index 000000000..8d4ba8cb4 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/05-Reflect&Proxy.html" @@ -0,0 +1,521 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/05-Reflect.html" "b/02-ES\346\226\260\347\211\271\346\200\247/05-Reflect.html" new file mode 100644 index 000000000..fdaad880f --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/05-Reflect.html" @@ -0,0 +1,91 @@ + + + + + + + + + es6 + + + + 详细 api 参考 Reflect & Proxy + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/06-String\345\255\227\347\254\246\344\270\262.html" "b/02-ES\346\226\260\347\211\271\346\200\247/06-String\345\255\227\347\254\246\344\270\262.html" new file mode 100644 index 000000000..04819b274 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/06-String\345\255\227\347\254\246\344\270\262.html" @@ -0,0 +1 @@ +见基础总结总结 \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/07-ES6\346\225\260\345\200\274.html" "b/02-ES\346\226\260\347\211\271\346\200\247/07-ES6\346\225\260\345\200\274.html" new file mode 100644 index 000000000..dd8913bd0 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/07-ES6\346\225\260\345\200\274.html" @@ -0,0 +1,8 @@ + +见基础总结 \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/08-Object\345\257\271\350\261\241.html" "b/02-ES\346\226\260\347\211\271\346\200\247/08-Object\345\257\271\350\261\241.html" new file mode 100644 index 000000000..8cfdccdc9 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/08-Object\345\257\271\350\261\241.html" @@ -0,0 +1,150 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/09-Array\346\225\260\347\273\204.html" "b/02-ES\346\226\260\347\211\271\346\200\247/09-Array\346\225\260\347\273\204.html" new file mode 100644 index 000000000..690bb8523 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/09-Array\346\225\260\347\273\204.html" @@ -0,0 +1,290 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/10-ES6\345\207\275\346\225\260.html" "b/02-ES\346\226\260\347\211\271\346\200\247/10-ES6\345\207\275\346\225\260.html" new file mode 100644 index 000000000..0610af9ad --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/10-ES6\345\207\275\346\225\260.html" @@ -0,0 +1,96 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/11-ES6-iterator\350\277\255\344\273\243\345\231\250.html" "b/02-ES\346\226\260\347\211\271\346\200\247/11-ES6-iterator\350\277\255\344\273\243\345\231\250.html" new file mode 100644 index 000000000..74a67b168 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/11-ES6-iterator\350\277\255\344\273\243\345\231\250.html" @@ -0,0 +1,192 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/12-ES6-Class\347\261\273.html" "b/02-ES\346\226\260\347\211\271\346\200\247/12-ES6-Class\347\261\273.html" new file mode 100644 index 000000000..99c08f55f --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/12-ES6-Class\347\261\273.html" @@ -0,0 +1,284 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/13-ES6\346\250\241\345\235\227.html" "b/02-ES\346\226\260\347\211\271\346\200\247/13-ES6\346\250\241\345\235\227.html" new file mode 100644 index 000000000..5928b157b --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/13-ES6\346\250\241\345\235\227.html" @@ -0,0 +1,81 @@ + + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/14-ES6-Promise\345\257\271\350\261\241.html" "b/02-ES\346\226\260\347\211\271\346\200\247/14-ES6-Promise\345\257\271\350\261\241.html" new file mode 100644 index 000000000..8d0c6c2af --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/14-ES6-Promise\345\257\271\350\261\241.html" @@ -0,0 +1,101 @@ + + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/15-ES6-Generator\345\207\275\346\225\260.html" "b/02-ES\346\226\260\347\211\271\346\200\247/15-ES6-Generator\345\207\275\346\225\260.html" new file mode 100644 index 000000000..3ebd635fd --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/15-ES6-Generator\345\207\275\346\225\260.html" @@ -0,0 +1,148 @@ + + + + + + +es6 + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/16-ES8-async\345\207\275\346\225\260.html" "b/02-ES\346\226\260\347\211\271\346\200\247/16-ES8-async\345\207\275\346\225\260.html" new file mode 100644 index 000000000..6a01abaa2 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/16-ES8-async\345\207\275\346\225\260.html" @@ -0,0 +1,51 @@ + + + + + + + +es + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/17-ES9-for-await-of.html" "b/02-ES\346\226\260\347\211\271\346\200\247/17-ES9-for-await-of.html" new file mode 100644 index 000000000..20f43f3bb --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/17-ES9-for-await-of.html" @@ -0,0 +1,86 @@ + + + + + + + +es + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/18-ES10-JSON.html" "b/02-ES\346\226\260\347\211\271\346\200\247/18-ES10-JSON.html" new file mode 100644 index 000000000..750664e5a --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/18-ES10-JSON.html" @@ -0,0 +1,24 @@ + + + + + + +es + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/19-ES10-BigInt.html" "b/02-ES\346\226\260\347\211\271\346\200\247/19-ES10-BigInt.html" new file mode 100644 index 000000000..53f27f37d --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/19-ES10-BigInt.html" @@ -0,0 +1,25 @@ + + + + + + +es + + + + + \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/.gitignore" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/.gitignore" deleted file mode 100644 index c8f50f7cd..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/.gitignore" +++ /dev/null @@ -1 +0,0 @@ -npm-debug.log diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/README.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/README.md" deleted file mode 100644 index 0dcb559b9..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/README.md" +++ /dev/null @@ -1,26 +0,0 @@ -# ECMAScript 6 入门 - -《ECMAScript 6 入门》是一本开源的 JavaScript 语言教程,全面介绍 ECMAScript 6 新引入的语法特性。 - -[![cover](images/cover_thumbnail.jpg)](images/cover-2nd.jpg) - -本书覆盖 ES6 与上一个版本 ES5 的所有不同之处,对涉及的语法知识给予详细介绍,并给出大量简洁易懂的示例代码。 - -本书为中级难度,适合已经掌握 ES5 的读者,用来了解这门语言的最新发展;也可当作参考手册,查寻新增的语法点。 - -全书已由电子工业出版社出版,目前是第二版,书名为《ES6 标准入门》。纸版是基于网站内容排版印刷的。 - -感谢张春雨编辑支持我将全书开源的做法。如果您认可这本书,建议购买纸版。这样可以使出版社不因出版开源书籍而亏钱,进而鼓励更多的作者开源自己的书籍。 - -- [京东](http://item.jd.com/11849235.html) -- [当当](http://product.dangdang.com/23840431.html) -- [亚马逊](http://www.amazon.cn/ES6-%E6%A0%87%E5%87%86%E5%85%A5%E9%97%A8-%E9%98%AE%E4%B8%80%E5%B3%B0/dp/B01A18WWAG/) -- [China-pub](http://product.china-pub.com/4904712) - -### 版权许可 - -本书采用“保持署名—非商用”创意共享4.0许可证。 - -只要保持原作者署名和非商用,您可以自由地阅读、分享、修改本书。 - -详细的法律条文请参见[创意共享](http://creativecommons.org/licenses/by-nc/4.0/)网站。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/css/normalize.css" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/css/normalize.css" deleted file mode 100644 index 3d9454653..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/css/normalize.css" +++ /dev/null @@ -1 +0,0 @@ -../app/bower_components/normalize-css/normalize.css \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/array.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/array.md" deleted file mode 100644 index f3626270b..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/array.md" +++ /dev/null @@ -1,499 +0,0 @@ -# 数组的扩展 - -## Array.from() - -`Array.from`方法用于将两类对象转为真正的数组:类似数组的对象(array-like object)和可遍历(iterable)的对象(包括ES6新增的数据结构Set和Map)。 - -下面是一个类似数组的对象,`Array.from`将它转为真正的数组。 - -```javascript -let arrayLike = { - '0': 'a', - '1': 'b', - '2': 'c', - length: 3 -}; - -// ES5的写法 -var arr1 = [].slice.call(arrayLike); // ['a', 'b', 'c'] - -// ES6的写法 -let arr2 = Array.from(arrayLike); // ['a', 'b', 'c'] -``` - -实际应用中,常见的类似数组的对象是DOM操作返回的NodeList集合,以及函数内部的`arguments`对象。`Array.from`都可以将它们转为真正的数组。 - -```javascript -// NodeList对象 -let ps = document.querySelectorAll('p'); -Array.from(ps).forEach(function (p) { - console.log(p); -}); - -// arguments对象 -function foo() { - var args = Array.from(arguments); - // ... -} -``` - -上面代码中,`querySelectorAll`方法返回的是一个类似数组的对象,只有将这个对象转为真正的数组,才能使用`forEach`方法。 - -只要是部署了Iterator接口的数据结构,`Array.from`都能将其转为数组。 - -```javascript -Array.from('hello') -// ['h', 'e', 'l', 'l', 'o'] - -let namesSet = new Set(['a', 'b']) -Array.from(namesSet) // ['a', 'b'] -``` - -上面代码中,字符串和Set结构都具有Iterator接口,因此可以被`Array.from`转为真正的数组。 - -如果参数是一个真正的数组,`Array.from`会返回一个一模一样的新数组。 - -```javascript -Array.from([1, 2, 3]) -// [1, 2, 3] -``` - -值得提醒的是,扩展运算符(`...`)也可以将某些数据结构转为数组。 - -```javascript -// arguments对象 -function foo() { - var args = [...arguments]; -} - -// NodeList对象 -[...document.querySelectorAll('div')] -``` - -扩展运算符背后调用的是遍历器接口(`Symbol.iterator`),如果一个对象没有部署这个接口,就无法转换。`Array.from`方法则是还支持类似数组的对象。所谓类似数组的对象,本质特征只有一点,即必须有`length`属性。因此,任何有`length`属性的对象,都可以通过`Array.from`方法转为数组,而此时扩展运算符就无法转换。 - -```javascript -Array.from({ length: 3 }); -// [ undefined, undefined, undefined ] -``` - -上面代码中,`Array.from`返回了一个具有三个成员的数组,每个位置的值都是`undefined`。扩展运算符转换不了这个对象。 - -对于还没有部署该方法的浏览器,可以用`Array.prototype.slice`方法替代。 - -```javascript -const toArray = (() => - Array.from ? Array.from : obj => [].slice.call(obj) -)(); -``` - -`Array.from`还可以接受第二个参数,作用类似于数组的`map`方法,用来对每个元素进行处理,将处理后的值放入返回的数组。 - -```javascript -Array.from(arrayLike, x => x * x); -// 等同于 -Array.from(arrayLike).map(x => x * x); - -Array.from([1, 2, 3], (x) => x * x) -// [1, 4, 9] -``` - -下面的例子是取出一组DOM节点的文本内容。 - -```javascript -let spans = document.querySelectorAll('span.name'); - -// map() -let names1 = Array.prototype.map.call(spans, s => s.textContent); - -// Array.from() -let names2 = Array.from(spans, s => s.textContent) -``` - -下面的例子将数组中布尔值为`false`的成员转为`0`。 - -```javascript -Array.from([1, , 2, , 3], (n) => n || 0) -// [1, 0, 2, 0, 3] -``` - -另一个例子是返回各种数据的类型。 - -```javascript -function typesOf () { - return Array.from(arguments, value => typeof value) -} -typesOf(null, [], NaN) -// ['object', 'object', 'number'] -``` - -如果`map`函数里面用到了`this`关键字,还可以传入`Array.from`的第三个参数,用来绑定`this`。 - -`Array.from()`可以将各种值转为真正的数组,并且还提供`map`功能。这实际上意味着,只要有一个原始的数据结构,你就可以先对它的值进行处理,然后转成规范的数组结构,进而就可以使用数量众多的数组方法。 - -```javascript -Array.from({ length: 2 }, () => 'jack') -// ['jack', 'jack'] -``` - -上面代码中,`Array.from`的第一个参数指定了第二个参数运行的次数。这种特性可以让该方法的用法变得非常灵活。 - -`Array.from()`的另一个应用是,将字符串转为数组,然后返回字符串的长度。因为它能正确处理各种Unicode字符,可以避免JavaScript将大于`\uFFFF`的Unicode字符,算作两个字符的bug。 - -```javascript -function countSymbols(string) { - return Array.from(string).length; -} -``` - -## Array.of() - -`Array.of`方法用于将一组值,转换为数组。 - -```javascript -Array.of(3, 11, 8) // [3,11,8] -Array.of(3) // [3] -Array.of(3).length // 1 -``` - -这个方法的主要目的,是弥补数组构造函数`Array()`的不足。因为参数个数的不同,会导致`Array()`的行为有差异。 - -```javascript -Array() // [] -Array(3) // [, , ,] -Array(3, 11, 8) // [3, 11, 8] -``` - -上面代码中,`Array`方法没有参数、一个参数、三个参数时,返回结果都不一样。只有当参数个数不少于2个时,`Array()`才会返回由参数组成的新数组。参数个数只有一个时,实际上是指定数组的长度。 - -`Array.of`基本上可以用来替代`Array()`或`new Array()`,并且不存在由于参数不同而导致的重载。它的行为非常统一。 - -```javascript -Array.of() // [] -Array.of(undefined) // [undefined] -Array.of(1) // [1] -Array.of(1, 2) // [1, 2] -``` - -`Array.of`总是返回参数值组成的数组。如果没有参数,就返回一个空数组。 - -`Array.of`方法可以用下面的代码模拟实现。 - -```javascript -function ArrayOf(){ - return [].slice.call(arguments); -} -``` - -## 数组实例的copyWithin() - -数组实例的`copyWithin`方法,在当前数组内部,将指定位置的成员复制到其他位置(会覆盖原有成员),然后返回当前数组。也就是说,使用这个方法,会修改当前数组。 - -```javascript -Array.prototype.copyWithin(target, start = 0, end = this.length) -``` - -它接受三个参数。 - -- target(必需):从该位置开始替换数据。 -- start(可选):从该位置开始读取数据,默认为0。如果为负值,表示倒数。 -- end(可选):到该位置前停止读取数据,默认等于数组长度。如果为负值,表示倒数。 - -这三个参数都应该是数值,如果不是,会自动转为数值。 - -```javascript -[1, 2, 3, 4, 5].copyWithin(0, 3) -// [4, 5, 3, 4, 5] -``` - -上面代码表示将从3号位直到数组结束的成员(4和5),复制到从0号位开始的位置,结果覆盖了原来的1和2。 - -下面是更多例子。 - -```javascript -// 将3号位复制到0号位 -[1, 2, 3, 4, 5].copyWithin(0, 3, 4) -// [4, 2, 3, 4, 5] - -// -2相当于3号位,-1相当于4号位 -[1, 2, 3, 4, 5].copyWithin(0, -2, -1) -// [4, 2, 3, 4, 5] - -// 将3号位复制到0号位 -[].copyWithin.call({length: 5, 3: 1}, 0, 3) -// {0: 1, 3: 1, length: 5} - -// 将2号位到数组结束,复制到0号位 -var i32a = new Int32Array([1, 2, 3, 4, 5]); -i32a.copyWithin(0, 2); -// Int32Array [3, 4, 5, 4, 5] - -// 对于没有部署TypedArray的copyWithin方法的平台 -// 需要采用下面的写法 -[].copyWithin.call(new Int32Array([1, 2, 3, 4, 5]), 0, 3, 4); -// Int32Array [4, 2, 3, 4, 5] -``` - -## 数组实例的find()和findIndex() - -数组实例的`find`方法,用于找出第一个符合条件的数组成员。它的参数是一个回调函数,所有数组成员依次执行该回调函数,直到找出第一个返回值为`true`的成员,然后返回该成员。如果没有符合条件的成员,则返回`undefined`。 - -```javascript -[1, 4, -5, 10].find((n) => n < 0) -// -5 -``` - -上面代码找出数组中第一个小于0的成员。 - -```javascript -[1, 5, 10, 15].find(function(value, index, arr) { - return value > 9; -}) // 10 -``` - -上面代码中,`find`方法的回调函数可以接受三个参数,依次为当前的值、当前的位置和原数组。 - -数组实例的`findIndex`方法的用法与`find`方法非常类似,返回第一个符合条件的数组成员的位置,如果所有成员都不符合条件,则返回`-1`。 - -```javascript -[1, 5, 10, 15].findIndex(function(value, index, arr) { - return value > 9; -}) // 2 -``` - -这两个方法都可以接受第二个参数,用来绑定回调函数的`this`对象。 - -另外,这两个方法都可以发现`NaN`,弥补了数组的`IndexOf`方法的不足。 - -```javascript -[NaN].indexOf(NaN) -// -1 - -[NaN].findIndex(y => Object.is(NaN, y)) -// 0 -``` - -上面代码中,`indexOf`方法无法识别数组的`NaN`成员,但是`findIndex`方法可以借助`Object.is`方法做到。 - -## 数组实例的fill() - -`fill`方法使用给定值,填充一个数组。 - -```javascript -['a', 'b', 'c'].fill(7) -// [7, 7, 7] - -new Array(3).fill(7) -// [7, 7, 7] -``` - -上面代码表明,`fill`方法用于空数组的初始化非常方便。数组中已有的元素,会被全部抹去。 - -`fill`方法还可以接受第二个和第三个参数,用于指定填充的起始位置和结束位置。 - -```javascript -['a', 'b', 'c'].fill(7, 1, 2) -// ['a', 7, 'c'] -``` - -上面代码表示,`fill`方法从1号位开始,向原数组填充7,到2号位之前结束。 - -## 数组实例的entries(),keys()和values() - -ES6提供三个新的方法——`entries()`,`keys()`和`values()`——用于遍历数组。它们都返回一个遍历器对象(详见《Iterator》一章),可以用`for...of`循环进行遍历,唯一的区别是`keys()`是对键名的遍历、`values()`是对键值的遍历,`entries()`是对键值对的遍历。 - -```javascript -for (let index of ['a', 'b'].keys()) { - console.log(index); -} -// 0 -// 1 - -for (let elem of ['a', 'b'].values()) { - console.log(elem); -} -// 'a' -// 'b' - -for (let [index, elem] of ['a', 'b'].entries()) { - console.log(index, elem); -} -// 0 "a" -// 1 "b" -``` - -如果不使用`for...of`循环,可以手动调用遍历器对象的`next`方法,进行遍历。 - -```javascript -let letter = ['a', 'b', 'c']; -let entries = letter.entries(); -console.log(entries.next().value); // [0, 'a'] -console.log(entries.next().value); // [1, 'b'] -console.log(entries.next().value); // [2, 'c'] -``` - -## 数组实例的includes() - -`Array.prototype.includes`方法返回一个布尔值,表示某个数组是否包含给定的值,与字符串的`includes`方法类似。该方法属于ES7,但Babel转码器已经支持。 - -```javascript -[1, 2, 3].includes(2); // true -[1, 2, 3].includes(4); // false -[1, 2, NaN].includes(NaN); // true -``` - -该方法的第二个参数表示搜索的起始位置,默认为0。如果第二个参数为负数,则表示倒数的位置,如果这时它大于数组长度(比如第二个参数为-4,但数组长度为3),则会重置为从0开始。 - -```javascript -[1, 2, 3].includes(3, 3); // false -[1, 2, 3].includes(3, -1); // true -``` - -没有该方法之前,我们通常使用数组的`indexOf`方法,检查是否包含某个值。 - -```javascript -if (arr.indexOf(el) !== -1) { - // ... -} -``` - -`indexOf`方法有两个缺点,一是不够语义化,它的含义是找到参数值的第一个出现位置,所以要去比较是否不等于-1,表达起来不够直观。二是,它内部使用严格相当运算符(===)进行判断,这会导致对`NaN`的误判。 - -```javascript -[NaN].indexOf(NaN) -// -1 -``` - -`includes`使用的是不一样的判断算法,就没有这个问题。 - -```javascript -[NaN].includes(NaN) -// true -``` - -下面代码用来检查当前环境是否支持该方法,如果不支持,部署一个简易的替代版本。 - -```javascript -const contains = (() => - Array.prototype.includes - ? (arr, value) => arr.includes(value) - : (arr, value) => arr.some(el => el === value) -)(); -contains(["foo", "bar"], "baz"); // => false -``` - -另外,Map和Set数据结构有一个`has`方法,需要注意与`includes`区分。 - -- Map结构的`has`方法,是用来查找键名的,比如`Map.prototype.has(key)`、`WeakMap.prototype.has(key)`、`Reflect.has(target, propertyKey)`。 -- Set结构的`has`方法,是用来查找值的,比如`Set.prototype.has(value)`、`WeakSet.prototype.has(value)`。 - -## 数组的空位 - -数组的空位指,数组的某一个位置没有任何值。比如,`Array`构造函数返回的数组都是空位。 - -```javascript -Array(3) // [, , ,] -``` - -上面代码中,`Array(3)`返回一个具有3个空位的数组。 - -注意,空位不是`undefined`,一个位置的值等于`undefined`,依然是有值的。空位是没有任何值,`in`运算符可以说明这一点。 - -```javascript -0 in [undefined, undefined, undefined] // true -0 in [, , ,] // false -``` - -上面代码说明,第一个数组的0号位置是有值的,第二个数组的0号位置没有值。 - -ES5对空位的处理,已经很不一致了,大多数情况下会忽略空位。 - -- `forEach()`, `filter()`, `every()` 和`some()`都会跳过空位。 -- `map()`会跳过空位,但会保留这个值 -- `join()`和`toString()`会将空位视为`undefined`,而`undefined`和`null`会被处理成空字符串。 - -```javascript -// forEach方法 -[,'a'].forEach((x,i) => console.log(i)); // 1 - -// filter方法 -['a',,'b'].filter(x => true) // ['a','b'] - -// every方法 -[,'a'].every(x => x==='a') // true - -// some方法 -[,'a'].some(x => x !== 'a') // false - -// map方法 -[,'a'].map(x => 1) // [,1] - -// join方法 -[,'a',undefined,null].join('#') // "#a##" - -// toString方法 -[,'a',undefined,null].toString() // ",a,," -``` - -ES6则是明确将空位转为`undefined`。 - -`Array.from`方法会将数组的空位,转为`undefined`,也就是说,这个方法不会忽略空位。 - -```javascript -Array.from(['a',,'b']) -// [ "a", undefined, "b" ] -``` - -扩展运算符(`...`)也会将空位转为`undefined`。 - -```javascript -[...['a',,'b']] -// [ "a", undefined, "b" ] -``` - -`copyWithin()`会连空位一起拷贝。 - -```javascript -[,'a','b',,].copyWithin(2,0) // [,"a",,"a"] -``` - -`fill()`会将空位视为正常的数组位置。 - -```javascript -new Array(3).fill('a') // ["a","a","a"] -``` - -`for...of`循环也会遍历空位。 - -```javascript -let arr = [, ,]; -for (let i of arr) { - console.log(1); -} -// 1 -// 1 -``` - -上面代码中,数组`arr`有两个空位,`for...of`并没有忽略它们。如果改成`map`方法遍历,空位是会跳过的。 - -`entries()`、`keys()`、`values()`、`find()`和`findIndex()`会将空位处理成`undefined`。 - -```javascript -// entries() -[...[,'a'].entries()] // [[0,undefined], [1,"a"]] - -// keys() -[...[,'a'].keys()] // [0,1] - -// values() -[...[,'a'].values()] // [undefined,"a"] - -// find() -[,'a'].find(x => true) // undefined - -// findIndex() -[,'a'].findIndex(x => true) // 0 -``` - -由于空位的处理规则非常不统一,所以建议避免出现空位。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/arraybuffer.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/arraybuffer.md" deleted file mode 100644 index 9f74d2905..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/arraybuffer.md" +++ /dev/null @@ -1,1110 +0,0 @@ -# 二进制数组 - -二进制数组(`ArrayBuffer`对象、`TypedArray`视图和`DataView`视图)是 JavaScript 操作二进制数据的一个接口。这些对象早就存在,属于独立的规格(2011年2月发布),ES6 将它们纳入了 ECMAScript 规格,并且增加了新的方法。 - -这个接口的原始设计目的,与 WebGL 项目有关。所谓WebGL,就是指浏览器与显卡之间的通信接口,为了满足 JavaScript 与显卡之间大量的、实时的数据交换,它们之间的数据通信必须是二进制的,而不能是传统的文本格式。文本格式传递一个32位整数,两端的 JavaScript 脚本与显卡都要进行格式转化,将非常耗时。这时要是存在一种机制,可以像 C 语言那样,直接操作字节,将4个字节的32位整数,以二进制形式原封不动地送入显卡,脚本的性能就会大幅提升。 - -二进制数组就是在这种背景下诞生的。它很像C语言的数组,允许开发者以数组下标的形式,直接操作内存,大大增强了JavaScript处理二进制数据的能力,使得开发者有可能通过JavaScript与操作系统的原生接口进行二进制通信。 - -二进制数组由三类对象组成。 - -**(1)`ArrayBuffer`对象**:代表内存之中的一段二进制数据,可以通过“视图”进行操作。“视图”部署了数组接口,这意味着,可以用数组的方法操作内存。 - -**(2)TypedArray视图**:共包括9种类型的视图,比如`Uint8Array`(无符号8位整数)数组视图, `Int16Array`(16位整数)数组视图, `Float32Array`(32位浮点数)数组视图等等。 - -**(3)`DataView`视图**:可以自定义复合格式的视图,比如第一个字节是Uint8(无符号8位整数)、第二、三个字节是Int16(16位整数)、第四个字节开始是Float32(32位浮点数)等等,此外还可以自定义字节序。 - -简单说,`ArrayBuffer`对象代表原始的二进制数据,TypedArray视图用来读写简单类型的二进制数据,`DataView`视图用来读写复杂类型的二进制数据。 - -TypedArray视图支持的数据类型一共有9种(`DataView`视图支持除`Uint8C`以外的其他8种)。 - -数据类型 | 字节长度 | 含义 | 对应的C语言类型 ---------|--------|----|--------------- -Int8|1|8位带符号整数|signed char -Uint8|1|8位不带符号整数|unsigned char -Uint8C|1|8位不带符号整数(自动过滤溢出)|unsigned char -Int16|2|16位带符号整数|short -Uint16|2|16位不带符号整数|unsigned short -Int32|4|32位带符号整数|int -Uint32|4|32位不带符号的整数|unsigned int -Float32|4|32位浮点数|float -Float64|8|64位浮点数|double - -注意,二进制数组并不是真正的数组,而是类似数组的对象。 - -很多浏览器操作的API,用到了二进制数组操作二进制数据,下面是其中的几个。 - -- File API -- XMLHttpRequest -- Fetch API -- Canvas -- WebSockets - -## ArrayBuffer对象 - -### 概述 - -`ArrayBuffer`对象代表储存二进制数据的一段内存,它不能直接读写,只能通过视图(TypedArray视图和`DataView`视图)来读写,视图的作用是以指定格式解读二进制数据。 - -`ArrayBuffer`也是一个构造函数,可以分配一段可以存放数据的连续内存区域。 - -```javascript -var buf = new ArrayBuffer(32); -``` - -上面代码生成了一段32字节的内存区域,每个字节的值默认都是0。可以看到,`ArrayBuffer`构造函数的参数是所需要的内存大小(单位字节)。 - -为了读写这段内容,需要为它指定视图。`DataView`视图的创建,需要提供`ArrayBuffer`对象实例作为参数。 - -```javascript -var buf = new ArrayBuffer(32); -var dataView = new DataView(buf); -dataView.getUint8(0) // 0 -``` - -上面代码对一段32字节的内存,建立`DataView`视图,然后以不带符号的8位整数格式,读取第一个元素,结果得到0,因为原始内存的`ArrayBuffer`对象,默认所有位都是0。 - -另一种TypedArray视图,与`DataView`视图的一个区别是,它不是一个构造函数,而是一组构造函数,代表不同的数据格式。 - -```javascript -var buffer = new ArrayBuffer(12); - -var x1 = new Int32Array(buffer); -x1[0] = 1; -var x2 = new Uint8Array(buffer); -x2[0] = 2; - -x1[0] // 2 -``` - -上面代码对同一段内存,分别建立两种视图:32位带符号整数(`Int32Array`构造函数)和8位不带符号整数(`Uint8Array`构造函数)。由于两个视图对应的是同一段内存,一个视图修改底层内存,会影响到另一个视图。 - -TypedArray视图的构造函数,除了接受`ArrayBuffer`实例作为参数,还可以接受普通数组作为参数,直接分配内存生成底层的`ArrayBuffer`实例,并同时完成对这段内存的赋值。 - -```javascript -var typedArray = new Uint8Array([0,1,2]); -typedArray.length // 3 - -typedArray[0] = 5; -typedArray // [5, 1, 2] -``` - -上面代码使用TypedArray视图的`Uint8Array`构造函数,新建一个不带符号的8位整数视图。可以看到,`Uint8Array`直接使用普通数组作为参数,对底层内存的赋值同时完成。 - -### ArrayBuffer.prototype.byteLength - -`ArrayBuffer`实例的`byteLength`属性,返回所分配的内存区域的字节长度。 - -```javascript -var buffer = new ArrayBuffer(32); -buffer.byteLength -// 32 -``` - -如果要分配的内存区域很大,有可能分配失败(因为没有那么多的连续空余内存),所以有必要检查是否分配成功。 - -```javascript -if (buffer.byteLength === n) { - // 成功 -} else { - // 失败 -} -``` - -### ArrayBuffer.prototype.slice() - -`ArrayBuffer`实例有一个`slice`方法,允许将内存区域的一部分,拷贝生成一个新的`ArrayBuffer`对象。 - -```javascript -var buffer = new ArrayBuffer(8); -var newBuffer = buffer.slice(0, 3); -``` - -上面代码拷贝`buffer`对象的前3个字节(从0开始,到第3个字节前面结束),生成一个新的`ArrayBuffer`对象。`slice`方法其实包含两步,第一步是先分配一段新内存,第二步是将原来那个`ArrayBuffer`对象拷贝过去。 - -`slice`方法接受两个参数,第一个参数表示拷贝开始的字节序号(含该字节),第二个参数表示拷贝截止的字节序号(不含该字节)。如果省略第二个参数,则默认到原`ArrayBuffer`对象的结尾。 - -除了`slice`方法,`ArrayBuffer`对象不提供任何直接读写内存的方法,只允许在其上方建立视图,然后通过视图读写。 - -### ArrayBuffer.isView() - -`ArrayBuffer`有一个静态方法`isView`,返回一个布尔值,表示参数是否为`ArrayBuffer`的视图实例。这个方法大致相当于判断参数,是否为TypedArray实例或`DataView`实例。 - -```javascript -var buffer = new ArrayBuffer(8); -ArrayBuffer.isView(buffer) // false - -var v = new Int32Array(buffer); -ArrayBuffer.isView(v) // true -``` - -## TypedArray视图 - -### 概述 - -`ArrayBuffer`对象作为内存区域,可以存放多种类型的数据。同一段内存,不同数据有不同的解读方式,这就叫做“视图”(view)。`ArrayBuffer`有两种视图,一种是TypedArray视图,另一种是`DataView`视图。前者的数组成员都是同一个数据类型,后者的数组成员可以是不同的数据类型。 - -目前,TypedArray视图一共包括9种类型,每一种视图都是一种构造函数。 - -- **`Int8Array`**:8位有符号整数,长度1个字节。 -- **`Uint8Array`**:8位无符号整数,长度1个字节。 -- **`Uint8ClampedArray`**:8位无符号整数,长度1个字节,溢出处理不同。 -- **`Int16Array`**:16位有符号整数,长度2个字节。 -- **`Uint16Array`**:16位无符号整数,长度2个字节。 -- **`Int32Array`**:32位有符号整数,长度4个字节。 -- **`Uint32Array`**:32位无符号整数,长度4个字节。 -- **`Float32Array`**:32位浮点数,长度4个字节。 -- **`Float64Array`**:64位浮点数,长度8个字节。 - -这9个构造函数生成的数组,统称为TypedArray视图。它们很像普通数组,都有`length`属性,都能用方括号运算符(`[]`)获取单个元素,所有数组的方法,在它们上面都能使用。普通数组与TypedArray数组的差异主要在以下方面。 - -- TypedArray数组的所有成员,都是同一种类型。 -- TypedArray数组的成员是连续的,不会有空位。 -- TypedArray数组成员的默认值为0。比如,`new Array(10)`返回一个普通数组,里面没有任何成员,只是10个空位;`new Uint8Array(10)`返回一个TypedArray数组,里面10个成员都是0。 -- TypedArray数组只是一层视图,本身不储存数据,它的数据都储存在底层的`ArrayBuffer`对象之中,要获取底层对象必须使用`buffer`属性。 - -### 构造函数 - -TypedArray数组提供9种构造函数,用来生成相应类型的数组实例。 - -构造函数有多种用法。 - -**(1)TypedArray(buffer, byteOffset=0, length?)** - -同一个`ArrayBuffer`对象之上,可以根据不同的数据类型,建立多个视图。 - -```javascript -// 创建一个8字节的ArrayBuffer -var b = new ArrayBuffer(8); - -// 创建一个指向b的Int32视图,开始于字节0,直到缓冲区的末尾 -var v1 = new Int32Array(b); - -// 创建一个指向b的Uint8视图,开始于字节2,直到缓冲区的末尾 -var v2 = new Uint8Array(b, 2); - -// 创建一个指向b的Int16视图,开始于字节2,长度为2 -var v3 = new Int16Array(b, 2, 2); -``` - -上面代码在一段长度为8个字节的内存(`b`)之上,生成了三个视图:`v1`、`v2`和`v3`。 - -视图的构造函数可以接受三个参数: - -- 第一个参数(必需):视图对应的底层`ArrayBuffer`对象。 -- 第二个参数(可选):视图开始的字节序号,默认从0开始。 -- 第三个参数(可选):视图包含的数据个数,默认直到本段内存区域结束。 - -因此,`v1`、`v2`和`v3`是重叠的:`v1[0]`是一个32位整数,指向字节0~字节3;`v2[0]`是一个8位无符号整数,指向字节2;`v3[0]`是一个16位整数,指向字节2~字节3。只要任何一个视图对内存有所修改,就会在另外两个视图上反应出来。 - -注意,`byteOffset`必须与所要建立的数据类型一致,否则会报错。 - -```javascript -var buffer = new ArrayBuffer(8); -var i16 = new Int16Array(buffer, 1); -// Uncaught RangeError: start offset of Int16Array should be a multiple of 2 -``` - -上面代码中,新生成一个8个字节的`ArrayBuffer`对象,然后在这个对象的第一个字节,建立带符号的16位整数视图,结果报错。因为,带符号的16位整数需要两个字节,所以`byteOffset`参数必须能够被2整除。 - -如果想从任意字节开始解读`ArrayBuffer`对象,必须使用`DataView`视图,因为TypedArray视图只提供9种固定的解读格式。 - -**(2)TypedArray(length)** - -视图还可以不通过`ArrayBuffer`对象,直接分配内存而生成。 - -```javascript -var f64a = new Float64Array(8); -f64a[0] = 10; -f64a[1] = 20; -f64a[2] = f64a[0] + f64a[1]; -``` - -上面代码生成一个8个成员的`Float64Array`数组(共64字节),然后依次对每个成员赋值。这时,视图构造函数的参数就是成员的个数。可以看到,视图数组的赋值操作与普通数组的操作毫无两样。 - -**(3)TypedArray(typedArray)** - -TypedArray数组的构造函数,可以接受另一个TypedArray实例作为参数。 - -```javascript -var typedArray = new Int8Array(new Uint8Array(4)); -``` - -上面代码中,`Int8Array`构造函数接受一个`Uint8Array`实例作为参数。 - -注意,此时生成的新数组,只是复制了参数数组的值,对应的底层内存是不一样的。新数组会开辟一段新的内存储存数据,不会在原数组的内存之上建立视图。 - -```javascript -var x = new Int8Array([1, 1]); -var y = new Int8Array(x); -x[0] // 1 -y[0] // 1 - -x[0] = 2; -y[0] // 1 -``` - -上面代码中,数组`y`是以数组`x`为模板而生成的,当`x`变动的时候,`y`并没有变动。 - -如果想基于同一段内存,构造不同的视图,可以采用下面的写法。 - -```javascript -var x = new Int8Array([1, 1]); -var y = new Int8Array(x.buffer); -x[0] // 1 -y[0] // 1 - -x[0] = 2; -y[0] // 2 -``` - -**(4)TypedArray(arrayLikeObject)** - -构造函数的参数也可以是一个普通数组,然后直接生成TypedArray实例。 - -```javascript -var typedArray = new Uint8Array([1, 2, 3, 4]); -``` - -注意,这时TypedArray视图会重新开辟内存,不会在原数组的内存上建立视图。 - -上面代码从一个普通的数组,生成一个8位无符号整数的TypedArray实例。 - -TypedArray数组也可以转换回普通数组。 - -```javascript -var normalArray = Array.prototype.slice.call(typedArray); -``` - -### 数组方法 - -普通数组的操作方法和属性,对TypedArray数组完全适用。 - -- `TypedArray.prototype.copyWithin(target, start[, end = this.length])` -- `TypedArray.prototype.entries()` -- `TypedArray.prototype.every(callbackfn, thisArg?)` -- `TypedArray.prototype.fill(value, start=0, end=this.length)` -- `TypedArray.prototype.filter(callbackfn, thisArg?)` -- `TypedArray.prototype.find(predicate, thisArg?)` -- `TypedArray.prototype.findIndex(predicate, thisArg?)` -- `TypedArray.prototype.forEach(callbackfn, thisArg?)` -- `TypedArray.prototype.indexOf(searchElement, fromIndex=0)` -- `TypedArray.prototype.join(separator)` -- `TypedArray.prototype.keys()` -- `TypedArray.prototype.lastIndexOf(searchElement, fromIndex?)` -- `TypedArray.prototype.map(callbackfn, thisArg?)` -- `TypedArray.prototype.reduce(callbackfn, initialValue?)` -- `TypedArray.prototype.reduceRight(callbackfn, initialValue?)` -- `TypedArray.prototype.reverse()` -- `TypedArray.prototype.slice(start=0, end=this.length)` -- `TypedArray.prototype.some(callbackfn, thisArg?)` -- `TypedArray.prototype.sort(comparefn)` -- `TypedArray.prototype.toLocaleString(reserved1?, reserved2?)` -- `TypedArray.prototype.toString()` -- `TypedArray.prototype.values()` - -上面所有方法的用法,请参阅数组方法的介绍,这里不再重复了。 - -注意,TypedArray数组没有`concat`方法。如果想要合并多个TypedArray数组,可以用下面这个函数。 - -```javascript -function concatenate(resultConstructor, ...arrays) { - let totalLength = 0; - for (let arr of arrays) { - totalLength += arr.length; - } - let result = new resultConstructor(totalLength); - let offset = 0; - for (let arr of arrays) { - result.set(arr, offset); - offset += arr.length; - } - return result; -} - -concatenate(Uint8Array, Uint8Array.of(1, 2), Uint8Array.of(3, 4)) -// Uint8Array [1, 2, 3, 4] -``` - -另外,TypedArray数组与普通数组一样,部署了Iterator接口,所以可以被遍历。 - -```javascript -let ui8 = Uint8Array.of(0, 1, 2); -for (let byte of ui8) { - console.log(byte); -} -// 0 -// 1 -// 2 -``` - -### 字节序 - -字节序指的是数值在内存中的表示方式。 - -```javascript -var buffer = new ArrayBuffer(16); -var int32View = new Int32Array(buffer); - -for (var i = 0; i < int32View.length; i++) { - int32View[i] = i * 2; -} -``` - -上面代码生成一个16字节的`ArrayBuffer`对象,然后在它的基础上,建立了一个32位整数的视图。由于每个32位整数占据4个字节,所以一共可以写入4个整数,依次为0,2,4,6。 - -如果在这段数据上接着建立一个16位整数的视图,则可以读出完全不一样的结果。 - -```javascript -var int16View = new Int16Array(buffer); - -for (var i = 0; i < int16View.length; i++) { - console.log("Entry " + i + ": " + int16View[i]); -} -// Entry 0: 0 -// Entry 1: 0 -// Entry 2: 2 -// Entry 3: 0 -// Entry 4: 4 -// Entry 5: 0 -// Entry 6: 6 -// Entry 7: 0 -``` - -由于每个16位整数占据2个字节,所以整个`ArrayBuffer`对象现在分成8段。然后,由于x86体系的计算机都采用小端字节序(little endian),相对重要的字节排在后面的内存地址,相对不重要字节排在前面的内存地址,所以就得到了上面的结果。 - -比如,一个占据四个字节的16进制数`0x12345678`,决定其大小的最重要的字节是“12”,最不重要的是“78”。小端字节序将最不重要的字节排在前面,储存顺序就是`78563412`;大端字节序则完全相反,将最重要的字节排在前面,储存顺序就是`12345678`。目前,所有个人电脑几乎都是小端字节序,所以TypedArray数组内部也采用小端字节序读写数据,或者更准确的说,按照本机操作系统设定的字节序读写数据。 - -这并不意味大端字节序不重要,事实上,很多网络设备和特定的操作系统采用的是大端字节序。这就带来一个严重的问题:如果一段数据是大端字节序,TypedArray数组将无法正确解析,因为它只能处理小端字节序!为了解决这个问题,JavaScript引入`DataView`对象,可以设定字节序,下文会详细介绍。 - -下面是另一个例子。 - -```javascript -// 假定某段buffer包含如下字节 [0x02, 0x01, 0x03, 0x07] -var buffer = new ArrayBuffer(4); -var v1 = new Uint8Array(buffer); -v1[0] = 2; -v1[1] = 1; -v1[2] = 3; -v1[3] = 7; - -var uInt16View = new Uint16Array(buffer); - -// 计算机采用小端字节序 -// 所以头两个字节等于258 -if (uInt16View[0] === 258) { - console.log('OK'); // "OK" -} - -// 赋值运算 -uInt16View[0] = 255; // 字节变为[0xFF, 0x00, 0x03, 0x07] -uInt16View[0] = 0xff05; // 字节变为[0x05, 0xFF, 0x03, 0x07] -uInt16View[1] = 0x0210; // 字节变为[0x05, 0xFF, 0x10, 0x02] -``` - -下面的函数可以用来判断,当前视图是小端字节序,还是大端字节序。 - -```javascript -const BIG_ENDIAN = Symbol('BIG_ENDIAN'); -const LITTLE_ENDIAN = Symbol('LITTLE_ENDIAN'); - -function getPlatformEndianness() { - let arr32 = Uint32Array.of(0x12345678); - let arr8 = new Uint8Array(arr32.buffer); - switch ((arr8[0]*0x1000000) + (arr8[1]*0x10000) + (arr8[2]*0x100) + (arr8[3])) { - case 0x12345678: - return BIG_ENDIAN; - case 0x78563412: - return LITTLE_ENDIAN; - default: - throw new Error('Unknown endianness'); - } -} -``` - -总之,与普通数组相比,TypedArray数组的最大优点就是可以直接操作内存,不需要数据类型转换,所以速度快得多。 - -### BYTES_PER_ELEMENT属性 - -每一种视图的构造函数,都有一个`BYTES_PER_ELEMENT`属性,表示这种数据类型占据的字节数。 - -```javascript -Int8Array.BYTES_PER_ELEMENT // 1 -Uint8Array.BYTES_PER_ELEMENT // 1 -Int16Array.BYTES_PER_ELEMENT // 2 -Uint16Array.BYTES_PER_ELEMENT // 2 -Int32Array.BYTES_PER_ELEMENT // 4 -Uint32Array.BYTES_PER_ELEMENT // 4 -Float32Array.BYTES_PER_ELEMENT // 4 -Float64Array.BYTES_PER_ELEMENT // 8 -``` - -这个属性在TypedArray实例上也能获取,即有`TypedArray.prototype.BYTES_PER_ELEMENT`。 - -### ArrayBuffer与字符串的互相转换 - -`ArrayBuffer`转为字符串,或者字符串转为`ArrayBuffer`,有一个前提,即字符串的编码方法是确定的。假定字符串采用UTF-16编码(JavaScript的内部编码方式),可以自己编写转换函数。 - -```javascript -// ArrayBuffer转为字符串,参数为ArrayBuffer对象 -function ab2str(buf) { - return String.fromCharCode.apply(null, new Uint16Array(buf)); -} - -// 字符串转为ArrayBuffer对象,参数为字符串 -function str2ab(str) { - var buf = new ArrayBuffer(str.length * 2); // 每个字符占用2个字节 - var bufView = new Uint16Array(buf); - for (var i = 0, strLen = str.length; i < strLen; i++) { - bufView[i] = str.charCodeAt(i); - } - return buf; -} -``` - -### 溢出 - -不同的视图类型,所能容纳的数值范围是确定的。超出这个范围,就会出现溢出。比如,8位视图只能容纳一个8位的二进制值,如果放入一个9位的值,就会溢出。 - -TypedArray数组的溢出处理规则,简单来说,就是抛弃溢出的位,然后按照视图类型进行解释。 - -```javascript -var uint8 = new Uint8Array(1); - -uint8[0] = 256; -uint8[0] // 0 - -uint8[0] = -1; -uint8[0] // 255 -``` - -上面代码中,`uint8`是一个8位视图,而256的二进制形式是一个9位的值`100000000`,这时就会发生溢出。根据规则,只会保留后8位,即`00000000`。`uint8`视图的解释规则是无符号的8位整数,所以`00000000`就是`0`。 - -负数在计算机内部采用“2的补码”表示,也就是说,将对应的正数值进行否运算,然后加`1`。比如,`-1`对应的正值是`1`,进行否运算以后,得到`11111110`,再加上`1`就是补码形式`11111111`。`uint8`按照无符号的8位整数解释`11111111`,返回结果就是`255`。 - -一个简单转换规则,可以这样表示。 - -- 正向溢出(overflow):当输入值大于当前数据类型的最大值,结果等于当前数据类型的最小值加上余值,再减去1。 -- 负向溢出(underflow):当输入值小于当前数据类型的最小值,结果等于当前数据类型的最大值减去余值,再加上1。 - -上面的“余值”就是模运算的结果,即 JavaScript 里面的`%`运算符的结果。 - -```javascript -12 % 4 // 0 -12 % 5 // 2 -``` - -上面代码中,12除以4是没有余值的,而除以5会得到余值2。 - -请看下面的例子。 - -```javascript -var int8 = new Int8Array(1); - -int8[0] = 128; -int8[0] // -128 - -int8[0] = -129; -int8[0] // 127 -``` - -上面例子中,`int8`是一个带符号的8位整数视图,它的最大值是127,最小值是-128。输入值为`128`时,相当于正向溢出`1`,根据“最小值加上余值(128除以127的余值是1),再减去1”的规则,就会返回`-128`;输入值为`-129`时,相当于负向溢出`1`,根据“最大值减去余值(-129除以-128的余值是1),再加上1”的规则,就会返回`127`。 - -`Uint8ClampedArray`视图的溢出规则,与上面的规则不同。它规定,凡是发生正向溢出,该值一律等于当前数据类型的最大值,即255;如果发生负向溢出,该值一律等于当前数据类型的最小值,即0。 - -```javascript -var uint8c = new Uint8ClampedArray(1); - -uint8c[0] = 256; -uint8c[0] // 255 - -uint8c[0] = -1; -uint8c[0] // 0 -``` - -上面例子中,`uint8C`是一个`Uint8ClampedArray`视图,正向溢出时都返回255,负向溢出都返回0。 - -### TypedArray.prototype.buffer - -TypedArray实例的`buffer`属性,返回整段内存区域对应的`ArrayBuffer`对象。该属性为只读属性。 - -```javascript -var a = new Float32Array(64); -var b = new Uint8Array(a.buffer); -``` - -上面代码的`a`视图对象和`b`视图对象,对应同一个`ArrayBuffer`对象,即同一段内存。 - -### TypedArray.prototype.byteLength,TypedArray.prototype.byteOffset - -`byteLength`属性返回TypedArray数组占据的内存长度,单位为字节。`byteOffset`属性返回TypedArray数组从底层`ArrayBuffer`对象的哪个字节开始。这两个属性都是只读属性。 - -```javascript -var b = new ArrayBuffer(8); - -var v1 = new Int32Array(b); -var v2 = new Uint8Array(b, 2); -var v3 = new Int16Array(b, 2, 2); - -v1.byteLength // 8 -v2.byteLength // 6 -v3.byteLength // 4 - -v1.byteOffset // 0 -v2.byteOffset // 2 -v3.byteOffset // 2 -``` - -### TypedArray.prototype.length - -`length`属性表示TypedArray数组含有多少个成员。注意将`byteLength`属性和`length`属性区分,前者是字节长度,后者是成员长度。 - -```javascript -var a = new Int16Array(8); - -a.length // 8 -a.byteLength // 16 -``` - -### TypedArray.prototype.set() - -TypedArray数组的`set`方法用于复制数组(普通数组或TypedArray数组),也就是将一段内容完全复制到另一段内存。 - -```javascript -var a = new Uint8Array(8); -var b = new Uint8Array(8); - -b.set(a); -``` - -上面代码复制`a`数组的内容到`b`数组,它是整段内存的复制,比一个个拷贝成员的那种复制快得多。 - -`set`方法还可以接受第二个参数,表示从`b`对象的哪一个成员开始复制`a`对象。 - -```javascript -var a = new Uint16Array(8); -var b = new Uint16Array(10); - -b.set(a, 2) -``` - -上面代码的`b`数组比`a`数组多两个成员,所以从`b[2]`开始复制。 - -### TypedArray.prototype.subarray() - -`subarray`方法是对于TypedArray数组的一部分,再建立一个新的视图。 - -```javascript -var a = new Uint16Array(8); -var b = a.subarray(2,3); - -a.byteLength // 16 -b.byteLength // 2 -``` - -`subarray`方法的第一个参数是起始的成员序号,第二个参数是结束的成员序号(不含该成员),如果省略则包含剩余的全部成员。所以,上面代码的`a.subarray(2,3)`,意味着b只包含`a[2]`一个成员,字节长度为2。 - -### TypedArray.prototype.slice() - -TypeArray实例的`slice`方法,可以返回一个指定位置的新的TypedArray实例。 - -```javascript -let ui8 = Uint8Array.of(0, 1, 2); -ui8.slice(-1) -// Uint8Array [ 2 ] -``` - -上面代码中,`ui8`是8位无符号整数数组视图的一个实例。它的`slice`方法可以从当前视图之中,返回一个新的视图实例。 - -`slice`方法的参数,表示原数组的具体位置,开始生成新数组。负值表示逆向的位置,即-1为倒数第一个位置,-2表示倒数第二个位置,以此类推。 - -### TypedArray.of() - -TypedArray数组的所有构造函数,都有一个静态方法`of`,用于将参数转为一个TypedArray实例。 - -```javascript -Float32Array.of(0.151, -8, 3.7) -// Float32Array [ 0.151, -8, 3.7 ] -``` - -下面三种方法都会生成同样一个TypedArray数组。 - -```javascript -// 方法一 -let tarr = new Uint8Array([1,2,3]); - -// 方法二 -let tarr = Uint8Array.of(1,2,3); - -// 方法三 -let tarr = new Uint8Array(3); -tarr[0] = 1; -tarr[1] = 2; -tarr[2] = 3; -``` - -### TypedArray.from() - -静态方法`from`接受一个可遍历的数据结构(比如数组)作为参数,返回一个基于这个结构的TypedArray实例。 - -```javascript -Uint16Array.from([0, 1, 2]) -// Uint16Array [ 0, 1, 2 ] -``` - -这个方法还可以将一种TypedArray实例,转为另一种。 - -```javascript -var ui16 = Uint16Array.from(Uint8Array.of(0, 1, 2)); -ui16 instanceof Uint16Array // true -``` - -`from`方法还可以接受一个函数,作为第二个参数,用来对每个元素进行遍历,功能类似`map`方法。 - -```javascript -Int8Array.of(127, 126, 125).map(x => 2 * x) -// Int8Array [ -2, -4, -6 ] - -Int16Array.from(Int8Array.of(127, 126, 125), x => 2 * x) -// Int16Array [ 254, 252, 250 ] -``` - -上面的例子中,`from`方法没有发生溢出,这说明遍历不是针对原来的8位整数数组。也就是说,`from`会将第一个参数指定的TypedArray数组,拷贝到另一段内存之中,处理之后再将结果转成指定的数组格式。 - -## 复合视图 - -由于视图的构造函数可以指定起始位置和长度,所以在同一段内存之中,可以依次存放不同类型的数据,这叫做“复合视图”。 - -```javascript -var buffer = new ArrayBuffer(24); - -var idView = new Uint32Array(buffer, 0, 1); -var usernameView = new Uint8Array(buffer, 4, 16); -var amountDueView = new Float32Array(buffer, 20, 1); -``` - -上面代码将一个24字节长度的`ArrayBuffer`对象,分成三个部分: - -- 字节0到字节3:1个32位无符号整数 -- 字节4到字节19:16个8位整数 -- 字节20到字节23:1个32位浮点数 - -这种数据结构可以用如下的C语言描述: - -```c -struct someStruct { - unsigned long id; - char username[16]; - float amountDue; -}; -``` - -## DataView视图 - -如果一段数据包括多种类型(比如服务器传来的HTTP数据),这时除了建立`ArrayBuffer`对象的复合视图以外,还可以通过`DataView`视图进行操作。 - -`DataView`视图提供更多操作选项,而且支持设定字节序。本来,在设计目的上,`ArrayBuffer`对象的各种TypedArray视图,是用来向网卡、声卡之类的本机设备传送数据,所以使用本机的字节序就可以了;而`DataView`视图的设计目的,是用来处理网络设备传来的数据,所以大端字节序或小端字节序是可以自行设定的。 - -`DataView`视图本身也是构造函数,接受一个`ArrayBuffer`对象作为参数,生成视图。 - -```javascript -DataView(ArrayBuffer buffer [, 字节起始位置 [, 长度]]); -``` - -下面是一个例子。 - -```javascript -var buffer = new ArrayBuffer(24); -var dv = new DataView(buffer); -``` - -`DataView`实例有以下属性,含义与TypedArray实例的同名方法相同。 - -- `DataView.prototype.buffer`:返回对应的ArrayBuffer对象 -- `DataView.prototype.byteLength`:返回占据的内存字节长度 -- `DataView.prototype.byteOffset`:返回当前视图从对应的ArrayBuffer对象的哪个字节开始 - -`DataView`实例提供8个方法读取内存。 - -- **`getInt8`**:读取1个字节,返回一个8位整数。 -- **`getUint8`**:读取1个字节,返回一个无符号的8位整数。 -- **`getInt16`**:读取2个字节,返回一个16位整数。 -- **`getUint16`**:读取2个字节,返回一个无符号的16位整数。 -- **`getInt32`**:读取4个字节,返回一个32位整数。 -- **`getUint32`**:读取4个字节,返回一个无符号的32位整数。 -- **`getFloat32`**:读取4个字节,返回一个32位浮点数。 -- **`getFloat64`**:读取8个字节,返回一个64位浮点数。 - -这一系列`get`方法的参数都是一个字节序号(不能是负数,否则会报错),表示从哪个字节开始读取。 - -```javascript -var buffer = new ArrayBuffer(24); -var dv = new DataView(buffer); - -// 从第1个字节读取一个8位无符号整数 -var v1 = dv.getUint8(0); - -// 从第2个字节读取一个16位无符号整数 -var v2 = dv.getUint16(1); - -// 从第4个字节读取一个16位无符号整数 -var v3 = dv.getUint16(3); -``` - -上面代码读取了`ArrayBuffer`对象的前5个字节,其中有一个8位整数和两个十六位整数。 - -如果一次读取两个或两个以上字节,就必须明确数据的存储方式,到底是小端字节序还是大端字节序。默认情况下,`DataView`的`get`方法使用大端字节序解读数据,如果需要使用小端字节序解读,必须在`get`方法的第二个参数指定`true`。 - -```javascript -// 小端字节序 -var v1 = dv.getUint16(1, true); - -// 大端字节序 -var v2 = dv.getUint16(3, false); - -// 大端字节序 -var v3 = dv.getUint16(3); -``` - -DataView视图提供8个方法写入内存。 - -- **`setInt8`**:写入1个字节的8位整数。 -- **`setUint8`**:写入1个字节的8位无符号整数。 -- **`setInt16`**:写入2个字节的16位整数。 -- **`setUint16`**:写入2个字节的16位无符号整数。 -- **`setInt32`**:写入4个字节的32位整数。 -- **`setUint32`**:写入4个字节的32位无符号整数。 -- **`setFloat32`**:写入4个字节的32位浮点数。 -- **`setFloat64`**:写入8个字节的64位浮点数。 - -这一系列`set`方法,接受两个参数,第一个参数是字节序号,表示从哪个字节开始写入,第二个参数为写入的数据。对于那些写入两个或两个以上字节的方法,需要指定第三个参数,`false`或者`undefined`表示使用大端字节序写入,`true`表示使用小端字节序写入。 - -```javascript -// 在第1个字节,以大端字节序写入值为25的32位整数 -dv.setInt32(0, 25, false); - -// 在第5个字节,以大端字节序写入值为25的32位整数 -dv.setInt32(4, 25); - -// 在第9个字节,以小端字节序写入值为2.5的32位浮点数 -dv.setFloat32(8, 2.5, true); -``` - -如果不确定正在使用的计算机的字节序,可以采用下面的判断方式。 - -```javascript -var littleEndian = (function() { - var buffer = new ArrayBuffer(2); - new DataView(buffer).setInt16(0, 256, true); - return new Int16Array(buffer)[0] === 256; -})(); -``` - -如果返回`true`,就是小端字节序;如果返回`false`,就是大端字节序。 - -## 二进制数组的应用 - -大量的Web API用到了`ArrayBuffer`对象和它的视图对象。 - -### AJAX - -传统上,服务器通过AJAX操作只能返回文本数据,即`responseType`属性默认为`text`。`XMLHttpRequest`第二版`XHR2`允许服务器返回二进制数据,这时分成两种情况。如果明确知道返回的二进制数据类型,可以把返回类型(`responseType`)设为`arraybuffer`;如果不知道,就设为`blob`。 - -```javascript -var xhr = new XMLHttpRequest(); -xhr.open('GET', someUrl); -xhr.responseType = 'arraybuffer'; - -xhr.onload = function () { - let arrayBuffer = xhr.response; - // ··· -}; - -xhr.send(); -``` - -如果知道传回来的是32位整数,可以像下面这样处理。 - -```javascript -xhr.onreadystatechange = function () { - if (req.readyState === 4 ) { - var arrayResponse = xhr.response; - var dataView = new DataView(arrayResponse); - var ints = new Uint32Array(dataView.byteLength / 4); - - xhrDiv.style.backgroundColor = "#00FF00"; - xhrDiv.innerText = "Array is " + ints.length + "uints long"; - } -} -``` - -### Canvas - -网页`Canvas`元素输出的二进制像素数据,就是TypedArray数组。 - -```javascript -var canvas = document.getElementById('myCanvas'); -var ctx = canvas.getContext('2d'); - -var imageData = ctx.getImageData(0, 0, canvas.width, canvas.height); -var uint8ClampedArray = imageData.data; -``` - -需要注意的是,上面代码的`uint8ClampedArray`虽然是一个TypedArray数组,但是它的视图类型是一种针对`Canvas`元素的专有类型`Uint8ClampedArray`。这个视图类型的特点,就是专门针对颜色,把每个字节解读为无符号的8位整数,即只能取值0~255,而且发生运算的时候自动过滤高位溢出。这为图像处理带来了巨大的方便。 - -举例来说,如果把像素的颜色值设为`Uint8Array`类型,那么乘以一个gamma值的时候,就必须这样计算: - -```javascript -u8[i] = Math.min(255, Math.max(0, u8[i] * gamma)); -``` - -因为`Uint8Array`类型对于大于255的运算结果(比如`0xFF+1`),会自动变为`0x00`,所以图像处理必须要像上面这样算。这样做很麻烦,而且影响性能。如果将颜色值设为`Uint8ClampedArray`类型,计算就简化许多。 - -```javascript -pixels[i] *= gamma; -``` - -`Uint8ClampedArray`类型确保将小于0的值设为0,将大于255的值设为255。注意,IE 10不支持该类型。 - -### WebSocket - -`WebSocket`可以通过`ArrayBuffer`,发送或接收二进制数据。 - -```javascript -var socket = new WebSocket('ws://127.0.0.1:8081'); -socket.binaryType = 'arraybuffer'; - -// Wait until socket is open -socket.addEventListener('open', function (event) { - // Send binary data - var typedArray = new Uint8Array(4); - socket.send(typedArray.buffer); -}); - -// Receive binary data -socket.addEventListener('message', function (event) { - var arrayBuffer = event.data; - // ··· -}); -``` - -### Fetch API - -Fetch API取回的数据,就是`ArrayBuffer`对象。 - -```javascript -fetch(url) -.then(function(request){ - return request.arrayBuffer() -}) -.then(function(arrayBuffer){ - // ... -}); -``` - -### File API - -如果知道一个文件的二进制数据类型,也可以将这个文件读取为`ArrayBuffer`对象。 - -```javascript -var fileInput = document.getElementById('fileInput'); -var file = fileInput.files[0]; -var reader = new FileReader(); -reader.readAsArrayBuffer(file); -reader.onload = function () { - var arrayBuffer = reader.result; - // ··· -}; -``` - -下面以处理bmp文件为例。假定`file`变量是一个指向bmp文件的文件对象,首先读取文件。 - -```javascript -var reader = new FileReader(); -reader.addEventListener("load", processimage, false); -reader.readAsArrayBuffer(file); -``` - -然后,定义处理图像的回调函数:先在二进制数据之上建立一个`DataView`视图,再建立一个`bitmap`对象,用于存放处理后的数据,最后将图像展示在`Canvas`元素之中。 - -```javascript -function processimage(e) { - var buffer = e.target.result; - var datav = new DataView(buffer); - var bitmap = {}; - // 具体的处理步骤 -} -``` - -具体处理图像数据时,先处理bmp的文件头。具体每个文件头的格式和定义,请参阅有关资料。 - -```javascript -bitmap.fileheader = {}; -bitmap.fileheader.bfType = datav.getUint16(0, true); -bitmap.fileheader.bfSize = datav.getUint32(2, true); -bitmap.fileheader.bfReserved1 = datav.getUint16(6, true); -bitmap.fileheader.bfReserved2 = datav.getUint16(8, true); -bitmap.fileheader.bfOffBits = datav.getUint32(10, true); -``` - -接着处理图像元信息部分。 - -```javascript -bitmap.infoheader = {}; -bitmap.infoheader.biSize = datav.getUint32(14, true); -bitmap.infoheader.biWidth = datav.getUint32(18, true); -bitmap.infoheader.biHeight = datav.getUint32(22, true); -bitmap.infoheader.biPlanes = datav.getUint16(26, true); -bitmap.infoheader.biBitCount = datav.getUint16(28, true); -bitmap.infoheader.biCompression = datav.getUint32(30, true); -bitmap.infoheader.biSizeImage = datav.getUint32(34, true); -bitmap.infoheader.biXPelsPerMeter = datav.getUint32(38, true); -bitmap.infoheader.biYPelsPerMeter = datav.getUint32(42, true); -bitmap.infoheader.biClrUsed = datav.getUint32(46, true); -bitmap.infoheader.biClrImportant = datav.getUint32(50, true); -``` - -最后处理图像本身的像素信息。 - -```javascript -var start = bitmap.fileheader.bfOffBits; -bitmap.pixels = new Uint8Array(buffer, start); -``` - -至此,图像文件的数据全部处理完成。下一步,可以根据需要,进行图像变形,或者转换格式,或者展示在`Canvas`网页元素之中。 - -## SharedArrayBuffer - -JavaScript 是单线程的,web worker 引入了多进程,每个进程的数据都是隔离的,通过`postMessage()`通信,即通信的数据是复制的。如果数据量比较大,这种通信的效率显然比较低。 - -```javascript -var w = new Worker('myworker.js'); -``` - -上面代码中,主进程新建了一个 Worker 进程。该进程与主进程之间会有一个通信渠道,主进程通过`w.postMessage`向 Worker 进程发消息,同时通过`message`事件监听 Worker 进程的回应。 - -```javascript -w.postMessage('hi'); -w.onmessage = function (ev) { - console.log(ev.data); -} -``` - -上面代码中,主进程先发一个消息`hi`,然后在监听到 Worker 进程的回应后,就将其打印出来。 - -Worker 进程也是通过监听`message`事件,来获取主进程发来的消息,并作出反应。 - -```javascript -onmessage = function (ev) { - console.log(ev.data); - postMessage('ho'); -} -``` - -主进程与 Worker 进程之间,可以传送各种数据,不仅仅是字符串,还可以传送二进制数据。很容易想到,如果有大量数据要传送,留出一块内存区域,主进程与 Worker 进程共享,两方都可以读写,那么就会大大提高效率。 - -ES2017 引入[`SharedArrayBuffer`](https://github.com/tc39/ecmascript_sharedmem/blob/master/TUTORIAL.md),允许多个 Worker 进程与主进程共享内存数据。`SharedArrayBuffer`的 API 与`ArrayBuffer`一模一样,唯一的区别是后者无法共享。 - -```javascript -// 新建 1KB 共享内存 -var sharedBuffer = new SharedArrayBuffer(1024); - -// 主窗口发送数据 -w.postMessage(sharedBuffer); - -// 本地写入数据 -const sharedArray = new Int32Array(sharedBuffer); -``` - -上面代码中,`postMessage`方法的参数是`SharedArrayBuffer`对象。 - -Worker 进程从事件的`data`属性上面取到数据。 - -```javascript -var sharedBuffer; -onmessage = function (ev) { - sharedBuffer = ev.data; // 1KB 的共享内存,就是主窗口共享出来的那块内存 -}; -``` - -共享内存也可以在 Worker 进程创建,发给主进程。 - -`SharedArrayBuffer`与`SharedArray`一样,本身是无法读写,必须在上面建立视图,然后通过视图读写。 - -```javascript -// 分配 10 万个 32 位整数占据的内存空间 -var sab = new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * 100000); - -// 建立 32 位整数视图 -var ia = new Int32Array(sab); // ia.length == 100000 - -// 新建一个质数生成器 -var primes = new PrimeGenerator(); - -// 将 10 万个质数,写入这段内存空间 -for ( let i=0 ; i < ia.length ; i++ ) - ia[i] = primes.next(); - -// 向 Worker 进程发送这段共享内存 -w.postMessage(ia); -``` - -Worker 进程收到数据后的处理如下。 - -```javascript -var ia; -onmessage = function (ev) { - ia = ev.data; - console.log(ia.length); // 100000 - console.log(ia[37]); // 输出 163,因为这是第138个质数 -}; -``` - -多个进程共享内存,最大的问题就是如何防止两个进程同时修改某个地址,或者说,当一个进程修改共享内存以后,必须有一个机制让其他进程同步。SharedArrayBuffer API 提供`Atomics`对象,保证所有共享内存的操作都是“原子性”的,并且可以在所有进程内同步。 - -```javascript -// 主进程 -var sab = new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * 100000); -var ia = new Int32Array(sab); - -for (let i = 0; i < ia.length; i++) { - ia[i] = primes.next(); // 将质数放入 ia -} - -// worker 进程 -ia[112]++; // 错误 -Atomics.add(ia, 112, 1); // 正确 -``` - -上面代码中,Worker 进程直接改写共享内存是不正确的。有两个原因,一是可能发生两个进程同时改写该地址,二是改写以后无法同步到其他 Worker 进程。所以,必须使用`Atomics.add()`方法进行改写。 - -下面是另一个例子。 - -```javascript -// 进程一 -console.log(ia[37]); // 163 -Atomics.store(ia, 37, 123456); -Atomics.wake(ia, 37, 1); - -// 进程二 -Atomics.wait(ia, 37, 163); -console.log(ia[37]); // 123456 -``` - -上面代码中,共享内存`ia`的第37号位置,原来的值是`163`。进程二使用`Atomics.wait()`方法,指定只要`ia[37]`等于`163`,就处于“等待”状态。进程一使用`Atomics.store()`方法,将`123456`放入`ia[37]`,然后使用`Atomics.wake()`方法将监视`ia[37]`的一个进程唤醒。 - -`Atomics`对象有以下方法。 - -- `Atomics.load(array, index)`:返回`array[index]`的值。 -- `Atomics.store(array, index, value)`:设置`array[index]`的值,返回这个值。 -- `Atomics.compareExchange(array, index, oldval, newval)`:如果`array[index]`等于`oldval`,就写入`newval`,返回`oldval`。 -- `Atomics.exchange(array, index, value)`:设置`array[index]`的值,返回旧的值。 -- `Atomics.add(array, index, value)`:将`value`加到`array[index]`,返回`array[index]`旧的值。 -- `Atomics.sub(array, index, value)`:将`value`从`array[index]`减去,返回`array[index]`旧的值。 -- `Atomics.and(array, index, value)`:将`value`与`array[index]`进行位运算`and`,放入`array[index]`,并返回旧的值。 -- `Atomics.or(array, index, value)`:将`value`与`array[index]`进行位运算`or`,放入`array[index]`,并返回旧的值。 -- `Atomics.xor(array, index, value)`:将`vaule`与`array[index]`进行位运算`xor`,放入`array[index]`,并返回旧的值。 -- `Atomics.wait(array, index, value, timeout)`:如果`array[index]`等于`value`,进程就进入休眠状态,必须通过`Atomics.wake()`唤醒。`timeout`指定多少毫秒之后,进入休眠。返回值是三个字符串(ok、not-equal、timed-out)中的一个。 -- `Atomics.wake(array, index, count)`:唤醒指定数目在某个位置休眠的进程。 -- `Atomics.isLockFree(size)`:返回一个布尔值,表示`Atomics`对象是否可以处理某个`size`的内存锁定。如果返回`false`,应用程序就需要自己来实现锁定。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/class.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/class.md" deleted file mode 100644 index 92811f8a6..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/class.md" +++ /dev/null @@ -1,1536 +0,0 @@ -# Class - -## Class基本语法 - -### 概述 - -JavaScript语言的传统方法是通过构造函数,定义并生成新对象。下面是一个例子。 - -```javascript -function Point(x, y) { - this.x = x; - this.y = y; -} - -Point.prototype.toString = function () { - return '(' + this.x + ', ' + this.y + ')'; -}; - -var p = new Point(1, 2); -``` - -上面这种写法跟传统的面向对象语言(比如C++和Java)差异很大,很容易让新学习这门语言的程序员感到困惑。 - -ES6提供了更接近传统语言的写法,引入了Class(类)这个概念,作为对象的模板。通过`class`关键字,可以定义类。基本上,ES6的`class`可以看作只是一个语法糖,它的绝大部分功能,ES5都可以做到,新的`class`写法只是让对象原型的写法更加清晰、更像面向对象编程的语法而已。上面的代码用ES6的“类”改写,就是下面这样。 - -```javascript -//定义类 -class Point { - constructor(x, y) { - this.x = x; - this.y = y; - } - - toString() { - return '(' + this.x + ', ' + this.y + ')'; - } -} -``` - -上面代码定义了一个“类”,可以看到里面有一个`constructor`方法,这就是构造方法,而`this`关键字则代表实例对象。也就是说,ES5的构造函数`Point`,对应ES6的`Point`类的构造方法。 - -`Point`类除了构造方法,还定义了一个`toString`方法。注意,定义“类”的方法的时候,前面不需要加上`function`这个关键字,直接把函数定义放进去了就可以了。另外,方法之间不需要逗号分隔,加了会报错。 - -ES6的类,完全可以看作构造函数的另一种写法。 - -```javascript -class Point { - // ... -} - -typeof Point // "function" -Point === Point.prototype.constructor // true -``` - -上面代码表明,类的数据类型就是函数,类本身就指向构造函数。 - -使用的时候,也是直接对类使用`new`命令,跟构造函数的用法完全一致。 - -```javascript -class Bar { - doStuff() { - console.log('stuff'); - } -} - -var b = new Bar(); -b.doStuff() // "stuff" -``` - -构造函数的`prototype`属性,在ES6的“类”上面继续存在。事实上,类的所有方法都定义在类的`prototype`属性上面。 - -```javascript -class Point { - constructor(){ - // ... - } - - toString(){ - // ... - } - - toValue(){ - // ... - } -} - -// 等同于 - -Point.prototype = { - toString(){}, - toValue(){} -}; -``` - -在类的实例上面调用方法,其实就是调用原型上的方法。 - -```javascript -class B {} -let b = new B(); - -b.constructor === B.prototype.constructor // true -``` - -上面代码中,`b`是B类的实例,它的`constructor`方法就是B类原型的`constructor`方法。 - -由于类的方法都定义在`prototype`对象上面,所以类的新方法可以添加在`prototype`对象上面。`Object.assign`方法可以很方便地一次向类添加多个方法。 - -```javascript -class Point { - constructor(){ - // ... - } -} - -Object.assign(Point.prototype, { - toString(){}, - toValue(){} -}); -``` - -`prototype`对象的`constructor`属性,直接指向“类”的本身,这与ES5的行为是一致的。 - -```javascript -Point.prototype.constructor === Point // true -``` - -另外,类的内部所有定义的方法,都是不可枚举的(non-enumerable)。 - -```javascript -class Point { - constructor(x, y) { - // ... - } - - toString() { - // ... - } -} - -Object.keys(Point.prototype) -// [] -Object.getOwnPropertyNames(Point.prototype) -// ["constructor","toString"] -``` - -上面代码中,`toString`方法是`Point`类内部定义的方法,它是不可枚举的。这一点与ES5的行为不一致。 - -```javascript -var Point = function (x, y) { - // ... -}; - -Point.prototype.toString = function() { - // ... -}; - -Object.keys(Point.prototype) -// ["toString"] -Object.getOwnPropertyNames(Point.prototype) -// ["constructor","toString"] -``` - -上面代码采用ES5的写法,`toString`方法就是可枚举的。 - -类的属性名,可以采用表达式。 - -```javascript -let methodName = "getArea"; -class Square{ - constructor(length) { - // ... - } - - [methodName]() { - // ... - } -} -``` - -上面代码中,`Square`类的方法名`getArea`,是从表达式得到的。 - -### constructor方法 - -`constructor`方法是类的默认方法,通过`new`命令生成对象实例时,自动调用该方法。一个类必须有`constructor`方法,如果没有显式定义,一个空的`constructor`方法会被默认添加。 - -```javascript -constructor() {} -``` - -`constructor`方法默认返回实例对象(即`this`),完全可以指定返回另外一个对象。 - -```javascript -class Foo { - constructor() { - return Object.create(null); - } -} - -new Foo() instanceof Foo -// false -``` - -上面代码中,`constructor`函数返回一个全新的对象,结果导致实例对象不是`Foo`类的实例。 - -类的构造函数,不使用`new`是没法调用的,会报错。这是它跟普通构造函数的一个主要区别,后者不用`new`也可以执行。 - -```javascript -class Foo { - constructor() { - return Object.create(null); - } -} - -Foo() -// TypeError: Class constructor Foo cannot be invoked without 'new' -``` - -### 类的实例对象 - -生成类的实例对象的写法,与ES5完全一样,也是使用`new`命令。如果忘记加上`new`,像函数那样调用`Class`,将会报错。 - -```javascript -// 报错 -var point = Point(2, 3); - -// 正确 -var point = new Point(2, 3); -``` - -与ES5一样,实例的属性除非显式定义在其本身(即定义在`this`对象上),否则都是定义在原型上(即定义在`class`上)。 - -```javascript -//定义类 -class Point { - - constructor(x, y) { - this.x = x; - this.y = y; - } - - toString() { - return '(' + this.x + ', ' + this.y + ')'; - } - -} - -var point = new Point(2, 3); - -point.toString() // (2, 3) - -point.hasOwnProperty('x') // true -point.hasOwnProperty('y') // true -point.hasOwnProperty('toString') // false -point.__proto__.hasOwnProperty('toString') // true -``` - -上面代码中,`x`和`y`都是实例对象`point`自身的属性(因为定义在`this`变量上),所以`hasOwnProperty`方法返回`true`,而`toString`是原型对象的属性(因为定义在`Point`类上),所以`hasOwnProperty`方法返回`false`。这些都与ES5的行为保持一致。 - -与ES5一样,类的所有实例共享一个原型对象。 - -```javascript -var p1 = new Point(2,3); -var p2 = new Point(3,2); - -p1.__proto__ === p2.__proto__ -//true -``` - -上面代码中,`p1`和`p2`都是Point的实例,它们的原型都是Point.prototype,所以`__proto__`属性是相等的。 - -这也意味着,可以通过实例的`__proto__`属性为Class添加方法。 - -```javascript -var p1 = new Point(2,3); -var p2 = new Point(3,2); - -p1.__proto__.printName = function () { return 'Oops' }; - -p1.printName() // "Oops" -p2.printName() // "Oops" - -var p3 = new Point(4,2); -p3.printName() // "Oops" -``` - -上面代码在`p1`的原型上添加了一个`printName`方法,由于`p1`的原型就是`p2`的原型,因此`p2`也可以调用这个方法。而且,此后新建的实例`p3`也可以调用这个方法。这意味着,使用实例的`__proto__`属性改写原型,必须相当谨慎,不推荐使用,因为这会改变Class的原始定义,影响到所有实例。 - -### 不存在变量提升 - -Class不存在变量提升(hoist),这一点与ES5完全不同。 - -```javascript -new Foo(); // ReferenceError -class Foo {} -``` - -上面代码中,`Foo`类使用在前,定义在后,这样会报错,因为ES6不会把类的声明提升到代码头部。这种规定的原因与下文要提到的继承有关,必须保证子类在父类之后定义。 - -```javascript -{ - let Foo = class {}; - class Bar extends Foo { - } -} -``` - -上面的代码不会报错,因为`Bar`继承`Foo`的时候,`Foo`已经有定义了。但是,如果存在`class`的提升,上面代码就会报错,因为`class`会被提升到代码头部,而`let`命令是不提升的,所以导致`Bar`继承`Foo`的时候,`Foo`还没有定义。 - -### Class表达式 - -与函数一样,类也可以使用表达式的形式定义。 - -```javascript -const MyClass = class Me { - getClassName() { - return Me.name; - } -}; -``` - -上面代码使用表达式定义了一个类。需要注意的是,这个类的名字是`MyClass`而不是`Me`,`Me`只在Class的内部代码可用,指代当前类。 - -```javascript -let inst = new MyClass(); -inst.getClassName() // Me -Me.name // ReferenceError: Me is not defined -``` - -上面代码表示,`Me`只在Class内部有定义。 - -如果类的内部没用到的话,可以省略`Me`,也就是可以写成下面的形式。 - -```javascript -const MyClass = class { /* ... */ }; -``` - -采用Class表达式,可以写出立即执行的Class。 - -```javascript -let person = new class { - constructor(name) { - this.name = name; - } - - sayName() { - console.log(this.name); - } -}('张三'); - -person.sayName(); // "张三" -``` - -上面代码中,`person`是一个立即执行的类的实例。 - -### 私有方法 - -私有方法是常见需求,但 ES6 不提供,只能通过变通方法模拟实现。 - -一种做法是在命名上加以区别。 - -```javascript -class Widget { - - // 公有方法 - foo (baz) { - this._bar(baz); - } - - // 私有方法 - _bar(baz) { - return this.snaf = baz; - } - - // ... -} -``` - -上面代码中,`_bar`方法前面的下划线,表示这是一个只限于内部使用的私有方法。但是,这种命名是不保险的,在类的外部,还是可以调用到这个方法。 - -另一种方法就是索性将私有方法移出模块,因为模块内部的所有方法都是对外可见的。 - -```javascript -class Widget { - foo (baz) { - bar.call(this, baz); - } - - // ... -} - -function bar(baz) { - return this.snaf = baz; -} -``` - -上面代码中,`foo`是公有方法,内部调用了`bar.call(this, baz)`。这使得`bar`实际上成为了当前模块的私有方法。 - -还有一种方法是利用`Symbol`值的唯一性,将私有方法的名字命名为一个`Symbol`值。 - -```javascript -const bar = Symbol('bar'); -const snaf = Symbol('snaf'); - -export default class myClass{ - - // 公有方法 - foo(baz) { - this[bar](baz); - } - - // 私有方法 - [bar](baz) { - return this[snaf] = baz; - } - - // ... -}; -``` - -上面代码中,`bar`和`snaf`都是`Symbol`值,导致第三方无法获取到它们,因此达到了私有方法和私有属性的效果。 - -### this的指向 - -类的方法内部如果含有`this`,它默认指向类的实例。但是,必须非常小心,一旦单独使用该方法,很可能报错。 - -```javascript -class Logger { - printName(name = 'there') { - this.print(`Hello ${name}`); - } - - print(text) { - console.log(text); - } -} - -const logger = new Logger(); -const { printName } = logger; -printName(); // TypeError: Cannot read property 'print' of undefined -``` - -上面代码中,`printName`方法中的`this`,默认指向`Logger`类的实例。但是,如果将这个方法提取出来单独使用,`this`会指向该方法运行时所在的环境,因为找不到`print`方法而导致报错。 - -一个比较简单的解决方法是,在构造方法中绑定`this`,这样就不会找不到`print`方法了。 - -```javascript -class Logger { - constructor() { - this.printName = this.printName.bind(this); - } - - // ... -} -``` - -另一种解决方法是使用箭头函数。 - -```javascript -class Logger { - constructor() { - this.printName = (name = 'there') => { - this.print(`Hello ${name}`); - }; - } - - // ... -} -``` - -还有一种解决方法是使用`Proxy`,获取方法的时候,自动绑定`this`。 - -```javascript -function selfish (target) { - const cache = new WeakMap(); - const handler = { - get (target, key) { - const value = Reflect.get(target, key); - if (typeof value !== 'function') { - return value; - } - if (!cache.has(value)) { - cache.set(value, value.bind(target)); - } - return cache.get(value); - } - }; - const proxy = new Proxy(target, handler); - return proxy; -} - -const logger = selfish(new Logger()); -``` - -### 严格模式 - -类和模块的内部,默认就是严格模式,所以不需要使用`use strict`指定运行模式。只要你的代码写在类或模块之中,就只有严格模式可用。 - -考虑到未来所有的代码,其实都是运行在模块之中,所以ES6实际上把整个语言升级到了严格模式。 - -### name属性 - -由于本质上,ES6的类只是ES5的构造函数的一层包装,所以函数的许多特性都被`Class`继承,包括`name`属性。 - -```javascript -class Point {} -Point.name // "Point" -``` - -`name`属性总是返回紧跟在`class`关键字后面的类名。 - -## Class的继承 - -### 基本用法 - -Class之间可以通过`extends`关键字实现继承,这比ES5的通过修改原型链实现继承,要清晰和方便很多。 - -```javascript -class ColorPoint extends Point {} -``` - -上面代码定义了一个`ColorPoint`类,该类通过`extends`关键字,继承了`Point`类的所有属性和方法。但是由于没有部署任何代码,所以这两个类完全一样,等于复制了一个`Point`类。下面,我们在`ColorPoint`内部加上代码。 - -```javascript -class ColorPoint extends Point { - constructor(x, y, color) { - super(x, y); // 调用父类的constructor(x, y) - this.color = color; - } - - toString() { - return this.color + ' ' + super.toString(); // 调用父类的toString() - } -} -``` - -上面代码中,`constructor`方法和`toString`方法之中,都出现了`super`关键字,它在这里表示父类的构造函数,用来新建父类的`this`对象。 - -子类必须在`constructor`方法中调用`super`方法,否则新建实例时会报错。这是因为子类没有自己的`this`对象,而是继承父类的`this`对象,然后对其进行加工。如果不调用`super`方法,子类就得不到`this`对象。 - -```javascript -class Point { /* ... */ } - -class ColorPoint extends Point { - constructor() { - } -} - -let cp = new ColorPoint(); // ReferenceError -``` - -上面代码中,`ColorPoint`继承了父类`Point`,但是它的构造函数没有调用`super`方法,导致新建实例时报错。 - -ES5的继承,实质是先创造子类的实例对象`this`,然后再将父类的方法添加到`this`上面(`Parent.apply(this)`)。ES6的继承机制完全不同,实质是先创造父类的实例对象`this`(所以必须先调用`super`方法),然后再用子类的构造函数修改`this`。 - -如果子类没有定义`constructor`方法,这个方法会被默认添加,代码如下。也就是说,不管有没有显式定义,任何一个子类都有`constructor`方法。 - -```javascript -constructor(...args) { - super(...args); -} -``` - -另一个需要注意的地方是,在子类的构造函数中,只有调用`super`之后,才可以使用`this`关键字,否则会报错。这是因为子类实例的构建,是基于对父类实例加工,只有`super`方法才能返回父类实例。 - -```javascript -class Point { - constructor(x, y) { - this.x = x; - this.y = y; - } -} - -class ColorPoint extends Point { - constructor(x, y, color) { - this.color = color; // ReferenceError - super(x, y); - this.color = color; // 正确 - } -} -``` - -上面代码中,子类的`constructor`方法没有调用`super`之前,就使用`this`关键字,结果报错,而放在`super`方法之后就是正确的。 - -下面是生成子类实例的代码。 - -```javascript -let cp = new ColorPoint(25, 8, 'green'); - -cp instanceof ColorPoint // true -cp instanceof Point // true -``` - -上面代码中,实例对象`cp`同时是`ColorPoint`和`Point`两个类的实例,这与ES5的行为完全一致。 - -### 类的prototype属性和\_\_proto\_\_属性 - -大多数浏览器的ES5实现之中,每一个对象都有`__proto__`属性,指向对应的构造函数的prototype属性。Class作为构造函数的语法糖,同时有prototype属性和`__proto__`属性,因此同时存在两条继承链。 - -(1)子类的`__proto__`属性,表示构造函数的继承,总是指向父类。 - -(2)子类`prototype`属性的`__proto__`属性,表示方法的继承,总是指向父类的`prototype`属性。 - -```javascript -class A { -} - -class B extends A { -} - -B.__proto__ === A // true -B.prototype.__proto__ === A.prototype // true -``` - -上面代码中,子类`B`的`__proto__`属性指向父类`A`,子类`B`的`prototype`属性的`__proto__`属性指向父类`A`的`prototype`属性。 - -这样的结果是因为,类的继承是按照下面的模式实现的。 - -```javascript -class A { -} - -class B { -} - -// B的实例继承A的实例 -Object.setPrototypeOf(B.prototype, A.prototype); -const b = new B(); - -// B的实例继承A的静态属性 -Object.setPrototypeOf(B, A); -const b = new B(); -``` - -《对象的扩展》一章给出过`Object.setPrototypeOf`方法的实现。 - -```javascript -Object.setPrototypeOf = function (obj, proto) { - obj.__proto__ = proto; - return obj; -} -``` - -因此,就得到了上面的结果。 - -```javascript -Object.setPrototypeOf(B.prototype, A.prototype); -// 等同于 -B.prototype.__proto__ = A.prototype; - -Object.setPrototypeOf(B, A); -// 等同于 -B.__proto__ = A; -``` - -这两条继承链,可以这样理解:作为一个对象,子类(`B`)的原型(`__proto__`属性)是父类(`A`);作为一个构造函数,子类(`B`)的原型(`prototype`属性)是父类的实例。 - -```javascript -Object.create(A.prototype); -// 等同于 -B.prototype.__proto__ = A.prototype; -``` - -### Extends 的继承目标 - -`extends`关键字后面可以跟多种类型的值。 - -```javascript -class B extends A { -} -``` - -上面代码的`A`,只要是一个有`prototype`属性的函数,就能被`B`继承。由于函数都有`prototype`属性(除了`Function.prototype`函数),因此`A`可以是任意函数。 - -下面,讨论三种特殊情况。 - -第一种特殊情况,子类继承Object类。 - -```javascript -class A extends Object { -} - -A.__proto__ === Object // true -A.prototype.__proto__ === Object.prototype // true -``` - -这种情况下,`A`其实就是构造函数`Object`的复制,`A`的实例就是`Object`的实例。 - -第二种特殊情况,不存在任何继承。 - -```javascript -class A { -} - -A.__proto__ === Function.prototype // true -A.prototype.__proto__ === Object.prototype // true -``` - -这种情况下,A作为一个基类(即不存在任何继承),就是一个普通函数,所以直接继承`Funciton.prototype`。但是,`A`调用后返回一个空对象(即`Object`实例),所以`A.prototype.__proto__`指向构造函数(`Object`)的`prototype`属性。 - -第三种特殊情况,子类继承`null`。 - -```javascript -class A extends null { -} - -A.__proto__ === Function.prototype // true -A.prototype.__proto__ === undefined // true -``` - -这种情况与第二种情况非常像。`A`也是一个普通函数,所以直接继承`Funciton.prototype`。但是,A调用后返回的对象不继承任何方法,所以它的`__proto__`指向`Function.prototype`,即实质上执行了下面的代码。 - -```javascript -class C extends null { - constructor() { return Object.create(null); } -} -``` - -### Object.getPrototypeOf() - -`Object.getPrototypeOf`方法可以用来从子类上获取父类。 - -```javascript -Object.getPrototypeOf(ColorPoint) === Point -// true -``` - -因此,可以使用这个方法判断,一个类是否继承了另一个类。 - -### super 关键字 - -`super`这个关键字,既可以当作函数使用,也可以当作对象使用。在这两种情况下,它的用法完全不同。 - -第一种情况,`super`作为函数调用时,代表父类的构造函数。ES6 要求,子类的构造函数必须执行一次`super`函数。 - -```javascript -class A {} - -class B extends A { - constructor() { - super(); - } -} -``` - -上面代码中,子类`B`的构造函数之中的`super()`,代表调用父类的构造函数。这是必须的,否则 JavaScript 引擎会报错。 - -注意,`super`虽然代表了父类`A`的构造函数,但是返回的是子类`B`的实例,即`super`内部的`this`指的是`B`,因此`super()`在这里相当于`A.prototype.constructor.call(this)`。 - -```javascript -class A { - constructor() { - console.log(new.target.name); - } -} -class B extends A { - constructor() { - super(); - } -} -new A() // A -new B() // B -``` - -上面代码中,`new.target`指向当前正在执行的函数。可以看到,在`super()`执行时,它指向的是子类`B`的构造函数,而不是父类`A`的构造函数。也就是说,`super()`内部的`this`指向的是`B`。 - -作为函数时,`super()`只能用在子类的构造函数之中,用在其他地方就会报错。 - -```javascript -class A {} - -class B extends A { - m() { - super(); // 报错 - } -} -``` - -上面代码中,`super()`用在`B`类的`m`方法之中,就会造成句法错误。 - -第二种情况,`super`作为对象时,指向父类的原型对象。 - -```javascript -class A { - p() { - return 2; - } -} - -class B extends A { - constructor() { - super(); - console.log(super.p()); // 2 - } -} - -let b = new B(); -``` - -上面代码中,子类`B`当中的`super.p()`,就是将`super`当作一个对象使用。这时,`super`指向`A.prototype`,所以`super.p()`就相当于`A.prototype.p()`。 - -这里需要注意,由于`super`指向父类的原型对象,所以定义在父类实例上的方法或属性,是无法通过`super`调用的。 - -```javascript -class A { - constructor() { - this.p = 2; - } -} - -class B extends A { - get m() { - return super.p; - } -} - -let b = new B(); -b.m // undefined -``` - -上面代码中,`p`是父类`A`实例的属性,`super.p`就引用不到它。 - -如果属性定义在父类的原型对象上,`super`就可以取到。 - -```javascript -class A {} -A.prototype.x = 2; - -class B extends A { - constructor() { - super(); - console.log(super.x) // 2 - } -} - -let b = new B(); -``` - -上面代码中,属性`x`是定义在`A.prototype`上面的,所以`super.x`可以取到它的值。 - -ES6 规定,通过`super`调用父类的方法时,`super`会绑定子类的`this`。 - -```javascript -class A { - constructor() { - this.x = 1; - } - print() { - console.log(this.x); - } -} - -class B extends A { - constructor() { - super(); - this.x = 2; - } - m() { - super.print(); - } -} - -let b = new B(); -b.m() // 2 -``` - -上面代码中,`super.print()`虽然调用的是`A.prototype.print()`,但是`A.prototype.print()`会绑定子类`B`的`this`,导致输出的是`2`,而不是`1`。也就是说,实际上执行的是`super.print.call(this)`。 - -由于绑定子类的`this`,所以如果通过`super`对某个属性赋值,这时`super`就是`this`,赋值的属性会变成子类实例的属性。 - -```javascript -class A { - constructor() { - this.x = 1; - } -} - -class B extends A { - constructor() { - super(); - this.x = 2; - super.x = 3; - console.log(super.x); // undefined - console.log(this.x); // 3 - } -} - -let b = new B(); -``` - -上面代码中,`super.x`赋值为`3`,这时等同于对`this.x`赋值为`3`。而当读取`super.x`的时候,读的是`A.prototype.x`,所以返回`undefined`。 - -注意,使用`super`的时候,必须显式指定是作为函数、还是作为对象使用,否则会报错。 - -```javascript -class A {} - -class B extends A { - constructor() { - super(); - console.log(super); // 报错 - } -} -``` - -上面代码中,`console.log(super)`当中的`super`,无法看出是作为函数使用,还是作为对象使用,所以 JavaScript 引擎解析代码的时候就会报错。这时,如果能清晰地表明`super`的数据类型,就不会报错。 - -```javascript -class A {} - -class B extends A { - constructor() { - super(); - console.log(super.valueOf() instanceof B); // true - } -} - -let b = new B(); -``` - -上面代码中,`super.valueOf()`表明`super`是一个对象,因此就不会报错。同时,由于`super`绑定`B`的`this`,所以`super.valueOf()`返回的是一个`B`的实例。 - -最后,由于对象总是继承其他对象的,所以可以在任意一个对象中,使用`super`关键字。 - -```javascript -var obj = { - toString() { - return "MyObject: " + super.toString(); - } -}; - -obj.toString(); // MyObject: [object Object] -``` - -### 实例的\_\_proto\_\_属性 - -子类实例的\_\_proto\_\_属性的\_\_proto\_\_属性,指向父类实例的\_\_proto\_\_属性。也就是说,子类的原型的原型,是父类的原型。 - -```javascript -var p1 = new Point(2, 3); -var p2 = new ColorPoint(2, 3, 'red'); - -p2.__proto__ === p1.__proto__ // false -p2.__proto__.__proto__ === p1.__proto__ // true -``` - -上面代码中,`ColorPoint`继承了`Point`,导致前者原型的原型是后者的原型。 - -因此,通过子类实例的`__proto__.__proto__`属性,可以修改父类实例的行为。 - -```javascript -p2.__proto__.__proto__.printName = function () { - console.log('Ha'); -}; - -p1.printName() // "Ha" -``` - -上面代码在`ColorPoint`的实例`p2`上向`Point`类添加方法,结果影响到了`Point`的实例`p1`。 - -## 原生构造函数的继承 - -原生构造函数是指语言内置的构造函数,通常用来生成数据结构。ECMAScript的原生构造函数大致有下面这些。 - -- Boolean() -- Number() -- String() -- Array() -- Date() -- Function() -- RegExp() -- Error() -- Object() - -以前,这些原生构造函数是无法继承的,比如,不能自己定义一个`Array`的子类。 - -```javascript -function MyArray() { - Array.apply(this, arguments); -} - -MyArray.prototype = Object.create(Array.prototype, { - constructor: { - value: MyArray, - writable: true, - configurable: true, - enumerable: true - } -}); -``` - -上面代码定义了一个继承Array的`MyArray`类。但是,这个类的行为与`Array`完全不一致。 - -```javascript -var colors = new MyArray(); -colors[0] = "red"; -colors.length // 0 - -colors.length = 0; -colors[0] // "red" -``` - -之所以会发生这种情况,是因为子类无法获得原生构造函数的内部属性,通过`Array.apply()`或者分配给原型对象都不行。原生构造函数会忽略`apply`方法传入的`this`,也就是说,原生构造函数的`this`无法绑定,导致拿不到内部属性。 - -ES5是先新建子类的实例对象`this`,再将父类的属性添加到子类上,由于父类的内部属性无法获取,导致无法继承原生的构造函数。比如,Array构造函数有一个内部属性`[[DefineOwnProperty]]`,用来定义新属性时,更新`length`属性,这个内部属性无法在子类获取,导致子类的`length`属性行为不正常。 - -下面的例子中,我们想让一个普通对象继承`Error`对象。 - -```javascript -var e = {}; - -Object.getOwnPropertyNames(Error.call(e)) -// [ 'stack' ] - -Object.getOwnPropertyNames(e) -// [] -``` - -上面代码中,我们想通过`Error.call(e)`这种写法,让普通对象`e`具有`Error`对象的实例属性。但是,`Error.call()`完全忽略传入的第一个参数,而是返回一个新对象,`e`本身没有任何变化。这证明了`Error.call(e)`这种写法,无法继承原生构造函数。 - -ES6允许继承原生构造函数定义子类,因为ES6是先新建父类的实例对象`this`,然后再用子类的构造函数修饰`this`,使得父类的所有行为都可以继承。下面是一个继承`Array`的例子。 - -```javascript -class MyArray extends Array { - constructor(...args) { - super(...args); - } -} - -var arr = new MyArray(); -arr[0] = 12; -arr.length // 1 - -arr.length = 0; -arr[0] // undefined -``` - -上面代码定义了一个`MyArray`类,继承了`Array`构造函数,因此就可以从`MyArray`生成数组的实例。这意味着,ES6可以自定义原生数据结构(比如Array、String等)的子类,这是ES5无法做到的。 - -上面这个例子也说明,`extends`关键字不仅可以用来继承类,还可以用来继承原生的构造函数。因此可以在原生数据结构的基础上,定义自己的数据结构。下面就是定义了一个带版本功能的数组。 - -```javascript -class VersionedArray extends Array { - constructor() { - super(); - this.history = [[]]; - } - commit() { - this.history.push(this.slice()); - } - revert() { - this.splice(0, this.length, ...this.history[this.history.length - 1]); - } -} - -var x = new VersionedArray(); - -x.push(1); -x.push(2); -x // [1, 2] -x.history // [[]] - -x.commit(); -x.history // [[], [1, 2]] -x.push(3); -x // [1, 2, 3] - -x.revert(); -x // [1, 2] -``` - -上面代码中,`VersionedArray`结构会通过`commit`方法,将自己的当前状态存入`history`属性,然后通过`revert`方法,可以撤销当前版本,回到上一个版本。除此之外,`VersionedArray`依然是一个数组,所有原生的数组方法都可以在它上面调用。 - -下面是一个自定义`Error`子类的例子。 - -```javascript -class ExtendableError extends Error { - constructor(message) { - super(); - this.message = message; - this.stack = (new Error()).stack; - this.name = this.constructor.name; - } -} - -class MyError extends ExtendableError { - constructor(m) { - super(m); - } -} - -var myerror = new MyError('ll'); -myerror.message // "ll" -myerror instanceof Error // true -myerror.name // "MyError" -myerror.stack -// Error -// at MyError.ExtendableError -// ... -``` - -注意,继承`Object`的子类,有一个[行为差异](http://stackoverflow.com/questions/36203614/super-does-not-pass-arguments-when-instantiating-a-class-extended-from-object)。 - -```javascript -class NewObj extends Object{ - constructor(){ - super(...arguments); - } -} -var o = new NewObj({attr: true}); -console.log(o.attr === true); // false -``` - -上面代码中,`NewObj`继承了`Object`,但是无法通过`super`方法向父类`Object`传参。这是因为ES6改变了`Object`构造函数的行为,一旦发现`Object`方法不是通过`new Object()`这种形式调用,ES6规定`Object`构造函数会忽略参数。 - -## Class的取值函数(getter)和存值函数(setter) - -与ES5一样,在Class内部可以使用`get`和`set`关键字,对某个属性设置存值函数和取值函数,拦截该属性的存取行为。 - -```javascript -class MyClass { - constructor() { - // ... - } - get prop() { - return 'getter'; - } - set prop(value) { - console.log('setter: '+value); - } -} - -let inst = new MyClass(); - -inst.prop = 123; -// setter: 123 - -inst.prop -// 'getter' -``` - -上面代码中,`prop`属性有对应的存值函数和取值函数,因此赋值和读取行为都被自定义了。 - -存值函数和取值函数是设置在属性的descriptor对象上的。 - -```javascript -class CustomHTMLElement { - constructor(element) { - this.element = element; - } - - get html() { - return this.element.innerHTML; - } - - set html(value) { - this.element.innerHTML = value; - } -} - -var descriptor = Object.getOwnPropertyDescriptor( - CustomHTMLElement.prototype, "html"); -"get" in descriptor // true -"set" in descriptor // true -``` - -上面代码中,存值函数和取值函数是定义在`html`属性的描述对象上面,这与ES5完全一致。 - -## Class 的 Generator 方法 - -如果某个方法之前加上星号(`*`),就表示该方法是一个 Generator 函数。 - -```javascript -class Foo { - constructor(...args) { - this.args = args; - } - * [Symbol.iterator]() { - for (let arg of this.args) { - yield arg; - } - } -} - -for (let x of new Foo('hello', 'world')) { - console.log(x); -} -// hello -// world -``` - -上面代码中,`Foo`类的`Symbol.iterator`方法前有一个星号,表示该方法是一个 Generator 函数。`Symbol.iterator`方法返回一个`Foo`类的默认遍历器,`for...of`循环会自动调用这个遍历器。 - -## Class 的静态方法 - -类相当于实例的原型,所有在类中定义的方法,都会被实例继承。如果在一个方法前,加上`static`关键字,就表示该方法不会被实例继承,而是直接通过类来调用,这就称为“静态方法”。 - -```javascript -class Foo { - static classMethod() { - return 'hello'; - } -} - -Foo.classMethod() // 'hello' - -var foo = new Foo(); -foo.classMethod() -// TypeError: foo.classMethod is not a function -``` - -上面代码中,`Foo`类的`classMethod`方法前有`static`关键字,表明该方法是一个静态方法,可以直接在`Foo`类上调用(`Foo.classMethod()`),而不是在`Foo`类的实例上调用。如果在实例上调用静态方法,会抛出一个错误,表示不存在该方法。 - -父类的静态方法,可以被子类继承。 - -```javascript -class Foo { - static classMethod() { - return 'hello'; - } -} - -class Bar extends Foo { -} - -Bar.classMethod(); // 'hello' -``` - -上面代码中,父类`Foo`有一个静态方法,子类`Bar`可以调用这个方法。 - -静态方法也是可以从`super`对象上调用的。 - -```javascript -class Foo { - static classMethod() { - return 'hello'; - } -} - -class Bar extends Foo { - static classMethod() { - return super.classMethod() + ', too'; - } -} - -Bar.classMethod(); -``` - -## Class的静态属性和实例属性 - -静态属性指的是Class本身的属性,即`Class.propname`,而不是定义在实例对象(`this`)上的属性。 - -```javascript -class Foo { -} - -Foo.prop = 1; -Foo.prop // 1 -``` - -上面的写法为`Foo`类定义了一个静态属性`prop`。 - -目前,只有这种写法可行,因为ES6明确规定,Class内部只有静态方法,没有静态属性。 - -```javascript -// 以下两种写法都无效 -class Foo { - // 写法一 - prop: 2 - - // 写法二 - static prop: 2 -} - -Foo.prop // undefined -``` - -ES7有一个静态属性的[提案](https://github.com/jeffmo/es-class-properties),目前Babel转码器支持。 - -这个提案对实例属性和静态属性,都规定了新的写法。 - -(1)类的实例属性 - -类的实例属性可以用等式,写入类的定义之中。 - -```javascript -class MyClass { - myProp = 42; - - constructor() { - console.log(this.myProp); // 42 - } -} -``` - -上面代码中,`myProp`就是`MyClass`的实例属性。在`MyClass`的实例上,可以读取这个属性。 - -以前,我们定义实例属性,只能写在类的`constructor`方法里面。 - -```javascript -class ReactCounter extends React.Component { - constructor(props) { - super(props); - this.state = { - count: 0 - }; - } -} -``` - -上面代码中,构造方法`constructor`里面,定义了`this.state`属性。 - -有了新的写法以后,可以不在`constructor`方法里面定义。 - -```javascript -class ReactCounter extends React.Component { - state = { - count: 0 - }; -} -``` - -这种写法比以前更清晰。 - -为了可读性的目的,对于那些在`constructor`里面已经定义的实例属性,新写法允许直接列出。 - -```javascript -class ReactCounter extends React.Component { - constructor(props) { - super(props); - this.state = { - count: 0 - }; - } - state; -} -``` - -(2)类的静态属性 - -类的静态属性只要在上面的实例属性写法前面,加上`static`关键字就可以了。 - -```javascript -class MyClass { - static myStaticProp = 42; - - constructor() { - console.log(MyClass.myStaticProp); // 42 - } -} -``` - -同样的,这个新写法大大方便了静态属性的表达。 - -```javascript -// 老写法 -class Foo { -} -Foo.prop = 1; - -// 新写法 -class Foo { - static prop = 1; -} -``` - -上面代码中,老写法的静态属性定义在类的外部。整个类生成以后,再生成静态属性。这样让人很容易忽略这个静态属性,也不符合相关代码应该放在一起的代码组织原则。另外,新写法是显式声明(declarative),而不是赋值处理,语义更好。 - -## 类的私有属性 - -目前,有一个[提案](https://github.com/tc39/proposal-private-fields),为`class`加了私有属性。方法是在属性名之前,使用`#`表示。 - -```javascript -class Point { - #x; - - constructor(x = 0) { - #x = +x; - } - - get x() { return #x } - set x(value) { #x = +value } -} -``` - -上面代码中,`#x`就表示私有属性`x`,在`Point`类之外是读取不到这个属性的。还可以看到,私有属性与实例的属性是可以同名的(比如,`#x`与`get x()`)。 - -私有属性可以指定初始值,在构造函数执行时进行初始化。 - -```javascript -class Point { - #x = 0; - constructor() { - #x; // 0 - } -} -``` - -之所以要引入一个新的前缀`#`表示私有属性,而没有采用`private`关键字,是因为 JavaScript 是一门动态语言,使用独立的符号似乎是唯一的可靠方法,能够准确地区分一种属性是私有属性。另外,Ruby 语言使用`@`表示私有属性,ES6 没有用这个符号而使用`#`,是因为`@`已经被留给了 Decorator。 - -该提案只规定了私有属性的写法。但是,很自然地,它也可以用来写私有方法。 - -```javascript -class Foo { - #a; - #b; - #sum() { return #a + #b; } - printSum() { console.log(#sum()); } - constructor(a, b) { #a = a; #b = b; } -} -``` - -## new.target属性 - -`new`是从构造函数生成实例的命令。ES6为`new`命令引入了一个`new.target`属性,(在构造函数中)返回`new`命令作用于的那个构造函数。如果构造函数不是通过`new`命令调用的,`new.target`会返回`undefined`,因此这个属性可以用来确定构造函数是怎么调用的。 - -```javascript -function Person(name) { - if (new.target !== undefined) { - this.name = name; - } else { - throw new Error('必须使用new生成实例'); - } -} - -// 另一种写法 -function Person(name) { - if (new.target === Person) { - this.name = name; - } else { - throw new Error('必须使用new生成实例'); - } -} - -var person = new Person('张三'); // 正确 -var notAPerson = Person.call(person, '张三'); // 报错 -``` - -上面代码确保构造函数只能通过`new`命令调用。 - -Class内部调用`new.target`,返回当前Class。 - -```javascript -class Rectangle { - constructor(length, width) { - console.log(new.target === Rectangle); - this.length = length; - this.width = width; - } -} - -var obj = new Rectangle(3, 4); // 输出 true -``` - -需要注意的是,子类继承父类时,`new.target`会返回子类。 - -```javascript -class Rectangle { - constructor(length, width) { - console.log(new.target === Rectangle); - // ... - } -} - -class Square extends Rectangle { - constructor(length) { - super(length, length); - } -} - -var obj = new Square(3); // 输出 false -``` - -上面代码中,`new.target`会返回子类。 - -利用这个特点,可以写出不能独立使用、必须继承后才能使用的类。 - -```javascript -class Shape { - constructor() { - if (new.target === Shape) { - throw new Error('本类不能实例化'); - } - } -} - -class Rectangle extends Shape { - constructor(length, width) { - super(); - // ... - } -} - -var x = new Shape(); // 报错 -var y = new Rectangle(3, 4); // 正确 -``` - -上面代码中,`Shape`类不能被实例化,只能用于继承。 - -注意,在函数外部,使用`new.target`会报错。 - -## Mixin模式的实现 - -Mixin模式指的是,将多个类的接口“混入”(mix in)另一个类。它在ES6的实现如下。 - -```javascript -function mix(...mixins) { - class Mix {} - - for (let mixin of mixins) { - copyProperties(Mix, mixin); - copyProperties(Mix.prototype, mixin.prototype); - } - - return Mix; -} - -function copyProperties(target, source) { - for (let key of Reflect.ownKeys(source)) { - if ( key !== "constructor" - && key !== "prototype" - && key !== "name" - ) { - let desc = Object.getOwnPropertyDescriptor(source, key); - Object.defineProperty(target, key, desc); - } - } -} -``` - -上面代码的`mix`函数,可以将多个对象合成为一个类。使用的时候,只要继承这个类即可。 - -```javascript -class DistributedEdit extends mix(Loggable, Serializable) { - // ... -} -``` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/intro.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/intro.md" deleted file mode 100644 index f3d5dec25..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/intro.md" +++ /dev/null @@ -1,651 +0,0 @@ -# ECMAScript 6简介 - -ECMAScript 6.0(以下简称 ES6)是 JavaScript 语言的下一代标准,已经在2015年6月正式发布了。它的目标,是使得 JavaScript 语言可以用来编写复杂的大型应用程序,成为企业级开发语言。 - -## ECMAScript 和 JavaScript 的关系 - -一个常见的问题是,ECMAScript 和 JavaScript 到底是什么关系? - -要讲清楚这个问题,需要回顾历史。1996年11月,JavaScript 的创造者 Netscape 公司,决定将 JavaScript 提交给国际标准化组织ECMA,希望这种语言能够成为国际标准。次年,ECMA 发布262号标准文件(ECMA-262)的第一版,规定了浏览器脚本语言的标准,并将这种语言称为 ECMAScript,这个版本就是1.0版。 - -该标准从一开始就是针对 JavaScript 语言制定的,但是之所以不叫 JavaScript,有两个原因。一是商标,Java 是 Sun 公司的商标,根据授权协议,只有 Netscape 公司可以合法地使用 JavaScript 这个名字,且 JavaScript 本身也已经被 Netscape 公司注册为商标。二是想体现这门语言的制定者是 ECMA,不是 Netscape,这样有利于保证这门语言的开放性和中立性。 - -因此,ECMAScript 和 JavaScript 的关系是,前者是后者的规格,后者是前者的一种实现(另外的 ECMAScript 方言还有 Jscript 和 ActionScript)。日常场合,这两个词是可以互换的。 - -## ES6 与 ECMAScript 2015 的关系 - -ECMAScript 2015(简称 ES2015)这个词,也是经常可以看到的。它与 ES6 是什么关系呢? - -2011年,ECMAScript 5.1版发布后,就开始制定6.0版了。因此,ES6 这个词的原意,就是指 JavaScript 语言的下一个版本。 - -但是,因为这个版本引入的语法功能太多,而且制定过程当中,还有很多组织和个人不断提交新功能。事情很快就变得清楚了,不可能在一个版本里面包括所有将要引入的功能。常规的做法是先发布6.0版,过一段时间再发6.1版,然后是6.2版、6.3版等等。 - -但是,标准的制定者不想这样做。他们想让标准的升级成为常规流程:任何人在任何时候,都可以向标准委员会提交新语法的提案,然后标准委员会每个月开一次会,评估这些提案是否可以接受,需要哪些改进。如果经过多次会议以后,一个提案足够成熟了,就可以正式进入标准了。这就是说,标准的版本升级成为了一个不断滚动的流程,每个月都会有变动。 - -标准委员会最终决定,标准在每年的6月份正式发布一次,作为当年的正式版本。接下来的时间,就在这个版本的基础上做改动,直到下一年的6月份,草案就自然变成了新一年的版本。这样一来,就不需要以前的版本号了,只要用年份标记就可以了。 - -ES6 的第一个版本,就这样在2015年6月发布了,正式名称就是《ECMAScript 2015标准》(简称 ES2015)。2016年6月,小幅修订的《ECMAScript 2016标准》(简称 ES2016)如期发布,这个版本可以看作是 ES6.1 版,因为两者的差异非常小(只新增了数组实例的`includes`方法和指数运算符),基本上是同一个标准。根据计划,2017年6月发布 ES2017 标准。 - -因此,ES6 既是一个历史名词,也是一个泛指,含义是5.1版以后的 JavaScript 的下一代标准,涵盖了ES2015、ES2016、ES2017等等,而ES2015 则是正式名称,特指该年发布的正式版本的语言标准。本书中提到 ES6 的地方,一般是指 ES2015 标准,但有时也是泛指“下一代 JavaScript 语言”。 - -## 语法提案的批准流程 - -任何人都可以向标准委员会(又称 TC39 委员会)提案,要求修改语言标准。 - -一种新的语法从提案到变成正式标准,需要经历五个阶段。每个阶段的变动都需要由 TC39 委员会批准。 - -- Stage 0 - Strawman(展示阶段) -- Stage 1 - Proposal(征求意见阶段) -- Stage 2 - Draft(草案阶段) -- Stage 3 - Candidate(候选人阶段) -- Stage 4 - Finished(定案阶段) - -一个提案只要能进入 Stage 2,就差不多肯定会包括在以后的正式标准里面。ECMAScript 当前的所有提案,可以在 TC39 的官方网站[Github.com/tc39/ecma262](https://github.com/tc39/ecma262)查看。 - -本书的写作目标之一,是跟踪 ECMAScript 语言的最新进展,介绍5.1版本以后所有的新语法。对于那些明确或很有希望,将要列入标准的新语法,都将予以介绍。 - -## ECMAScript 的历史 - -ES6 从开始制定到最后发布,整整用了15年。 - -前面提到,ECMAScript 1.0是1997年发布的,接下来的两年,连续发布了 ECMAScript 2.0(1998年6月)和 ECMAScript 3.0(1999年12月)。3.0版是一个巨大的成功,在业界得到广泛支持,成为通行标准,奠定了 JavaScript 语言的基本语法,以后的版本完全继承。直到今天,初学者一开始学习 JavaScript,其实就是在学3.0版的语法。 - -2000年,ECMAScript 4.0开始酝酿。这个版本最后没有通过,但是它的大部分内容被ES6继承了。因此,ES6制定的起点其实是2000年。 - -为什么ES4没有通过呢?因为这个版本太激进了,对ES3做了彻底升级,导致标准委员会的一些成员不愿意接受。ECMA的第39号技术专家委员会(Technical Committee 39,简称TC39)负责制订ECMAScript标准,成员包括Microsoft、Mozilla、Google等大公司。 - -2007年10月,ECMAScript 4.0版草案发布,本来预计次年8月发布正式版本。但是,各方对于是否通过这个标准,发生了严重分歧。以Yahoo、Microsoft、Google为首的大公司,反对JavaScript的大幅升级,主张小幅改动;以JavaScript创造者Brendan Eich为首的Mozilla公司,则坚持当前的草案。 - -2008年7月,由于对于下一个版本应该包括哪些功能,各方分歧太大,争论过于激烈,ECMA开会决定,中止ECMAScript 4.0的开发,将其中涉及现有功能改善的一小部分,发布为ECMAScript 3.1,而将其他激进的设想扩大范围,放入以后的版本,由于会议的气氛,该版本的项目代号起名为Harmony(和谐)。会后不久,ECMAScript 3.1就改名为ECMAScript 5。 - -2009年12月,ECMAScript 5.0版正式发布。Harmony项目则一分为二,一些较为可行的设想定名为JavaScript.next继续开发,后来演变成ECMAScript 6;一些不是很成熟的设想,则被视为JavaScript.next.next,在更远的将来再考虑推出。TC39委员会的总体考虑是,ES5与ES3基本保持兼容,较大的语法修正和新功能加入,将由JavaScript.next完成。当时,JavaScript.next指的是ES6,第六版发布以后,就指ES7。TC39的判断是,ES5会在2013年的年中成为JavaScript开发的主流标准,并在此后五年中一直保持这个位置。 - -2011年6月,ECMAscript 5.1版发布,并且成为ISO国际标准(ISO/IEC 16262:2011)。 - -2013年3月,ECMAScript 6草案冻结,不再添加新功能。新的功能设想将被放到ECMAScript 7。 - -2013年12月,ECMAScript 6草案发布。然后是12个月的讨论期,听取各方反馈。 - -2015年6月,ECMAScript 6正式通过,成为国际标准。从2000年算起,这时已经过去了15年。 - -## 部署进度 - -各大浏览器的最新版本,对ES6的支持可以查看[kangax.github.io/es5-compat-table/es6/](http://kangax.github.io/es5-compat-table/es6/)。随着时间的推移,支持度已经越来越高了,ES6的大部分特性都实现了。 - -Node.js是JavaScript语言的服务器运行环境,对ES6的支持度比浏览器更高。通过Node,可以体验更多ES6的特性。建议使用版本管理工具[nvm](https://github.com/creationix/nvm),来安装Node,因为可以自由切换版本。不过,`nvm`不支持Windows系统,如果你使用Windows系统,下面的操作可以改用[nvmw](https://github.com/hakobera/nvmw)或[nvm-windows](https://github.com/coreybutler/nvm-windows)代替。 - -安装nvm需要打开命令行窗口,运行下面的命令。 - -```bash -$ curl -o- https://raw.githubusercontent.com/creationix/nvm//install.sh | bash -``` - -上面命令的`version number`处,需要用版本号替换。本节写作时的版本号是`v0.29.0`。该命令运行后,`nvm`会默认安装在用户主目录的`.nvm`子目录。 - -然后,激活`nvm`。 - -```bash -$ source ~/.nvm/nvm.sh -``` - -激活以后,安装Node的最新版。 - -```bash -$ nvm install node -``` - -安装完成后,切换到该版本。 - -```bash -$ nvm use node -``` - -使用下面的命令,可以查看Node所有已经实现的ES6特性。 - -```bash -$ node --v8-options | grep harmony - - --harmony_typeof - --harmony_scoping - --harmony_modules - --harmony_symbols - --harmony_proxies - --harmony_collections - --harmony_observation - --harmony_generators - --harmony_iteration - --harmony_numeric_literals - --harmony_strings - --harmony_arrays - --harmony_maths - --harmony -``` - -上面命令的输出结果,会因为版本的不同而有所不同。 - -我写了一个[ES-Checker](https://github.com/ruanyf/es-checker)模块,用来检查各种运行环境对ES6的支持情况。访问[ruanyf.github.io/es-checker](http://ruanyf.github.io/es-checker),可以看到您的浏览器支持ES6的程度。运行下面的命令,可以查看你正在使用的Node环境对ES6的支持程度。 - -```bash -$ npm install -g es-checker -$ es-checker - -========================================= -Passes 24 feature Dectations -Your runtime supports 57% of ECMAScript 6 -========================================= -``` - -## Babel转码器 - -[Babel](https://babeljs.io/)是一个广泛使用的ES6转码器,可以将ES6代码转为ES5代码,从而在现有环境执行。这意味着,你可以用ES6的方式编写程序,又不用担心现有环境是否支持。下面是一个例子。 - -```javascript -// 转码前 -input.map(item => item + 1); - -// 转码后 -input.map(function (item) { - return item + 1; -}); -``` - -上面的原始代码用了箭头函数,这个特性还没有得到广泛支持,Babel将其转为普通函数,就能在现有的JavaScript环境执行了。 - -### 配置文件`.babelrc` - -Babel的配置文件是`.babelrc`,存放在项目的根目录下。使用Babel的第一步,就是配置这个文件。 - -该文件用来设置转码规则和插件,基本格式如下。 - -```javascript -{ - "presets": [], - "plugins": [] -} -``` - -`presets`字段设定转码规则,官方提供以下的规则集,你可以根据需要安装。 - -```bash -# ES2015转码规则 -$ npm install --save-dev babel-preset-es2015 - -# react转码规则 -$ npm install --save-dev babel-preset-react - -# ES7不同阶段语法提案的转码规则(共有4个阶段),选装一个 -$ npm install --save-dev babel-preset-stage-0 -$ npm install --save-dev babel-preset-stage-1 -$ npm install --save-dev babel-preset-stage-2 -$ npm install --save-dev babel-preset-stage-3 -``` - -然后,将这些规则加入`.babelrc`。 - -```javascript - { - "presets": [ - "es2015", - "react", - "stage-2" - ], - "plugins": [] - } -``` - -注意,以下所有Babel工具和模块的使用,都必须先写好`.babelrc`。 - -### 命令行转码`babel-cli` - -Babel提供`babel-cli`工具,用于命令行转码。 - -它的安装命令如下。 - -```bash -$ npm install --global babel-cli -``` - -基本用法如下。 - -```bash -# 转码结果输出到标准输出 -$ babel example.js - -# 转码结果写入一个文件 -# --out-file 或 -o 参数指定输出文件 -$ babel example.js --out-file compiled.js -# 或者 -$ babel example.js -o compiled.js - -# 整个目录转码 -# --out-dir 或 -d 参数指定输出目录 -$ babel src --out-dir lib -# 或者 -$ babel src -d lib - -# -s 参数生成source map文件 -$ babel src -d lib -s -``` - -上面代码是在全局环境下,进行Babel转码。这意味着,如果项目要运行,全局环境必须有Babel,也就是说项目产生了对环境的依赖。另一方面,这样做也无法支持不同项目使用不同版本的Babel。 - -一个解决办法是将`babel-cli`安装在项目之中。 - -```bash -# 安装 -$ npm install --save-dev babel-cli -``` - -然后,改写`package.json`。 - -```javascript -{ - // ... - "devDependencies": { - "babel-cli": "^6.0.0" - }, - "scripts": { - "build": "babel src -d lib" - }, -} -``` - -转码的时候,就执行下面的命令。 - -```javascript -$ npm run build -``` - -### babel-node - -`babel-cli`工具自带一个`babel-node`命令,提供一个支持ES6的REPL环境。它支持Node的REPL环境的所有功能,而且可以直接运行ES6代码。 - -它不用单独安装,而是随`babel-cli`一起安装。然后,执行`babel-node`就进入REPL环境。 - -```bash -$ babel-node -> (x => x * 2)(1) -2 -``` - -`babel-node`命令可以直接运行ES6脚本。将上面的代码放入脚本文件`es6.js`,然后直接运行。 - -```bash -$ babel-node es6.js -2 -``` - -`babel-node`也可以安装在项目中。 - -```bash -$ npm install --save-dev babel-cli -``` - -然后,改写`package.json`。 - -```javascript -{ - "scripts": { - "script-name": "babel-node script.js" - } -} -``` - -上面代码中,使用`babel-node`替代`node`,这样`script.js`本身就不用做任何转码处理。 - -### babel-register - -`babel-register`模块改写`require`命令,为它加上一个钩子。此后,每当使用`require`加载`.js`、`.jsx`、`.es`和`.es6`后缀名的文件,就会先用Babel进行转码。 - -```bash -$ npm install --save-dev babel-register -``` - -使用时,必须首先加载`babel-register`。 - -```bash -require("babel-register"); -require("./index.js"); -``` - -然后,就不需要手动对`index.js`转码了。 - -需要注意的是,`babel-register`只会对`require`命令加载的文件转码,而不会对当前文件转码。另外,由于它是实时转码,所以只适合在开发环境使用。 - -### babel-core - -如果某些代码需要调用Babel的API进行转码,就要使用`babel-core`模块。 - -安装命令如下。 - -```bash -$ npm install babel-core --save -``` - -然后,在项目中就可以调用`babel-core`。 - -```javascript -var babel = require('babel-core'); - -// 字符串转码 -babel.transform('code();', options); -// => { code, map, ast } - -// 文件转码(异步) -babel.transformFile('filename.js', options, function(err, result) { - result; // => { code, map, ast } -}); - -// 文件转码(同步) -babel.transformFileSync('filename.js', options); -// => { code, map, ast } - -// Babel AST转码 -babel.transformFromAst(ast, code, options); -// => { code, map, ast } -``` - -配置对象`options`,可以参看官方文档[http://babeljs.io/docs/usage/options/](http://babeljs.io/docs/usage/options/)。 - -下面是一个例子。 - -```javascript -var es6Code = 'let x = n => n + 1'; -var es5Code = require('babel-core') - .transform(es6Code, { - presets: ['es2015'] - }) - .code; -// '"use strict";\n\nvar x = function x(n) {\n return n + 1;\n};' -``` - -上面代码中,`transform`方法的第一个参数是一个字符串,表示需要被转换的ES6代码,第二个参数是转换的配置对象。 - -### babel-polyfill - -Babel默认只转换新的JavaScript句法(syntax),而不转换新的API,比如Iterator、Generator、Set、Maps、Proxy、Reflect、Symbol、Promise等全局对象,以及一些定义在全局对象上的方法(比如`Object.assign`)都不会转码。 - -举例来说,ES6在`Array`对象上新增了`Array.from`方法。Babel就不会转码这个方法。如果想让这个方法运行,必须使用`babel-polyfill`,为当前环境提供一个垫片。 - -安装命令如下。 - -```bash -$ npm install --save babel-polyfill -``` - -然后,在脚本头部,加入如下一行代码。 - -```javascript -import 'babel-polyfill'; -// 或者 -require('babel-polyfill'); -``` - -Babel默认不转码的API非常多,详细清单可以查看`babel-plugin-transform-runtime`模块的[definitions.js](https://github.com/babel/babel/blob/master/packages/babel-plugin-transform-runtime/src/definitions.js)文件。 - -### 浏览器环境 - -Babel也可以用于浏览器环境。但是,从Babel 6.0开始,不再直接提供浏览器版本,而是要用构建工具构建出来。如果你没有或不想使用构建工具,可以通过安装5.x版本的`babel-core`模块获取。 - -```bash -$ npm install babel-core@5 -``` - -运行上面的命令以后,就可以在当前目录的`node_modules/babel-core/`子目录里面,找到`babel`的浏览器版本`browser.js`(未精简)和`browser.min.js`(已精简)。 - -然后,将下面的代码插入网页。 - -```html - - -``` - -上面代码中,`browser.js`是Babel提供的转换器脚本,可以在浏览器运行。用户的ES6脚本放在`script`标签之中,但是要注明`type="text/babel"`。 - -另一种方法是使用[babel-standalone](https://github.com/Daniel15/babel-standalone)模块提供的浏览器版本,将其插入网页。 - -```html - - -``` - -注意,网页中实时将ES6代码转为ES5,对性能会有影响。生产环境需要加载已经转码完成的脚本。 - -下面是如何将代码打包成浏览器可以使用的脚本,以`Babel`配合`Browserify`为例。首先,安装`babelify`模块。 - -```bash -$ npm install --save-dev babelify babel-preset-es2015 -``` - -然后,再用命令行转换ES6脚本。 - -```bash -$ browserify script.js -o bundle.js \ - -t [ babelify --presets [ es2015 ] ] -``` - -上面代码将ES6脚本`script.js`,转为`bundle.js`,浏览器直接加载后者就可以了。 - -在`package.json`设置下面的代码,就不用每次命令行都输入参数了。 - -```javascript -{ - "browserify": { - "transform": [["babelify", { "presets": ["es2015"] }]] - } -} -``` - -### 在线转换 - -Babel提供一个[REPL在线编译器](https://babeljs.io/repl/),可以在线将ES6代码转为ES5代码。转换后的代码,可以直接作为ES5代码插入网页运行。 - -### 与其他工具的配合 - -许多工具需要Babel进行前置转码,这里举两个例子:ESLint和Mocha。 - -ESLint用于静态检查代码的语法和风格,安装命令如下。 - -```bash -$ npm install --save-dev eslint babel-eslint -``` - -然后,在项目根目录下,新建一个配置文件`.eslintrc`,在其中加入`parser`字段。 - -```javascript -{ - "parser": "babel-eslint", - "rules": { - ... - } -} -``` - -再在`package.json`之中,加入相应的`scripts`脚本。 - -```javascript - { - "name": "my-module", - "scripts": { - "lint": "eslint my-files.js" - }, - "devDependencies": { - "babel-eslint": "...", - "eslint": "..." - } - } -``` - -Mocha则是一个测试框架,如果需要执行使用ES6语法的测试脚本,可以修改`package.json`的`scripts.test`。 - -```javascript -"scripts": { - "test": "mocha --ui qunit --compilers js:babel-core/register" -} -``` - -上面命令中,`--compilers`参数指定脚本的转码器,规定后缀名为`js`的文件,都需要使用`babel-core/register`先转码。 - -## Traceur转码器 - -Google公司的[Traceur](https://github.com/google/traceur-compiler)转码器,也可以将ES6代码转为ES5代码。 - -### 直接插入网页 - -Traceur允许将ES6代码直接插入网页。首先,必须在网页头部加载Traceur库文件。 - -```html - - - - -``` - -上面代码中,一共有4个`script`标签。第一个是加载Traceur的库文件,第二个和第三个是将这个库文件用于浏览器环境,第四个则是加载用户脚本,这个脚本里面可以使用ES6代码。 - -注意,第四个`script`标签的`type`属性的值是`module`,而不是`text/javascript`。这是Traceur编译器识别ES6代码的标志,编译器会自动将所有`type=module`的代码编译为ES5,然后再交给浏览器执行。 - -除了引用外部ES6脚本,也可以直接在网页中放置ES6代码。 - -```javascript - -``` - -正常情况下,上面代码会在控制台打印出9。 - -如果想对Traceur的行为有精确控制,可以采用下面参数配置的写法。 - -```javascript - -``` - -上面代码中,首先生成Traceur的全局对象`window.System`,然后`System.import`方法可以用来加载ES6模块。加载的时候,需要传入一个配置对象`metadata`,该对象的`traceurOptions`属性可以配置支持ES6功能。如果设为`experimental: true`,就表示除了ES6以外,还支持一些实验性的新功能。 - -### 在线转换 - -Traceur也提供一个[在线编译器](http://google.github.io/traceur-compiler/demo/repl.html),可以在线将ES6代码转为ES5代码。转换后的代码,可以直接作为ES5代码插入网页运行。 - -上面的例子转为ES5代码运行,就是下面这个样子。 - -```javascript - - - - -``` - -### 命令行转换 - -作为命令行工具使用时,Traceur是一个Node的模块,首先需要用Npm安装。 - -```bash -$ npm install -g traceur -``` - -安装成功后,就可以在命令行下使用Traceur了。 - -Traceur直接运行es6脚本文件,会在标准输出显示运行结果,以前面的`calc.js`为例。 - -```bash -$ traceur calc.js -Calc constructor -9 -``` - -如果要将ES6脚本转为ES5保存,要采用下面的写法。 - -```bash -$ traceur --script calc.es6.js --out calc.es5.js -``` - -上面代码的`--script`选项表示指定输入文件,`--out`选项表示指定输出文件。 - -为了防止有些特性编译不成功,最好加上`--experimental`选项。 - -```bash -$ traceur --script calc.es6.js --out calc.es5.js --experimental -``` - -命令行下转换生成的文件,就可以直接放到浏览器中运行。 - -### Node.js环境的用法 - -Traceur的Node.js用法如下(假定已安装traceur模块)。 - -```javascript -var traceur = require('traceur'); -var fs = require('fs'); - -// 将ES6脚本转为字符串 -var contents = fs.readFileSync('es6-file.js').toString(); - -var result = traceur.compile(contents, { - filename: 'es6-file.js', - sourceMap: true, - // 其他设置 - modules: 'commonjs' -}); - -if (result.error) - throw result.error; - -// result对象的js属性就是转换后的ES5代码 -fs.writeFileSync('out.js', result.js); -// sourceMap属性对应map文件 -fs.writeFileSync('out.js.map', result.sourceMap); -``` - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/object.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/object.md" deleted file mode 100644 index 8ac6d75d3..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/object.md" +++ /dev/null @@ -1,1387 +0,0 @@ -# 对象的扩展 - -## 属性的简洁表示法 - -ES6允许直接写入变量和函数,作为对象的属性和方法。这样的书写更加简洁。 - -```javascript -var foo = 'bar'; -var baz = {foo}; -baz // {foo: "bar"} - -// 等同于 -var baz = {foo: foo}; -``` - -上面代码表明,ES6 允许在对象之中,直接写变量。这时,属性名为变量名, 属性值为变量的值。下面是另一个例子。 - -```javascript -function f(x, y) { - return {x, y}; -} - -// 等同于 - -function f(x, y) { - return {x: x, y: y}; -} - -f(1, 2) // Object {x: 1, y: 2} -``` - -除了属性简写,方法也可以简写。 - -```javascript -var o = { - method() { - return "Hello!"; - } -}; - -// 等同于 - -var o = { - method: function() { - return "Hello!"; - } -}; -``` - -下面是一个实际的例子。 - -```javascript -var birth = '2000/01/01'; - -var Person = { - - name: '张三', - - //等同于birth: birth - birth, - - // 等同于hello: function ()... - hello() { console.log('我的名字是', this.name); } - -}; -``` - -这种写法用于函数的返回值,将会非常方便。 - -```javascript -function getPoint() { - var x = 1; - var y = 10; - return {x, y}; -} - -getPoint() -// {x:1, y:10} -``` - -CommonJS模块输出变量,就非常合适使用简洁写法。 - -```javascript -var ms = {}; - -function getItem (key) { - return key in ms ? ms[key] : null; -} - -function setItem (key, value) { - ms[key] = value; -} - -function clear () { - ms = {}; -} - -module.exports = { getItem, setItem, clear }; -// 等同于 -module.exports = { - getItem: getItem, - setItem: setItem, - clear: clear -}; -``` - -属性的赋值器(setter)和取值器(getter),事实上也是采用这种写法。 - -```javascript -var cart = { - _wheels: 4, - - get wheels () { - return this._wheels; - }, - - set wheels (value) { - if (value < this._wheels) { - throw new Error('数值太小了!'); - } - this._wheels = value; - } -} -``` - -注意,简洁写法的属性名总是字符串,这会导致一些看上去比较奇怪的结果。 - -```javascript -var obj = { - class () {} -}; - -// 等同于 - -var obj = { - 'class': function() {} -}; -``` - -上面代码中,`class`是字符串,所以不会因为它属于关键字,而导致语法解析报错。 - -如果某个方法的值是一个Generator函数,前面需要加上星号。 - -```javascript -var obj = { - * m(){ - yield 'hello world'; - } -}; -``` - -## 属性名表达式 - -JavaScript语言定义对象的属性,有两种方法。 - -```javascript -// 方法一 -obj.foo = true; - -// 方法二 -obj['a' + 'bc'] = 123; -``` - -上面代码的方法一是直接用标识符作为属性名,方法二是用表达式作为属性名,这时要将表达式放在方括号之内。 - -但是,如果使用字面量方式定义对象(使用大括号),在 ES5 中只能使用方法一(标识符)定义属性。 - -```javascript -var obj = { - foo: true, - abc: 123 -}; -``` - -ES6 允许字面量定义对象时,用方法二(表达式)作为对象的属性名,即把表达式放在方括号内。 - -```javascript -let propKey = 'foo'; - -let obj = { - [propKey]: true, - ['a' + 'bc']: 123 -}; -``` - -下面是另一个例子。 - -```javascript -var lastWord = 'last word'; - -var a = { - 'first word': 'hello', - [lastWord]: 'world' -}; - -a['first word'] // "hello" -a[lastWord] // "world" -a['last word'] // "world" -``` - -表达式还可以用于定义方法名。 - -```javascript -let obj = { - ['h' + 'ello']() { - return 'hi'; - } -}; - -obj.hello() // hi -``` - -注意,属性名表达式与简洁表示法,不能同时使用,会报错。 - -```javascript -// 报错 -var foo = 'bar'; -var bar = 'abc'; -var baz = { [foo] }; - -// 正确 -var foo = 'bar'; -var baz = { [foo]: 'abc'}; -``` - -注意,属性名表达式如果是一个对象,默认情况下会自动将对象转为字符串`[object Object]`,这一点要特别小心。 - -```javascript -const keyA = {a: 1}; -const keyB = {b: 2}; - -const myObject = { - [keyA]: 'valueA', - [keyB]: 'valueB' -}; - -myObject // Object {[object Object]: "valueB"} -``` - -上面代码中,`[keyA]`和`[keyB]`得到的都是`[object Object]`,所以`[keyB]`会把`[keyA]`覆盖掉,而`myObject`最后只有一个`[object Object]`属性。 - -## 方法的 name 属性 - -函数的`name`属性,返回函数名。对象方法也是函数,因此也有`name`属性。 - -```javascript -const person = { - sayName() { -    console.log('hello!'); - }, -}; - -person.sayName.name // "sayName" -``` - -上面代码中,方法的`name`属性返回函数名(即方法名)。 - -如果对象的方法使用了取值函数(`getter`)和存值函数(`setter`),则`name`属性不是在该方法上面,而是该方法的属性的描述对象的`get`和`set`属性上面,返回值是方法名前加上`get`和`set`。 - -```javascript -const obj = { - get foo() {}, - set foo(x) {} -}; - -obj.foo.name -// TypeError: Cannot read property 'name' of undefined - -const descriptor = Object.getOwnPropertyDescriptor(obj, 'foo'); - -descriptor.get.name // "get foo" -descriptor.set.name // "set foo" -``` - -有两种特殊情况:`bind`方法创造的函数,`name`属性返回`bound`加上原函数的名字;`Function`构造函数创造的函数,`name`属性返回`anonymous`。 - -```javascript -(new Function()).name // "anonymous" - -var doSomething = function() { - // ... -}; -doSomething.bind().name // "bound doSomething" -``` - -如果对象的方法是一个 Symbol 值,那么`name`属性返回的是这个 Symbol 值的描述。 - -```javascript -const key1 = Symbol('description'); -const key2 = Symbol(); -let obj = { - [key1]() {}, - [key2]() {}, -}; -obj[key1].name // "[description]" -obj[key2].name // "" -``` - -上面代码中,`key1`对应的 Symbol 值有描述,`key2`没有。 - -## Object.is() - -ES5比较两个值是否相等,只有两个运算符:相等运算符(`==`)和严格相等运算符(`===`)。它们都有缺点,前者会自动转换数据类型,后者的`NaN`不等于自身,以及`+0`等于`-0`。JavaScript缺乏一种运算,在所有环境中,只要两个值是一样的,它们就应该相等。 - -ES6提出“Same-value equality”(同值相等)算法,用来解决这个问题。`Object.is`就是部署这个算法的新方法。它用来比较两个值是否严格相等,与严格比较运算符(===)的行为基本一致。 - -```javascript -Object.is('foo', 'foo') -// true -Object.is({}, {}) -// false -``` - -不同之处只有两个:一是`+0`不等于`-0`,二是`NaN`等于自身。 - -```javascript -+0 === -0 //true -NaN === NaN // false - -Object.is(+0, -0) // false -Object.is(NaN, NaN) // true -``` - -ES5可以通过下面的代码,部署`Object.is`。 - -```javascript -Object.defineProperty(Object, 'is', { - value: function(x, y) { - if (x === y) { - // 针对+0 不等于 -0的情况 - return x !== 0 || 1 / x === 1 / y; - } - // 针对NaN的情况 - return x !== x && y !== y; - }, - configurable: true, - enumerable: false, - writable: true -}); -``` - -## Object.assign() - -### 基本用法 - -`Object.assign`方法用于对象的合并,将源对象(source)的所有可枚举属性,复制到目标对象(target)。 - -```javascript -var target = { a: 1 }; - -var source1 = { b: 2 }; -var source2 = { c: 3 }; - -Object.assign(target, source1, source2); -target // {a:1, b:2, c:3} -``` - -`Object.assign`方法的第一个参数是目标对象,后面的参数都是源对象。 - -注意,如果目标对象与源对象有同名属性,或多个源对象有同名属性,则后面的属性会覆盖前面的属性。 - -```javascript -var target = { a: 1, b: 1 }; - -var source1 = { b: 2, c: 2 }; -var source2 = { c: 3 }; - -Object.assign(target, source1, source2); -target // {a:1, b:2, c:3} -``` - -如果只有一个参数,`Object.assign`会直接返回该参数。 - -```javascript -var obj = {a: 1}; -Object.assign(obj) === obj // true -``` - -如果该参数不是对象,则会先转成对象,然后返回。 - -```javascript -typeof Object.assign(2) // "object" -``` - -由于`undefined`和`null`无法转成对象,所以如果它们作为参数,就会报错。 - -```javascript -Object.assign(undefined) // 报错 -Object.assign(null) // 报错 -``` - -如果非对象参数出现在源对象的位置(即非首参数),那么处理规则有所不同。首先,这些参数都会转成对象,如果无法转成对象,就会跳过。这意味着,如果`undefined`和`null`不在首参数,就不会报错。 - -```javascript -let obj = {a: 1}; -Object.assign(obj, undefined) === obj // true -Object.assign(obj, null) === obj // true -``` - -其他类型的值(即数值、字符串和布尔值)不在首参数,也不会报错。但是,除了字符串会以数组形式,拷贝入目标对象,其他值都不会产生效果。 - -```javascript -var v1 = 'abc'; -var v2 = true; -var v3 = 10; - -var obj = Object.assign({}, v1, v2, v3); -console.log(obj); // { "0": "a", "1": "b", "2": "c" } -``` - -上面代码中,`v1`、`v2`、`v3`分别是字符串、布尔值和数值,结果只有字符串合入目标对象(以字符数组的形式),数值和布尔值都会被忽略。这是因为只有字符串的包装对象,会产生可枚举属性。 - -```javascript -Object(true) // {[[PrimitiveValue]]: true} -Object(10) // {[[PrimitiveValue]]: 10} -Object('abc') // {0: "a", 1: "b", 2: "c", length: 3, [[PrimitiveValue]]: "abc"} -``` - -上面代码中,布尔值、数值、字符串分别转成对应的包装对象,可以看到它们的原始值都在包装对象的内部属性`[[PrimitiveValue]]`上面,这个属性是不会被`Object.assign`拷贝的。只有字符串的包装对象,会产生可枚举的实义属性,那些属性则会被拷贝。 - -`Object.assign`拷贝的属性是有限制的,只拷贝源对象的自身属性(不拷贝继承属性),也不拷贝不可枚举的属性(`enumerable: false`)。 - -```javascript -Object.assign({b: 'c'}, - Object.defineProperty({}, 'invisible', { - enumerable: false, - value: 'hello' - }) -) -// { b: 'c' } -``` - -上面代码中,`Object.assign`要拷贝的对象只有一个不可枚举属性`invisible`,这个属性并没有被拷贝进去。 - -属性名为Symbol值的属性,也会被`Object.assign`拷贝。 - -```javascript -Object.assign({ a: 'b' }, { [Symbol('c')]: 'd' }) -// { a: 'b', Symbol(c): 'd' } -``` - -### 注意点 - -`Object.assign`方法实行的是浅拷贝,而不是深拷贝。也就是说,如果源对象某个属性的值是对象,那么目标对象拷贝得到的是这个对象的引用。 - -```javascript -var obj1 = {a: {b: 1}}; -var obj2 = Object.assign({}, obj1); - -obj1.a.b = 2; -obj2.a.b // 2 -``` - -上面代码中,源对象`obj1`的`a`属性的值是一个对象,`Object.assign`拷贝得到的是这个对象的引用。这个对象的任何变化,都会反映到目标对象上面。 - -对于这种嵌套的对象,一旦遇到同名属性,`Object.assign`的处理方法是替换,而不是添加。 - -```javascript -var target = { a: { b: 'c', d: 'e' } } -var source = { a: { b: 'hello' } } -Object.assign(target, source) -// { a: { b: 'hello' } } -``` - -上面代码中,`target`对象的`a`属性被`source`对象的`a`属性整个替换掉了,而不会得到`{ a: { b: 'hello', d: 'e' } }`的结果。这通常不是开发者想要的,需要特别小心。 - -有一些函数库提供`Object.assign`的定制版本(比如Lodash的`_.defaultsDeep`方法),可以解决浅拷贝的问题,得到深拷贝的合并。 - -注意,`Object.assign`可以用来处理数组,但是会把数组视为对象。 - -```javascript -Object.assign([1, 2, 3], [4, 5]) -// [4, 5, 3] -``` - -上面代码中,`Object.assign`把数组视为属性名为0、1、2的对象,因此源数组的0号属性`4`覆盖了目标数组的0号属性`1`。 - -### 常见用途 - -`Object.assign`方法有很多用处。 - -**(1)为对象添加属性** - -```javascript -class Point { - constructor(x, y) { - Object.assign(this, {x, y}); - } -} -``` - -上面方法通过`Object.assign`方法,将`x`属性和`y`属性添加到`Point`类的对象实例。 - -**(2)为对象添加方法** - -```javascript -Object.assign(SomeClass.prototype, { - someMethod(arg1, arg2) { - ··· - }, - anotherMethod() { - ··· - } -}); - -// 等同于下面的写法 -SomeClass.prototype.someMethod = function (arg1, arg2) { - ··· -}; -SomeClass.prototype.anotherMethod = function () { - ··· -}; -``` - -上面代码使用了对象属性的简洁表示法,直接将两个函数放在大括号中,再使用assign方法添加到SomeClass.prototype之中。 - -**(3)克隆对象** - -```javascript -function clone(origin) { - return Object.assign({}, origin); -} -``` - -上面代码将原始对象拷贝到一个空对象,就得到了原始对象的克隆。 - -不过,采用这种方法克隆,只能克隆原始对象自身的值,不能克隆它继承的值。如果想要保持继承链,可以采用下面的代码。 - -```javascript -function clone(origin) { - let originProto = Object.getPrototypeOf(origin); - return Object.assign(Object.create(originProto), origin); -} -``` - -**(4)合并多个对象** - -将多个对象合并到某个对象。 - -```javascript -const merge = - (target, ...sources) => Object.assign(target, ...sources); -``` - -如果希望合并后返回一个新对象,可以改写上面函数,对一个空对象合并。 - -```javascript -const merge = - (...sources) => Object.assign({}, ...sources); -``` - -**(5)为属性指定默认值** - -```javascript -const DEFAULTS = { - logLevel: 0, - outputFormat: 'html' -}; - -function processContent(options) { - options = Object.assign({}, DEFAULTS, options); - console.log(options); - // ... -} -``` - -上面代码中,`DEFAULTS`对象是默认值,`options`对象是用户提供的参数。`Object.assign`方法将`DEFAULTS`和`options`合并成一个新对象,如果两者有同名属性,则`option`的属性值会覆盖`DEFAULTS`的属性值。 - -注意,由于存在深拷贝的问题,`DEFAULTS`对象和`options`对象的所有属性的值,最好都是简单类型,不要指向另一个对象。否则,`DEFAULTS`对象的该属性很可能不起作用。 - -```javascript -const DEFAULTS = { - url: { - host: 'example.com', - port: 7070 - }, -}; - -processContent({ url: {port: 8000} }) -// { -// url: {port: 8000} -// } -``` - -上面代码的原意是将`url.port`改成8000,`url.host`不变。实际结果却是`options.url`覆盖掉`DEFAULTS.url`,所以`url.host`就不存在了。 - -## 属性的可枚举性 - -对象的每个属性都有一个描述对象(Descriptor),用来控制该属性的行为。`Object.getOwnPropertyDescriptor`方法可以获取该属性的描述对象。 - -```javascript -let obj = { foo: 123 }; -Object.getOwnPropertyDescriptor(obj, 'foo') -// { -// value: 123, -// writable: true, -// enumerable: true, -// configurable: true -// } -``` - -描述对象的`enumerable`属性,称为”可枚举性“,如果该属性为`false`,就表示某些操作会忽略当前属性。 - -ES5有三个操作会忽略`enumerable`为`false`的属性。 - -- `for...in`循环:只遍历对象自身的和继承的可枚举的属性 -- `Object.keys()`:返回对象自身的所有可枚举的属性的键名 -- `JSON.stringify()`:只串行化对象自身的可枚举的属性 - -ES6新增了一个操作`Object.assign()`,会忽略`enumerable`为`false`的属性,只拷贝对象自身的可枚举的属性。 - -这四个操作之中,只有`for...in`会返回继承的属性。实际上,引入`enumerable`的最初目的,就是让某些属性可以规避掉`for...in`操作。比如,对象原型的`toString`方法,以及数组的`length`属性,就通过这种手段,不会被`for...in`遍历到。 - -```javascript -Object.getOwnPropertyDescriptor(Object.prototype, 'toString').enumerable -// false - -Object.getOwnPropertyDescriptor([], 'length').enumerable -// false -``` - -上面代码中,`toString`和`length`属性的`enumerable`都是`false`,因此`for...in`不会遍历到这两个继承自原型的属性。 - -另外,ES6规定,所有Class的原型的方法都是不可枚举的。 - -```javascript -Object.getOwnPropertyDescriptor(class {foo() {}}.prototype, 'foo').enumerable -// false -``` - -总的来说,操作中引入继承的属性会让问题复杂化,大多数时候,我们只关心对象自身的属性。所以,尽量不要用`for...in`循环,而用`Object.keys()`代替。 - -## 属性的遍历 - -ES6一共有5种方法可以遍历对象的属性。 - -**(1)for...in** - -`for...in`循环遍历对象自身的和继承的可枚举属性(不含Symbol属性)。 - -**(2)Object.keys(obj)** - -`Object.keys`返回一个数组,包括对象自身的(不含继承的)所有可枚举属性(不含Symbol属性)。 - -**(3)Object.getOwnPropertyNames(obj)** - -`Object.getOwnPropertyNames`返回一个数组,包含对象自身的所有属性(不含Symbol属性,但是包括不可枚举属性)。 - -**(4)Object.getOwnPropertySymbols(obj)** - -`Object.getOwnPropertySymbols`返回一个数组,包含对象自身的所有Symbol属性。 - -**(5)Reflect.ownKeys(obj)** - -`Reflect.ownKeys`返回一个数组,包含对象自身的所有属性,不管是属性名是Symbol或字符串,也不管是否可枚举。 - -以上的5种方法遍历对象的属性,都遵守同样的属性遍历的次序规则。 - -- 首先遍历所有属性名为数值的属性,按照数字排序。 -- 其次遍历所有属性名为字符串的属性,按照生成时间排序。 -- 最后遍历所有属性名为Symbol值的属性,按照生成时间排序。 - -```javascript -Reflect.ownKeys({ [Symbol()]:0, b:0, 10:0, 2:0, a:0 }) -// ['2', '10', 'b', 'a', Symbol()] -``` - -上面代码中,`Reflect.ownKeys`方法返回一个数组,包含了参数对象的所有属性。这个数组的属性次序是这样的,首先是数值属性`2`和`10`,其次是字符串属性`b`和`a`,最后是Symbol属性。 - -## `__proto__`属性,Object.setPrototypeOf(),Object.getPrototypeOf() - -### `__proto__`属性 - -`__proto__`属性(前后各两个下划线),用来读取或设置当前对象的`prototype`对象。目前,所有浏览器(包括 IE11)都部署了这个属性。 - -```javascript -// es6的写法 -var obj = { - method: function() { ... } -}; -obj.__proto__ = someOtherObj; - -// es5的写法 -var obj = Object.create(someOtherObj); -obj.method = function() { ... }; -``` - -该属性没有写入 ES6 的正文,而是写入了附录,原因是`__proto__`前后的双下划线,说明它本质上是一个内部属性,而不是一个正式的对外的 API,只是由于浏览器广泛支持,才被加入了 ES6。标准明确规定,只有浏览器必须部署这个属性,其他运行环境不一定需要部署,而且新的代码最好认为这个属性是不存在的。因此,无论从语义的角度,还是从兼容性的角度,都不要使用这个属性,而是使用下面的`Object.setPrototypeOf()`(写操作)、`Object.getPrototypeOf()`(读操作)、`Object.create()`(生成操作)代替。 - -在实现上,`__proto__`调用的是`Object.prototype.__proto__`,具体实现如下。 - -```javascript -Object.defineProperty(Object.prototype, '__proto__', { - get() { - let _thisObj = Object(this); - return Object.getPrototypeOf(_thisObj); - }, - set(proto) { - if (this === undefined || this === null) { - throw new TypeError(); - } - if (!isObject(this)) { - return undefined; - } - if (!isObject(proto)) { - return undefined; - } - let status = Reflect.setPrototypeOf(this, proto); - if (!status) { - throw new TypeError(); - } - }, -}); -function isObject(value) { - return Object(value) === value; -} -``` - -如果一个对象本身部署了`__proto__`属性,则该属性的值就是对象的原型。 - -```javascript -Object.getPrototypeOf({ __proto__: null }) -// null -``` - -### Object.setPrototypeOf() - -`Object.setPrototypeOf`方法的作用与`__proto__`相同,用来设置一个对象的`prototype`对象,返回参数对象本身。它是 ES6 正式推荐的设置原型对象的方法。 - -```javascript -// 格式 -Object.setPrototypeOf(object, prototype) - -// 用法 -var o = Object.setPrototypeOf({}, null); -``` - -该方法等同于下面的函数。 - -```javascript -function (obj, proto) { - obj.__proto__ = proto; - return obj; -} -``` - -下面是一个例子。 - -```javascript -let proto = {}; -let obj = { x: 10 }; -Object.setPrototypeOf(obj, proto); - -proto.y = 20; -proto.z = 40; - -obj.x // 10 -obj.y // 20 -obj.z // 40 -``` - -上面代码将`proto`对象设为`obj`对象的原型,所以从`obj`对象可以读取`proto`对象的属性。 - -如果第一个参数不是对象,会自动转为对象。但是由于返回的还是第一个参数,所以这个操作不会产生任何效果。 - -```javascript -Object.setPrototypeOf(1, {}) === 1 // true -Object.setPrototypeOf('foo', {}) === 'foo' // true -Object.setPrototypeOf(true, {}) === true // true -``` - -由于`undefined`和`null`无法转为对象,所以如果第一个参数是`undefined`或`null`,就会报错。 - -```javascript -Object.setPrototypeOf(undefined, {}) -// TypeError: Object.setPrototypeOf called on null or undefined - -Object.setPrototypeOf(null, {}) -// TypeError: Object.setPrototypeOf called on null or undefined -``` - -### Object.getPrototypeOf() - -该方法与`Object.setPrototypeOf`方法配套,用于读取一个对象的原型对象。 - -```javascript -Object.getPrototypeOf(obj); -``` - -下面是一个例子。 - -```javascript -function Rectangle() { - // ... -} - -var rec = new Rectangle(); - -Object.getPrototypeOf(rec) === Rectangle.prototype -// true - -Object.setPrototypeOf(rec, Object.prototype); -Object.getPrototypeOf(rec) === Rectangle.prototype -// false -``` - -如果参数不是对象,会被自动转为对象。 - -```javascript -// 等同于 Object.getPrototypeOf(Number(1)) -Object.getPrototypeOf(1) -// Number {[[PrimitiveValue]]: 0} - -// 等同于 Object.getPrototypeOf(String('foo')) -Object.getPrototypeOf('foo') -// String {length: 0, [[PrimitiveValue]]: ""} - -// 等同于 Object.getPrototypeOf(Boolean(true)) -Object.getPrototypeOf(true) -// Boolean {[[PrimitiveValue]]: false} - -Object.getPrototypeOf(1) === Number.prototype // true -Object.getPrototypeOf('foo') === String.prototype // true -Object.getPrototypeOf(true) === Boolean.prototype // true -``` - -如果参数是`undefined`或`null`,它们无法转为对象,所以会报错。 - -```javascript -Object.getPrototypeOf(null) -// TypeError: Cannot convert undefined or null to object - -Object.getPrototypeOf(undefined) -// TypeError: Cannot convert undefined or null to object -``` - -## Object.keys(),Object.values(),Object.entries() - -### Object.keys() - -ES5 引入了`Object.keys`方法,返回一个数组,成员是参数对象自身的(不含继承的)所有可遍历(enumerable)属性的键名。 - -```javascript -var obj = { foo: 'bar', baz: 42 }; -Object.keys(obj) -// ["foo", "baz"] -``` - -ES2017 [引入](https://github.com/tc39/proposal-object-values-entries)了跟`Object.keys`配套的`Object.values`和`Object.entries`,作为遍历一个对象的补充手段,供`for...of`循环使用。 - -```javascript -let {keys, values, entries} = Object; -let obj = { a: 1, b: 2, c: 3 }; - -for (let key of keys(obj)) { - console.log(key); // 'a', 'b', 'c' -} - -for (let value of values(obj)) { - console.log(value); // 1, 2, 3 -} - -for (let [key, value] of entries(obj)) { - console.log([key, value]); // ['a', 1], ['b', 2], ['c', 3] -} -``` - -### Object.values() - -`Object.values`方法返回一个数组,成员是参数对象自身的(不含继承的)所有可遍历(enumerable)属性的键值。 - -```javascript -var obj = { foo: 'bar', baz: 42 }; -Object.values(obj) -// ["bar", 42] -``` - -返回数组的成员顺序,与本章的《属性的遍历》部分介绍的排列规则一致。 - -```javascript -var obj = { 100: 'a', 2: 'b', 7: 'c' }; -Object.values(obj) -// ["b", "c", "a"] -``` - -上面代码中,属性名为数值的属性,是按照数值大小,从小到大遍历的,因此返回的顺序是`b`、`c`、`a`。 - -`Object.values`只返回对象自身的可遍历属性。 - -```javascript -var obj = Object.create({}, {p: {value: 42}}); -Object.values(obj) // [] -``` - -上面代码中,`Object.create`方法的第二个参数添加的对象属性(属性`p`),如果不显式声明,默认是不可遍历的,因为`p`的属性描述对象的`enumerable`默认是`false`,`Object.values`不会返回这个属性。只要把`enumerable`改成`true`,`Object.values`就会返回属性`p`的值。 - -```javascript -var obj = Object.create({}, {p: - { -    value: 42, -    enumerable: true -  } -}); -Object.values(obj) // [42] -``` - -`Object.values`会过滤属性名为 Symbol 值的属性。 - -```javascript -Object.values({ [Symbol()]: 123, foo: 'abc' }); -// ['abc'] -``` - -如果`Object.values`方法的参数是一个字符串,会返回各个字符组成的一个数组。 - -```javascript -Object.values('foo') -// ['f', 'o', 'o'] -``` - -上面代码中,字符串会先转成一个类似数组的对象。字符串的每个字符,就是该对象的一个属性。因此,`Object.values`返回每个属性的键值,就是各个字符组成的一个数组。 - -如果参数不是对象,`Object.values`会先将其转为对象。由于数值和布尔值的包装对象,都不会为实例添加非继承的属性。所以,`Object.values`会返回空数组。 - -```javascript -Object.values(42) // [] -Object.values(true) // [] -``` - -### Object.entries - -`Object.entries`方法返回一个数组,成员是参数对象自身的(不含继承的)所有可遍历(enumerable)属性的键值对数组。 - -```javascript -var obj = { foo: 'bar', baz: 42 }; -Object.entries(obj) -// [ ["foo", "bar"], ["baz", 42] ] -``` - -除了返回值不一样,该方法的行为与`Object.values`基本一致。 - -如果原对象的属性名是一个 Symbol 值,该属性会被忽略。 - -```javascript -Object.entries({ [Symbol()]: 123, foo: 'abc' }); -// [ [ 'foo', 'abc' ] ] -``` - -上面代码中,原对象有两个属性,`Object.entries`只输出属性名非 Symbol 值的属性。将来可能会有`Reflect.ownEntries()`方法,返回对象自身的所有属性。 - -`Object.entries`的基本用途是遍历对象的属性。 - -```javascript -let obj = { one: 1, two: 2 }; -for (let [k, v] of Object.entries(obj)) { - console.log( - `${JSON.stringify(k)}: ${JSON.stringify(v)}` - ); -} -// "one": 1 -// "two": 2 -``` - -`Object.entries`方法的另一个用处是,将对象转为真正的`Map`结构。 - -```javascript -var obj = { foo: 'bar', baz: 42 }; -var map = new Map(Object.entries(obj)); -map // Map { foo: "bar", baz: 42 } -``` - -自己实现`Object.entries`方法,非常简单。 - -```javascript -// Generator函数的版本 -function* entries(obj) { - for (let key of Object.keys(obj)) { - yield [key, obj[key]]; - } -} - -// 非Generator函数的版本 -function entries(obj) { - let arr = []; - for (let key of Object.keys(obj)) { - arr.push([key, obj[key]]); - } - return arr; -} -``` - -## 对象的扩展运算符 - -《数组的扩展》一章中,已经介绍过扩展预算符(`...`)。 - -```javascript -const [a, ...b] = [1, 2, 3]; -a // 1 -b // [2, 3] -``` - -ES2017 将这个运算符[引入](https://github.com/sebmarkbage/ecmascript-rest-spread)了对象。 - -**(1)解构赋值** - -对象的解构赋值用于从一个对象取值,相当于将所有可遍历的、但尚未被读取的属性,分配到指定的对象上面。所有的键和它们的值,都会拷贝到新对象上面。 - -```javascript -let { x, y, ...z } = { x: 1, y: 2, a: 3, b: 4 }; -x // 1 -y // 2 -z // { a: 3, b: 4 } -``` - -上面代码中,变量`z`是解构赋值所在的对象。它获取等号右边的所有尚未读取的键(`a`和`b`),将它们连同值一起拷贝过来。 - -由于解构赋值要求等号右边是一个对象,所以如果等号右边是`undefined`或`null`,就会报错,因为它们无法转为对象。 - -```javascript -let { x, y, ...z } = null; // 运行时错误 -let { x, y, ...z } = undefined; // 运行时错误 -``` - -解构赋值必须是最后一个参数,否则会报错。 - -```javascript -let { ...x, y, z } = obj; // 句法错误 -let { x, ...y, ...z } = obj; // 句法错误 -``` - -上面代码中,解构赋值不是最后一个参数,所以会报错。 - -注意,解构赋值的拷贝是浅拷贝,即如果一个键的值是复合类型的值(数组、对象、函数)、那么解构赋值拷贝的是这个值的引用,而不是这个值的副本。 - -```javascript -let obj = { a: { b: 1 } }; -let { ...x } = obj; -obj.a.b = 2; -x.a.b // 2 -``` - -上面代码中,`x`是解构赋值所在的对象,拷贝了对象`obj`的`a`属性。`a`属性引用了一个对象,修改这个对象的值,会影响到解构赋值对它的引用。 - -另外,解构赋值不会拷贝继承自原型对象的属性。 - -```javascript -let o1 = { a: 1 }; -let o2 = { b: 2 }; -o2.__proto__ = o1; -let o3 = { ...o2 }; -o3 // { b: 2 } -``` - -上面代码中,对象`o3`是`o2`的拷贝,但是只复制了`o2`自身的属性,没有复制它的原型对象`o1`的属性。 - -下面是另一个例子。 - -```javascript -var o = Object.create({ x: 1, y: 2 }); -o.z = 3; - -let { x, ...{ y, z } } = o; -x // 1 -y // undefined -z // 3 -``` - -上面代码中,变量`x`是单纯的解构赋值,所以可以读取继承的属性;解构赋值产生的变量`y`和`z`,只能读取对象自身的属性,所以只有变量`z`可以赋值成功。 - -解构赋值的一个用处,是扩展某个函数的参数,引入其他操作。 - -```javascript -function baseFunction({ a, b }) { - // ... -} -function wrapperFunction({ x, y, ...restConfig }) { - // 使用x和y参数进行操作 - // 其余参数传给原始函数 - return baseFunction(restConfig); -} -``` - -上面代码中,原始函数`baseFunction`接受`a`和`b`作为参数,函数`wrapperFunction`在`baseFunction`的基础上进行了扩展,能够接受多余的参数,并且保留原始函数的行为。 - -**(2)扩展运算符** - -扩展运算符(`...`)用于取出参数对象的所有可遍历属性,拷贝到当前对象之中。 - -```javascript -let z = { a: 3, b: 4 }; -let n = { ...z }; -n // { a: 3, b: 4 } -``` - -这等同于使用`Object.assign`方法。 - -```javascript -let aClone = { ...a }; -// 等同于 -let aClone = Object.assign({}, a); -``` - -扩展运算符可以用于合并两个对象。 - -```javascript -let ab = { ...a, ...b }; -// 等同于 -let ab = Object.assign({}, a, b); -``` - -如果用户自定义的属性,放在扩展运算符后面,则扩展运算符内部的同名属性会被覆盖掉。 - -```javascript -let aWithOverrides = { ...a, x: 1, y: 2 }; -// 等同于 -let aWithOverrides = { ...a, ...{ x: 1, y: 2 } }; -// 等同于 -let x = 1, y = 2, aWithOverrides = { ...a, x, y }; -// 等同于 -let aWithOverrides = Object.assign({}, a, { x: 1, y: 2 }); -``` - -上面代码中,`a`对象的`x`属性和`y`属性,拷贝到新对象后会被覆盖掉。 - -这用来修改现有对象部分的部分属性就很方便了。 - -```javascript -let newVersion = { - ...previousVersion, - name: 'New Name' // Override the name property -}; -``` - -上面代码中,`newVersion`对象自定义了`name`属性,其他属性全部复制自`previousVersion`对象。 - -如果把自定义属性放在扩展运算符前面,就变成了设置新对象的默认属性值。 - -```javascript -let aWithDefaults = { x: 1, y: 2, ...a }; -// 等同于 -let aWithDefaults = Object.assign({}, { x: 1, y: 2 }, a); -// 等同于 -let aWithDefaults = Object.assign({ x: 1, y: 2 }, a); -``` - -扩展运算符的参数对象之中,如果有取值函数`get`,这个函数是会执行的。 - -```javascript -// 并不会抛出错误,因为x属性只是被定义,但没执行 -let aWithXGetter = { - ...a, - get x() { - throws new Error('not thrown yet'); - } -}; - -// 会抛出错误,因为x属性被执行了 -let runtimeError = { - ...a, - ...{ - get x() { - throws new Error('thrown now'); - } - } -}; -``` - -如果扩展运算符的参数是`null`或`undefined`,这个两个值会被忽略,不会报错。 - -```javascript -let emptyObject = { ...null, ...undefined }; // 不报错 -``` - -## 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); -``` - -上面代码中,对象`a`和`b`被混入了对象`c`。 - -出于完整性的考虑,`Object.getOwnPropertyDescriptors`进入标准以后,还会有`Reflect.getOwnPropertyDescriptors`方法。 - -## Null 传导运算符 - -编程实务中,如果读取对象内部的某个属性,往往需要判断一下该对象是否存在。比如,要读取`message.body.user.firstName`,安全的写法是写成下面这样。 - -```javascript -const firstName = (message - && message.body - && message.body.user - && message.body.user.firstName) || 'default'; -``` - -这样的层层判断非常麻烦,因此现在有一个[提案](https://github.com/claudepache/es-optional-chaining),引入了“Null 传导运算符”(null propagation operator)`?.`,简化上面的写法。 - -```javascript -const firstName = message?.body?.user?.firstName || 'default'; -``` - -上面代码有三个`?.`运算符,只要其中一个返回`null`或`undefined`,就不再往下运算,而是返回`undefined`。 - -“Null 传导运算符”有四种用法。 - -- `obj?.prop` // 读取对象属性 -- `obj?.[expr]` // 同上 -- `func?.(...args)` // 函数或对象方法的调用 -- `new C?.(...args)` // 构造函数的调用 - -传导运算符之所以写成`obj?.prop`,而不是`obj?prop`,是为了方便编译器能够区分三元运算符`?:`(比如`obj?prop:123`)。 - -下面是更多的例子。 - -```javascript -// 如果 a 是 null 或 undefined, 返回 undefined -// 否则返回 a.b.c().d -a?.b.c().d - -// 如果 a 是 null 或 undefined,下面的语句不产生任何效果 -// 否则执行 a.b = 42 -a?.b = 42 - -// 如果 a 是 null 或 undefined,下面的语句不产生任何效果 -delete a?.b -``` - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/regex.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/regex.md" deleted file mode 100644 index 389c35759..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/regex.md" +++ /dev/null @@ -1,517 +0,0 @@ -# 正则的扩展 - -## RegExp构造函数 - -在ES5中,RegExp构造函数的参数有两种情况。 - -第一种情况是,参数是字符串,这时第二个参数表示正则表达式的修饰符(flag)。 - -```javascript -var regex = new RegExp('xyz', 'i'); -// 等价于 -var regex = /xyz/i; -``` - -第二种情况是,参数是一个正则表示式,这时会返回一个原有正则表达式的拷贝。 - -```javascript -var regex = new RegExp(/xyz/i); -// 等价于 -var regex = /xyz/i; -``` - -但是,ES5不允许此时使用第二个参数,添加修饰符,否则会报错。 - -```javascript -var regex = new RegExp(/xyz/, 'i'); -// Uncaught TypeError: Cannot supply flags when constructing one RegExp from another -``` - -ES6改变了这种行为。如果RegExp构造函数第一个参数是一个正则对象,那么可以使用第二个参数指定修饰符。而且,返回的正则表达式会忽略原有的正则表达式的修饰符,只使用新指定的修饰符。 - -```javascript -new RegExp(/abc/ig, 'i').flags -// "i" -``` - -上面代码中,原有正则对象的修饰符是`ig`,它会被第二个参数`i`覆盖。 - -## 字符串的正则方法 - -字符串对象共有4个方法,可以使用正则表达式:`match()`、`replace()`、`search()`和`split()`。 - -ES6将这4个方法,在语言内部全部调用RegExp的实例方法,从而做到所有与正则相关的方法,全都定义在RegExp对象上。 - -- `String.prototype.match` 调用 `RegExp.prototype[Symbol.match]` -- `String.prototype.replace` 调用 `RegExp.prototype[Symbol.replace]` -- `String.prototype.search` 调用 `RegExp.prototype[Symbol.search]` -- `String.prototype.split` 调用 `RegExp.prototype[Symbol.split]` - -## u修饰符 - -ES6对正则表达式添加了`u`修饰符,含义为“Unicode模式”,用来正确处理大于`\uFFFF`的Unicode字符。也就是说,会正确处理四个字节的UTF-16编码。 - -```javascript -/^\uD83D/u.test('\uD83D\uDC2A') -// false -/^\uD83D/.test('\uD83D\uDC2A') -// true -``` - -上面代码中,`\uD83D\uDC2A`是一个四个字节的UTF-16编码,代表一个字符。但是,ES5不支持四个字节的UTF-16编码,会将其识别为两个字符,导致第二行代码结果为`true`。加了`u`修饰符以后,ES6就会识别其为一个字符,所以第一行代码结果为`false`。 - -一旦加上`u`修饰符号,就会修改下面这些正则表达式的行为。 - -**(1)点字符** - -点(`.`)字符在正则表达式中,含义是除了换行符以外的任意单个字符。对于码点大于`0xFFFF`的Unicode字符,点字符不能识别,必须加上`u`修饰符。 - -```javascript -var s = '𠮷'; - -/^.$/.test(s) // false -/^.$/u.test(s) // true -``` - -上面代码表示,如果不添加`u`修饰符,正则表达式就会认为字符串为两个字符,从而匹配失败。 - -**(2)Unicode字符表示法** - -ES6新增了使用大括号表示Unicode字符,这种表示法在正则表达式中必须加上`u`修饰符,才能识别。 - -```javascript -/\u{61}/.test('a') // false -/\u{61}/u.test('a') // true -/\u{20BB7}/u.test('𠮷') // true -``` - -上面代码表示,如果不加`u`修饰符,正则表达式无法识别`\u{61}`这种表示法,只会认为这匹配61个连续的`u`。 - -**(3)量词** - -使用`u`修饰符后,所有量词都会正确识别码点大于`0xFFFF`的Unicode字符。 - -```javascript -/a{2}/.test('aa') // true -/a{2}/u.test('aa') // true -/𠮷{2}/.test('𠮷𠮷') // false -/𠮷{2}/u.test('𠮷𠮷') // true -``` - -另外,只有在使用`u`修饰符的情况下,Unicode表达式当中的大括号才会被正确解读,否则会被解读为量词。 - -```javascript -/^\u{3}$/.test('uuu') // true -``` - -上面代码中,由于正则表达式没有`u`修饰符,所以大括号被解读为量词。加上`u`修饰符,就会被解读为Unicode表达式。 - -**(4)预定义模式** - -`u`修饰符也影响到预定义模式,能否正确识别码点大于`0xFFFF`的Unicode字符。 - -```javascript -/^\S$/.test('𠮷') // false -/^\S$/u.test('𠮷') // true -``` - -上面代码的`\S`是预定义模式,匹配所有不是空格的字符。只有加了`u`修饰符,它才能正确匹配码点大于`0xFFFF`的Unicode字符。 - -利用这一点,可以写出一个正确返回字符串长度的函数。 - -```javascript -function codePointLength(text) { - var result = text.match(/[\s\S]/gu); - return result ? result.length : 0; -} - -var s = '𠮷𠮷'; - -s.length // 4 -codePointLength(s) // 2 -``` - -**(5)i修饰符** - -有些Unicode字符的编码不同,但是字型很相近,比如,`\u004B`与`\u212A`都是大写的`K`。 - -```javascript -/[a-z]/i.test('\u212A') // false -/[a-z]/iu.test('\u212A') // true -``` - -上面代码中,不加`u`修饰符,就无法识别非规范的K字符。 - -## y 修饰符 - -除了`u`修饰符,ES6还为正则表达式添加了`y`修饰符,叫做“粘连”(sticky)修饰符。 - -`y`修饰符的作用与`g`修饰符类似,也是全局匹配,后一次匹配都从上一次匹配成功的下一个位置开始。不同之处在于,`g`修饰符只要剩余位置中存在匹配就可,而`y`修饰符确保匹配必须从剩余的第一个位置开始,这也就是“粘连”的涵义。 - -```javascript -var s = 'aaa_aa_a'; -var r1 = /a+/g; -var r2 = /a+/y; - -r1.exec(s) // ["aaa"] -r2.exec(s) // ["aaa"] - -r1.exec(s) // ["aa"] -r2.exec(s) // null -``` - -上面代码有两个正则表达式,一个使用`g`修饰符,另一个使用`y`修饰符。这两个正则表达式各执行了两次,第一次执行的时候,两者行为相同,剩余字符串都是`_aa_a`。由于`g`修饰没有位置要求,所以第二次执行会返回结果,而`y`修饰符要求匹配必须从头部开始,所以返回`null`。 - -如果改一下正则表达式,保证每次都能头部匹配,`y`修饰符就会返回结果了。 - -```javascript -var s = 'aaa_aa_a'; -var r = /a+_/y; - -r.exec(s) // ["aaa_"] -r.exec(s) // ["aa_"] -``` - -上面代码每次匹配,都是从剩余字符串的头部开始。 - -使用`lastIndex`属性,可以更好地说明`y`修饰符。 - -```javascript -const REGEX = /a/g; - -// 指定从2号位置(y)开始匹配 -REGEX.lastIndex = 2; - -// 匹配成功 -const match = REGEX.exec('xaya'); - -// 在3号位置匹配成功 -match.index // 3 - -// 下一次匹配从4号位开始 -REGEX.lastIndex // 4 - -// 4号位开始匹配失败 -REGEX.exec('xaxa') // null -``` - -上面代码中,`lastIndex`属性指定每次搜索的开始位置,`g`修饰符从这个位置开始向后搜索,直到发现匹配为止。 - -`y`修饰符同样遵守`lastIndex`属性,但是要求必须在`lastIndex`指定的位置发现匹配。 - -```javascript -const REGEX = /a/y; - -// 指定从2号位置开始匹配 -REGEX.lastIndex = 2; - -// 不是粘连,匹配失败 -REGEX.exec('xaya') // null - -// 指定从3号位置开始匹配 -REGEX.lastIndex = 3; - -// 3号位置是粘连,匹配成功 -const match = REGEX.exec('xaxa'); -match.index // 3 -REGEX.lastIndex // 4 -``` - -进一步说,`y`修饰符号隐含了头部匹配的标志`^`。 - -```javascript -/b/y.exec('aba') -// null -``` - -上面代码由于不能保证头部匹配,所以返回`null`。`y`修饰符的设计本意,就是让头部匹配的标志`^`在全局匹配中都有效。 - -在`split`方法中使用`y`修饰符,原字符串必须以分隔符开头。这也意味着,只要匹配成功,数组的第一个成员肯定是空字符串。 - -```javascript -// 没有找到匹配 -'x##'.split(/#/y) -// [ 'x##' ] - -// 找到两个匹配 -'##x'.split(/#/y) -// [ '', '', 'x' ] -``` - -后续的分隔符只有紧跟前面的分隔符,才会被识别。 - -```javascript -'#x#'.split(/#/y) -// [ '', 'x#' ] - -'##'.split(/#/y) -// [ '', '', '' ] -``` - -下面是字符串对象的`replace`方法的例子。 - -```javascript -const REGEX = /a/gy; -'aaxa'.replace(REGEX, '-') // '--xa' -``` - -上面代码中,最后一个`a`因为不是出现下一次匹配的头部,所以不会被替换。 - -单单一个`y`修饰符对`match`方法,只能返回第一个匹配,必须与`g`修饰符联用,才能返回所有匹配。 - -```javascript -'a1a2a3'.match(/a\d/y) // ["a1"] -'a1a2a3'.match(/a\d/gy) // ["a1", "a2", "a3"] -``` - -`y`修饰符的一个应用,是从字符串提取token(词元),`y`修饰符确保了匹配之间不会有漏掉的字符。 - -```javascript -const TOKEN_Y = /\s*(\+|[0-9]+)\s*/y; -const TOKEN_G = /\s*(\+|[0-9]+)\s*/g; - -tokenize(TOKEN_Y, '3 + 4') -// [ '3', '+', '4' ] -tokenize(TOKEN_G, '3 + 4') -// [ '3', '+', '4' ] - -function tokenize(TOKEN_REGEX, str) { - let result = []; - let match; - while (match = TOKEN_REGEX.exec(str)) { - result.push(match[1]); - } - return result; -} -``` - -上面代码中,如果字符串里面没有非法字符,`y`修饰符与`g`修饰符的提取结果是一样的。但是,一旦出现非法字符,两者的行为就不一样了。 - -```javascript -tokenize(TOKEN_Y, '3x + 4') -// [ '3' ] -tokenize(TOKEN_G, '3x + 4') -// [ '3', '+', '4' ] -``` - -上面代码中,`g`修饰符会忽略非法字符,而`y`修饰符不会,这样就很容易发现错误。 - -## sticky属性 - -与`y`修饰符相匹配,ES6的正则对象多了`sticky`属性,表示是否设置了`y`修饰符。 - -```javascript -var r = /hello\d/y; -r.sticky // true -``` - -## flags属性 - -ES6为正则表达式新增了`flags`属性,会返回正则表达式的修饰符。 - -```javascript -// ES5的source属性 -// 返回正则表达式的正文 -/abc/ig.source -// "abc" - -// ES6的flags属性 -// 返回正则表达式的修饰符 -/abc/ig.flags -// 'gi' -``` - -## RegExp.escape() - -字符串必须转义,才能作为正则模式。 - -```javascript -function escapeRegExp(str) { - return str.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, '\\$&'); -} - -let str = '/path/to/resource.html?search=query'; -escapeRegExp(str) -// "\/path\/to\/resource\.html\?search=query" -``` - -上面代码中,`str`是一个正常字符串,必须使用反斜杠对其中的特殊字符转义,才能用来作为一个正则匹配的模式。 - -已经有[提议](https://esdiscuss.org/topic/regexp-escape)将这个需求标准化,作为RegExp对象的静态方法[RegExp.escape()](https://github.com/benjamingr/RexExp.escape),放入ES7。2015年7月31日,TC39认为,这个方法有安全风险,又不愿这个方法变得过于复杂,没有同意将其列入ES7,但这不失为一个真实的需求。 - -```javascript -RegExp.escape('The Quick Brown Fox'); -// "The Quick Brown Fox" - -RegExp.escape('Buy it. use it. break it. fix it.'); -// "Buy it\. use it\. break it\. fix it\." - -RegExp.escape('(*.*)'); -// "\(\*\.\*\)" -``` - -字符串转义以后,可以使用RegExp构造函数生成正则模式。 - -```javascript -var str = 'hello. how are you?'; -var regex = new RegExp(RegExp.escape(str), 'g'); -assert.equal(String(regex), '/hello\. how are you\?/g'); -``` - -目前,该方法可以用上文的`escapeRegExp`函数或者垫片模块[regexp.escape](https://github.com/ljharb/regexp.escape)实现。 - -```javascript -var escape = require('regexp.escape'); -escape('hi. how are you?'); -// "hi\\. how are you\\?" -``` - -## s 修饰符:dotAll 模式 - -正则表达式中,点(`.`)是一个特殊字符,代表任意的单个字符,但是行终止符(line terminator character)除外。 - -以下四个字符属于”行终止符“。 - -- U+000A 换行符(`\n`) -- U+000D 回车符(`\r`) -- U+2028 行分隔符(line separator) -- U+2029 段分隔符(paragraph separator) - -```javascript -/foo.bar/.test('foo\nbar') -// false -``` - -上面代码中,因为`.`不匹配`\n`,所以正则表达式返回`false`。 - -但是,很多时候我们希望匹配的是任意单个字符,这时有一种变通的写法。 - -```javascript -/foo[^]bar/.test('foo\nbar') -// true -``` - -这种解决方案毕竟不太符合直觉,所以现在有一个[提案](https://github.com/mathiasbynens/es-regexp-dotall-flag),引入`/s`修饰符,使得`.`可以匹配任意单个字符。 - -```javascript -/foo.bar/s.test('foo\nbar') // true -``` - -这被称为`dotAll`模式,即点(dot)代表一切字符。所以,正则表达式还引入了一个`dotAll`属性,返回一个布尔值,表示该正则表达式是否处在`dotAll`模式。 - -```javascript -const re = /foo.bar/s; -// 另一种写法 -// const re = new RegExp('foo.bar', 's'); - -re.test('foo\nbar') // true -re.dotAll // true -re.flags // 's' -``` - -`/s`修饰符和多行修饰符`/m`不冲突,两者一起使用的情况下,`.`匹配所有字符,而`^`和`$`匹配每一行的行首和行尾。 - -## 后行断言 - -JavaScript 语言的正则表达式,只支持先行断言(lookahead)和先行否定断言(negative lookahead),不支持后行断言(lookbehind)和后行否定断言(negative lookbehind)。 - -目前,有一个[提案](https://github.com/goyakin/es-regexp-lookbehind),引入后行断言。V8 引擎4.9版已经支持,Chrome 浏览器49版打开”experimental JavaScript features“开关(地址栏键入`about:flags`),就可以使用这项功能。 - -”先行断言“指的是,`x`只有在`y`前面才匹配,必须写成`/x(?=y)/`。比如,只匹配百分号之前的数字,要写成`/\d+(?=%)/`。”先行否定断言“指的是,`x`只有不在`y`前面才匹配,必须写成`/x(?!y)/`。比如,只匹配不在百分号之前的数字,要写成`/\d+(?!%)/`。 - -```javascript -/\d+(?=%)/.exec('100% of US presidents have been male') // ["100"] -/\d+(?!%)/.exec('that’s all 44 of them') // ["44"] -``` - -上面两个字符串,如果互换正则表达式,就会匹配失败。另外,还可以看到,”先行断言“括号之中的部分(`(?=%)`),是不计入返回结果的。 - -“后行断言”正好与“先行断言”相反,`x`只有在`y`后面才匹配,必须写成`/(?<=y)x/`。比如,只匹配美元符号之后的数字,要写成`/(?<=\$)\d+/`。”后行否定断言“则与”先行否定断言“相反,`x`只有不在`y`后面才匹配,必须写成`/(? s.add(x)); - -for (let i of s) { - console.log(i); -} -// 2 3 5 4 -``` - -上面代码通过`add`方法向 Set 结构加入成员,结果表明 Set 结构不会添加重复的值。 - -Set 函数可以接受一个数组(或类似数组的对象)作为参数,用来初始化。 - -```javascript -// 例一 -var set = new Set([1, 2, 3, 4, 4]); -[...set] -// [1, 2, 3, 4] - -// 例二 -var items = new Set([1, 2, 3, 4, 5, 5, 5, 5]); -items.size // 5 - -// 例三 -function divs () { - return [...document.querySelectorAll('div')]; -} - -var set = new Set(divs()); -set.size // 56 - -// 类似于 -divs().forEach(div => set.add(div)); -set.size // 56 -``` - -上面代码中,例一和例二都是`Set`函数接受数组作为参数,例三是接受类似数组的对象作为参数。 - -上面代码中,也展示了一种去除数组重复成员的方法。 - -```javascript -// 去除数组的重复成员 -[...new Set(array)] -``` - -向Set加入值的时候,不会发生类型转换,所以`5`和`"5"`是两个不同的值。Set内部判断两个值是否不同,使用的算法叫做“Same-value equality”,它类似于精确相等运算符(`===`),主要的区别是`NaN`等于自身,而精确相等运算符认为`NaN`不等于自身。 - -```javascript -let set = new Set(); -let a = NaN; -let b = NaN; -set.add(a); -set.add(b); -set // Set {NaN} -``` - -上面代码向Set实例添加了两个`NaN`,但是只能加入一个。这表明,在Set内部,两个`NaN`是相等。 - -另外,两个对象总是不相等的。 - -```javascript -let set = new Set(); - -set.add({}); -set.size // 1 - -set.add({}); -set.size // 2 -``` - -上面代码表示,由于两个空对象不相等,所以它们被视为两个值。 - -### Set实例的属性和方法 - -Set结构的实例有以下属性。 - -- `Set.prototype.constructor`:构造函数,默认就是`Set`函数。 -- `Set.prototype.size`:返回`Set`实例的成员总数。 - -Set实例的方法分为两大类:操作方法(用于操作数据)和遍历方法(用于遍历成员)。下面先介绍四个操作方法。 - -- `add(value)`:添加某个值,返回Set结构本身。 -- `delete(value)`:删除某个值,返回一个布尔值,表示删除是否成功。 -- `has(value)`:返回一个布尔值,表示该值是否为`Set`的成员。 -- `clear()`:清除所有成员,没有返回值。 - -上面这些属性和方法的实例如下。 - -```javascript -s.add(1).add(2).add(2); -// 注意2被加入了两次 - -s.size // 2 - -s.has(1) // true -s.has(2) // true -s.has(3) // false - -s.delete(2); -s.has(2) // false -``` - -下面是一个对比,看看在判断是否包括一个键上面,`Object`结构和`Set`结构的写法不同。 - -```javascript -// 对象的写法 -var properties = { - 'width': 1, - 'height': 1 -}; - -if (properties[someName]) { - // do something -} - -// Set的写法 -var properties = new Set(); - -properties.add('width'); -properties.add('height'); - -if (properties.has(someName)) { - // do something -} -``` - -`Array.from`方法可以将Set结构转为数组。 - -```javascript -var items = new Set([1, 2, 3, 4, 5]); -var array = Array.from(items); -``` - -这就提供了去除数组重复成员的另一种方法。 - -```javascript -function dedupe(array) { - return Array.from(new Set(array)); -} - -dedupe([1, 1, 2, 3]) // [1, 2, 3] -``` - -### 遍历操作 - -Set结构的实例有四个遍历方法,可以用于遍历成员。 - -- `keys()`:返回键名的遍历器 -- `values()`:返回键值的遍历器 -- `entries()`:返回键值对的遍历器 -- `forEach()`:使用回调函数遍历每个成员 - -需要特别指出的是,`Set`的遍历顺序就是插入顺序。这个特性有时非常有用,比如使用Set保存一个回调函数列表,调用时就能保证按照添加顺序调用。 - -**(1)`keys()`,`values()`,`entries()`** - -`keys`方法、`values`方法、`entries`方法返回的都是遍历器对象(详见《Iterator 对象》一章)。由于 Set 结构没有键名,只有键值(或者说键名和键值是同一个值),所以`keys`方法和`values`方法的行为完全一致。 - -```javascript -let set = new Set(['red', 'green', 'blue']); - -for (let item of set.keys()) { - console.log(item); -} -// red -// green -// blue - -for (let item of set.values()) { - console.log(item); -} -// red -// green -// blue - -for (let item of set.entries()) { - console.log(item); -} -// ["red", "red"] -// ["green", "green"] -// ["blue", "blue"] -``` - -上面代码中,`entries`方法返回的遍历器,同时包括键名和键值,所以每次输出一个数组,它的两个成员完全相等。 - -Set结构的实例默认可遍历,它的默认遍历器生成函数就是它的`values`方法。 - -```javascript -Set.prototype[Symbol.iterator] === Set.prototype.values -// true -``` - -这意味着,可以省略`values`方法,直接用`for...of`循环遍历Set。 - -```javascript -let set = new Set(['red', 'green', 'blue']); - -for (let x of set) { - console.log(x); -} -// red -// green -// blue -``` - -**(2)`forEach()`** - -Set结构的实例的`forEach`方法,用于对每个成员执行某种操作,没有返回值。 - -```javascript -let set = new Set([1, 2, 3]); -set.forEach((value, key) => console.log(value * 2) ) -// 2 -// 4 -// 6 -``` - -上面代码说明,`forEach`方法的参数就是一个处理函数。该函数的参数依次为键值、键名、集合本身(上例省略了该参数)。另外,`forEach`方法还可以有第二个参数,表示绑定的this对象。 - -**(3)遍历的应用** - -扩展运算符(`...`)内部使用`for...of`循环,所以也可以用于Set结构。 - -```javascript -let set = new Set(['red', 'green', 'blue']); -let arr = [...set]; -// ['red', 'green', 'blue'] -``` - -扩展运算符和Set结构相结合,就可以去除数组的重复成员。 - -```javascript -let arr = [3, 5, 2, 2, 5, 5]; -let unique = [...new Set(arr)]; -// [3, 5, 2] -``` - -而且,数组的`map`和`filter`方法也可以用于Set了。 - -```javascript -let set = new Set([1, 2, 3]); -set = new Set([...set].map(x => x * 2)); -// 返回Set结构:{2, 4, 6} - -let set = new Set([1, 2, 3, 4, 5]); -set = new Set([...set].filter(x => (x % 2) == 0)); -// 返回Set结构:{2, 4} -``` - -因此使用Set可以很容易地实现并集(Union)、交集(Intersect)和差集(Difference)。 - -```javascript -let a = new Set([1, 2, 3]); -let b = new Set([4, 3, 2]); - -// 并集 -let union = new Set([...a, ...b]); -// Set {1, 2, 3, 4} - -// 交集 -let intersect = new Set([...a].filter(x => b.has(x))); -// set {2, 3} - -// 差集 -let difference = new Set([...a].filter(x => !b.has(x))); -// Set {1} -``` - -如果想在遍历操作中,同步改变原来的Set结构,目前没有直接的方法,但有两种变通方法。一种是利用原Set结构映射出一个新的结构,然后赋值给原来的Set结构;另一种是利用`Array.from`方法。 - -```javascript -// 方法一 -let set = new Set([1, 2, 3]); -set = new Set([...set].map(val => val * 2)); -// set的值是2, 4, 6 - -// 方法二 -let set = new Set([1, 2, 3]); -set = new Set(Array.from(set, val => val * 2)); -// set的值是2, 4, 6 -``` - -上面代码提供了两种方法,直接在遍历操作中改变原来的Set结构。 - -## WeakSet - -WeakSet结构与Set类似,也是不重复的值的集合。但是,它与Set有两个区别。 - -首先,WeakSet的成员只能是对象,而不能是其他类型的值。 - -其次,WeakSet中的对象都是弱引用,即垃圾回收机制不考虑WeakSet对该对象的引用,也就是说,如果其他对象都不再引用该对象,那么垃圾回收机制会自动回收该对象所占用的内存,不考虑该对象还存在于WeakSet之中。这个特点意味着,无法引用WeakSet的成员,因此WeakSet是不可遍历的。 - -```javascript -var ws = new WeakSet(); -ws.add(1) -// TypeError: Invalid value used in weak set -ws.add(Symbol()) -// TypeError: invalid value used in weak set -``` - -上面代码试图向WeakSet添加一个数值和`Symbol`值,结果报错,因为WeakSet只能放置对象。 - -WeakSet是一个构造函数,可以使用`new`命令,创建WeakSet数据结构。 - -```javascript -var ws = new WeakSet(); -``` - -作为构造函数,WeakSet可以接受一个数组或类似数组的对象作为参数。(实际上,任何具有iterable接口的对象,都可以作为WeakSet的参数。)该数组的所有成员,都会自动成为WeakSet实例对象的成员。 - -```javascript -var a = [[1,2], [3,4]]; -var ws = new WeakSet(a); -``` - -上面代码中,`a`是一个数组,它有两个成员,也都是数组。将`a`作为WeakSet构造函数的参数,`a`的成员会自动成为WeakSet的成员。 - -注意,是`a`数组的成员成为WeakSet的成员,而不是`a`数组本身。这意味着,数组的成员只能是对象。 - -```javascript -var b = [3, 4]; -var ws = new WeakSet(b); -// Uncaught TypeError: Invalid value used in weak set(…) -``` - -上面代码中,数组`b`的成员不是对象,加入WeaKSet就会报错。 - -WeakSet结构有以下三个方法。 - -- **WeakSet.prototype.add(value)**:向WeakSet实例添加一个新成员。 -- **WeakSet.prototype.delete(value)**:清除WeakSet实例的指定成员。 -- **WeakSet.prototype.has(value)**:返回一个布尔值,表示某个值是否在WeakSet实例之中。 - -下面是一个例子。 - -```javascript -var ws = new WeakSet(); -var obj = {}; -var foo = {}; - -ws.add(window); -ws.add(obj); - -ws.has(window); // true -ws.has(foo); // false - -ws.delete(window); -ws.has(window); // false -``` - -WeakSet没有`size`属性,没有办法遍历它的成员。 - -```javascript -ws.size // undefined -ws.forEach // undefined - -ws.forEach(function(item){ console.log('WeakSet has ' + item)}) -// TypeError: undefined is not a function -``` - -上面代码试图获取`size`和`forEach`属性,结果都不能成功。 - -WeakSet不能遍历,是因为成员都是弱引用,随时可能消失,遍历机制无法保证成员的存在,很可能刚刚遍历结束,成员就取不到了。WeakSet的一个用处,是储存DOM节点,而不用担心这些节点从文档移除时,会引发内存泄漏。 - -下面是WeakSet的另一个例子。 - -```javascript -const foos = new WeakSet() -class Foo { - constructor() { - foos.add(this) - } - method () { - if (!foos.has(this)) { - throw new TypeError('Foo.prototype.method 只能在Foo的实例上调用!'); - } - } -} -``` - -上面代码保证了`Foo`的实例方法,只能在`Foo`的实例上调用。这里使用WeakSet的好处是,`foos`对实例的引用,不会被计入内存回收机制,所以删除实例的时候,不用考虑`foos`,也不会出现内存泄漏。 - -## Map - -### Map结构的目的和基本用法 - -JavaScript的对象(Object),本质上是键值对的集合(Hash结构),但是传统上只能用字符串当作键。这给它的使用带来了很大的限制。 - -```javascript -var data = {}; -var element = document.getElementById('myDiv'); - -data[element] = 'metadata'; -data['[object HTMLDivElement]'] // "metadata" -``` - -上面代码原意是将一个DOM节点作为对象`data`的键,但是由于对象只接受字符串作为键名,所以`element`被自动转为字符串`[object HTMLDivElement]`。 - -为了解决这个问题,ES6提供了Map数据结构。它类似于对象,也是键值对的集合,但是“键”的范围不限于字符串,各种类型的值(包括对象)都可以当作键。也就是说,Object结构提供了“字符串—值”的对应,Map结构提供了“值—值”的对应,是一种更完善的Hash结构实现。如果你需要“键值对”的数据结构,Map比Object更合适。 - -```javascript -var m = new Map(); -var o = {p: 'Hello World'}; - -m.set(o, 'content') -m.get(o) // "content" - -m.has(o) // true -m.delete(o) // true -m.has(o) // false -``` - -上面代码使用`set`方法,将对象`o`当作`m`的一个键,然后又使用`get`方法读取这个键,接着使用`delete`方法删除了这个键。 - -作为构造函数,Map也可以接受一个数组作为参数。该数组的成员是一个个表示键值对的数组。 - -```javascript -var map = new Map([ - ['name', '张三'], - ['title', 'Author'] -]); - -map.size // 2 -map.has('name') // true -map.get('name') // "张三" -map.has('title') // true -map.get('title') // "Author" -``` - -上面代码在新建Map实例时,就指定了两个键`name`和`title`。 - -Map构造函数接受数组作为参数,实际上执行的是下面的算法。 - -```javascript -var items = [ - ['name', '张三'], - ['title', 'Author'] -]; -var map = new Map(); -items.forEach(([key, value]) => map.set(key, value)); -``` - -下面的例子中,字符串`true`和布尔值`true`是两个不同的键。 - -```javascript -var m = new Map([ - [true, 'foo'], - ['true', 'bar'] -]); - -m.get(true) // 'foo' -m.get('true') // 'bar' -``` - -如果对同一个键多次赋值,后面的值将覆盖前面的值。 - -```javascript -let map = new Map(); - -map -.set(1, 'aaa') -.set(1, 'bbb'); - -map.get(1) // "bbb" -``` - -上面代码对键`1`连续赋值两次,后一次的值覆盖前一次的值。 - -如果读取一个未知的键,则返回`undefined`。 - -```javascript -new Map().get('asfddfsasadf') -// undefined -``` - -注意,只有对同一个对象的引用,Map结构才将其视为同一个键。这一点要非常小心。 - -```javascript -var map = new Map(); - -map.set(['a'], 555); -map.get(['a']) // undefined -``` - -上面代码的`set`和`get`方法,表面是针对同一个键,但实际上这是两个值,内存地址是不一样的,因此`get`方法无法读取该键,返回`undefined`。 - -同理,同样的值的两个实例,在Map结构中被视为两个键。 - -```javascript -var map = new Map(); - -var k1 = ['a']; -var k2 = ['a']; - -map -.set(k1, 111) -.set(k2, 222); - -map.get(k1) // 111 -map.get(k2) // 222 -``` - -上面代码中,变量`k1`和`k2`的值是一样的,但是它们在Map结构中被视为两个键。 - -由上可知,Map的键实际上是跟内存地址绑定的,只要内存地址不一样,就视为两个键。这就解决了同名属性碰撞(clash)的问题,我们扩展别人的库的时候,如果使用对象作为键名,就不用担心自己的属性与原作者的属性同名。 - -如果Map的键是一个简单类型的值(数字、字符串、布尔值),则只要两个值严格相等,Map将其视为一个键,包括`0`和`-0`。另外,虽然`NaN`不严格相等于自身,但Map将其视为同一个键。 - -```javascript -let map = new Map(); - -map.set(NaN, 123); -map.get(NaN) // 123 - -map.set(-0, 123); -map.get(+0) // 123 -``` - -### 实例的属性和操作方法 - -Map结构的实例有以下属性和操作方法。 - -**(1)size属性** - -`size`属性返回Map结构的成员总数。 - -```javascript -let map = new Map(); -map.set('foo', true); -map.set('bar', false); - -map.size // 2 -``` - -**(2)set(key, value)** - -`set`方法设置`key`所对应的键值,然后返回整个Map结构。如果`key`已经有值,则键值会被更新,否则就新生成该键。 - -```javascript -var m = new Map(); - -m.set("edition", 6) // 键是字符串 -m.set(262, "standard") // 键是数值 -m.set(undefined, "nah") // 键是undefined -``` - -`set`方法返回的是Map本身,因此可以采用链式写法。 - -```javascript -let map = new Map() - .set(1, 'a') - .set(2, 'b') - .set(3, 'c'); -``` - -**(3)get(key)** - -`get`方法读取`key`对应的键值,如果找不到`key`,返回`undefined`。 - -```javascript -var m = new Map(); - -var hello = function() {console.log("hello");} -m.set(hello, "Hello ES6!") // 键是函数 - -m.get(hello) // Hello ES6! -``` - -**(4)has(key)** - -`has`方法返回一个布尔值,表示某个键是否在Map数据结构中。 - -```javascript -var m = new Map(); - -m.set("edition", 6); -m.set(262, "standard"); -m.set(undefined, "nah"); - -m.has("edition") // true -m.has("years") // false -m.has(262) // true -m.has(undefined) // true -``` - -**(5)delete(key)** - -`delete`方法删除某个键,返回true。如果删除失败,返回false。 - -```javascript -var m = new Map(); -m.set(undefined, "nah"); -m.has(undefined) // true - -m.delete(undefined) -m.has(undefined) // false -``` -**(6)clear()** - -`clear`方法清除所有成员,没有返回值。 - -```javascript -let map = new Map(); -map.set('foo', true); -map.set('bar', false); - -map.size // 2 -map.clear() -map.size // 0 -``` - -### 遍历方法 - -Map原生提供三个遍历器生成函数和一个遍历方法。 - -- `keys()`:返回键名的遍历器。 -- `values()`:返回键值的遍历器。 -- `entries()`:返回所有成员的遍历器。 -- `forEach()`:遍历Map的所有成员。 - -需要特别注意的是,Map的遍历顺序就是插入顺序。 - -下面是使用实例。 - -```javascript -let map = new Map([ - ['F', 'no'], - ['T', 'yes'], -]); - -for (let key of map.keys()) { - console.log(key); -} -// "F" -// "T" - -for (let value of map.values()) { - console.log(value); -} -// "no" -// "yes" - -for (let item of map.entries()) { - console.log(item[0], item[1]); -} -// "F" "no" -// "T" "yes" - -// 或者 -for (let [key, value] of map.entries()) { - console.log(key, value); -} - -// 等同于使用map.entries() -for (let [key, value] of map) { - console.log(key, value); -} -``` - -上面代码最后的那个例子,表示Map结构的默认遍历器接口(`Symbol.iterator`属性),就是`entries`方法。 - -```javascript -map[Symbol.iterator] === map.entries -// true -``` - -Map结构转为数组结构,比较快速的方法是结合使用扩展运算符(`...`)。 - -```javascript -let map = new Map([ - [1, 'one'], - [2, 'two'], - [3, 'three'], -]); - -[...map.keys()] -// [1, 2, 3] - -[...map.values()] -// ['one', 'two', 'three'] - -[...map.entries()] -// [[1,'one'], [2, 'two'], [3, 'three']] - -[...map] -// [[1,'one'], [2, 'two'], [3, 'three']] -``` - -结合数组的`map`方法、`filter`方法,可以实现Map的遍历和过滤(Map本身没有`map`和`filter`方法)。 - -```javascript -let map0 = new Map() - .set(1, 'a') - .set(2, 'b') - .set(3, 'c'); - -let map1 = new Map( - [...map0].filter(([k, v]) => k < 3) -); -// 产生Map结构 {1 => 'a', 2 => 'b'} - -let map2 = new Map( - [...map0].map(([k, v]) => [k * 2, '_' + v]) - ); -// 产生Map结构 {2 => '_a', 4 => '_b', 6 => '_c'} -``` - -此外,Map还有一个`forEach`方法,与数组的`forEach`方法类似,也可以实现遍历。 - -```javascript -map.forEach(function(value, key, map) { - console.log("Key: %s, Value: %s", key, value); -}); -``` - -`forEach`方法还可以接受第二个参数,用来绑定`this`。 - -```javascript -var reporter = { - report: function(key, value) { - console.log("Key: %s, Value: %s", key, value); - } -}; - -map.forEach(function(value, key, map) { - this.report(key, value); -}, reporter); -``` - -上面代码中,`forEach`方法的回调函数的`this`,就指向`reporter`。 - -### 与其他数据结构的互相转换 - -**(1)Map转为数组** - -前面已经提过,Map转为数组最方便的方法,就是使用扩展运算符(...)。 - -```javascript -let myMap = new Map().set(true, 7).set({foo: 3}, ['abc']); -[...myMap] -// [ [ true, 7 ], [ { foo: 3 }, [ 'abc' ] ] ] -``` - -**(2)数组转为Map** - -将数组转入Map构造函数,就可以转为Map。 - -```javascript -new Map([[true, 7], [{foo: 3}, ['abc']]]) -// Map {true => 7, Object {foo: 3} => ['abc']} -``` - -**(3)Map转为对象** - -如果所有Map的键都是字符串,它可以转为对象。 - -```javascript -function strMapToObj(strMap) { - let obj = Object.create(null); - for (let [k,v] of strMap) { - obj[k] = v; - } - return obj; -} - -let myMap = new Map().set('yes', true).set('no', false); -strMapToObj(myMap) -// { yes: true, no: false } -``` - -**(4)对象转为Map** - -```javascript -function objToStrMap(obj) { - let strMap = new Map(); - for (let k of Object.keys(obj)) { - strMap.set(k, obj[k]); - } - return strMap; -} - -objToStrMap({yes: true, no: false}) -// [ [ 'yes', true ], [ 'no', false ] ] -``` - -**(5)Map转为JSON** - -Map转为JSON要区分两种情况。一种情况是,Map的键名都是字符串,这时可以选择转为对象JSON。 - -```javascript -function strMapToJson(strMap) { - return JSON.stringify(strMapToObj(strMap)); -} - -let myMap = new Map().set('yes', true).set('no', false); -strMapToJson(myMap) -// '{"yes":true,"no":false}' -``` - -另一种情况是,Map的键名有非字符串,这时可以选择转为数组JSON。 - -```javascript -function mapToArrayJson(map) { - return JSON.stringify([...map]); -} - -let myMap = new Map().set(true, 7).set({foo: 3}, ['abc']); -mapToArrayJson(myMap) -// '[[true,7],[{"foo":3},["abc"]]]' -``` - -**(6)JSON转为Map** - -JSON转为Map,正常情况下,所有键名都是字符串。 - -```javascript -function jsonToStrMap(jsonStr) { - return objToStrMap(JSON.parse(jsonStr)); -} - -jsonToStrMap('{"yes":true,"no":false}') -// Map {'yes' => true, 'no' => false} -``` - -但是,有一种特殊情况,整个JSON就是一个数组,且每个数组成员本身,又是一个有两个成员的数组。这时,它可以一一对应地转为Map。这往往是数组转为JSON的逆操作。 - -```javascript -function jsonToMap(jsonStr) { - return new Map(JSON.parse(jsonStr)); -} - -jsonToMap('[[true,7],[{"foo":3},["abc"]]]') -// Map {true => 7, Object {foo: 3} => ['abc']} -``` - -## WeakMap - -`WeakMap`结构与`Map`结构基本类似,唯一的区别是它只接受对象作为键名(`null`除外),不接受其他类型的值作为键名,而且键名所指向的对象,不计入垃圾回收机制。 - -```javascript -var map = new WeakMap() -map.set(1, 2) -// TypeError: 1 is not an object! -map.set(Symbol(), 2) -// TypeError: Invalid value used as weak map key -``` - -上面代码中,如果将`1`和`Symbol`作为WeakMap的键名,都会报错。 - -`WeakMap`的设计目的在于,键名是对象的弱引用(垃圾回收机制不将该引用考虑在内),所以其所对应的对象可能会被自动回收。当对象被回收后,`WeakMap`自动移除对应的键值对。典型应用是,一个对应DOM元素的`WeakMap`结构,当某个DOM元素被清除,其所对应的`WeakMap`记录就会自动被移除。基本上,`WeakMap`的专用场合就是,它的键所对应的对象,可能会在将来消失。`WeakMap`结构有助于防止内存泄漏。 - -下面是`WeakMap`结构的一个例子,可以看到用法上与`Map`几乎一样。 - -```javascript -var wm = new WeakMap(); -var element = document.querySelector(".element"); - -wm.set(element, "Original"); -wm.get(element) // "Original" - -element.parentNode.removeChild(element); -element = null; -wm.get(element) // undefined -``` - -上面代码中,变量`wm`是一个`WeakMap`实例,我们将一个`DOM`节点`element`作为键名,然后销毁这个节点,`element`对应的键就自动消失了,再引用这个键名就返回`undefined`。 - -WeakMap与Map在API上的区别主要是两个,一是没有遍历操作(即没有`key()`、`values()`和`entries()`方法),也没有`size`属性;二是无法清空,即不支持`clear`方法。这与`WeakMap`的键不被计入引用、被垃圾回收机制忽略有关。因此,`WeakMap`只有四个方法可用:`get()`、`set()`、`has()`、`delete()`。 - -```javascript -var wm = new WeakMap(); - -wm.size -// undefined - -wm.forEach -// undefined -``` - -前文说过,WeakMap应用的典型场合就是DOM节点作为键名。下面是一个例子。 - -```javascript -let myElement = document.getElementById('logo'); -let myWeakmap = new WeakMap(); - -myWeakmap.set(myElement, {timesClicked: 0}); - -myElement.addEventListener('click', function() { - let logoData = myWeakmap.get(myElement); - logoData.timesClicked++; -}, false); -``` - -上面代码中,`myElement`是一个 DOM 节点,每当发生`click`事件,就更新一下状态。我们将这个状态作为键值放在 WeakMap 里,对应的键名就是`myElement`。一旦这个 DOM 节点删除,该状态就会自动消失,不存在内存泄漏风险。 - -WeakMap 的另一个用处是部署私有属性。 - -```javascript -let _counter = new WeakMap(); -let _action = new WeakMap(); - -class Countdown { - constructor(counter, action) { - _counter.set(this, counter); - _action.set(this, action); - } - dec() { - let counter = _counter.get(this); - if (counter < 1) return; - counter--; - _counter.set(this, counter); - if (counter === 0) { - _action.get(this)(); - } - } -} - -let c = new Countdown(2, () => console.log('DONE')); - -c.dec() -c.dec() -// DONE -``` - -上面代码中,Countdown类的两个内部属性`_counter`和`_action`,是实例的弱引用,所以如果删除实例,它们也就随之消失,不会造成内存泄漏。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/spec.md" "b/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/spec.md" deleted file mode 100644 index aa7fee02d..000000000 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/spec.md" +++ /dev/null @@ -1,230 +0,0 @@ -# 读懂 ECMAScript 规格 - -## 概述 - -规格文件是计算机语言的官方标准,详细描述语法规则和实现方法。 - -一般来说,没有必要阅读规格,除非你要写编译器。因为规格写得非常抽象和精炼,又缺乏实例,不容易理解,而且对于解决实际的应用问题,帮助不大。但是,如果你遇到疑难的语法问题,实在找不到答案,这时可以去查看规格文件,了解语言标准是怎么说的。规格是解决问题的“最后一招”。 - -这对JavaScript语言很有必要。因为它的使用场景复杂,语法规则不统一,例外很多,各种运行环境的行为不一致,导致奇怪的语法问题层出不穷,任何语法书都不可能囊括所有情况。查看规格,不失为一种解决语法问题的最可靠、最权威的终极方法。 - -本章介绍如何读懂ECMAScript 6的规格文件。 - -ECMAScript 6的规格,可以在ECMA国际标准组织的官方网站([www.ecma-international.org/ecma-262/6.0/](http://www.ecma-international.org/ecma-262/6.0/))免费下载和在线阅读。 - -这个规格文件相当庞大,一共有26章,A4打印的话,足足有545页。它的特点就是规定得非常细致,每一个语法行为、每一个函数的实现都做了详尽的清晰的描述。基本上,编译器作者只要把每一步翻译成代码就可以了。这很大程度上,保证了所有ES6实现都有一致的行为。 - -ECMAScript 6规格的26章之中,第1章到第3章是对文件本身的介绍,与语言关系不大。第4章是对这门语言总体设计的描述,有兴趣的读者可以读一下。第5章到第8章是语言宏观层面的描述。第5章是规格的名词解释和写法的介绍,第6章介绍数据类型,第7章介绍语言内部用到的抽象操作,第8章介绍代码如何运行。第9章到第26章介绍具体的语法。 - -对于一般用户来说,除了第4章,其他章节都涉及某一方面的细节,不用通读,只要在用到的时候,查阅相关章节即可。下面通过一些例子,介绍如何使用这份规格。 - -## 相等运算符 - -相等运算符(`==`)是一个很让人头痛的运算符,它的语法行为多变,不符合直觉。这个小节就看看规格怎么规定它的行为。 - -请看下面这个表达式,请问它的值是多少。 - -```javascript -0 == null -``` - -如果你不确定答案,或者想知道语言内部怎么处理,就可以去查看规格,[7.2.12小节](http://www.ecma-international.org/ecma-262/6.0/#sec-7.2.12)是对相等运算符(`==`)的描述。 - -规格对每一种语法行为的描述,都分成两部分:先是总体的行为描述,然后是实现的算法细节。相等运算符的总体描述,只有一句话。 - -> “The comparison `x == y`, where `x` and `y` are values, produces `true` or `false`.” - -上面这句话的意思是,相等运算符用于比较两个值,返回`true`或`false`。 - -下面是算法细节。 - -> 1. ReturnIfAbrupt(x). -> 1. ReturnIfAbrupt(y). -> 1. If `Type(x)` is the same as `Type(y)`, then -> Return the result of performing Strict Equality Comparison `x === y`. -> 1. If `x` is `null` and `y` is `undefined`, return `true`. -> 1. If `x` is `undefined` and `y` is `null`, return `true`. -> 1. If `Type(x)` is Number and `Type(y)` is String, -> return the result of the comparison `x == ToNumber(y)`. -> 1. If `Type(x)` is String and `Type(y)` is Number, -> return the result of the comparison `ToNumber(x) == y`. -> 1. If `Type(x)` is Boolean, return the result of the comparison `ToNumber(x) == y`. -> 1. If `Type(y)` is Boolean, return the result of the comparison `x == ToNumber(y)`. -> 1. If `Type(x)` is either String, Number, or Symbol and `Type(y)` is Object, then -> return the result of the comparison `x == ToPrimitive(y)`. -> 1. If `Type(x)` is Object and `Type(y)` is either String, Number, or Symbol, then -> return the result of the comparison `ToPrimitive(x) == y`. -> 1. Return `false`. - -上面这段算法,一共有12步,翻译如下。 - -> 1. 如果`x`不是正常值(比如抛出一个错误),中断执行。 -> 1. 如果`y`不是正常值,中断执行。 -> 1. 如果`Type(x)`与`Type(y)`相同,执行严格相等运算`x === y`。 -> 1. 如果`x`是`null`,`y`是`undefined`,返回`true`。 -> 1. 如果`x`是`undefined`,`y`是`null`,返回`true`。 -> 1. 如果`Type(x)`是数值,`Type(y)`是字符串,返回`x == ToNumber(y)`的结果。 -> 1. 如果`Type(x)`是字符串,`Type(y)`是数值,返回`ToNumber(x) == y`的结果。 -> 1. 如果`Type(x)`是布尔值,返回`ToNumber(x) == y`的结果。 -> 1. 如果`Type(y)`是布尔值,返回`x == ToNumber(y)`的结果。 -> 1. 如果`Type(x)`是字符串或数值或`Symbol`值,`Type(y)`是对象,返回`x == ToPrimitive(y)`的结果。 -> 1. 如果`Type(x)`是对象,`Type(y)`是字符串或数值或`Symbol`值,返回`ToPrimitive(x) == y`的结果。 -> 1. 返回`false`。 - -由于`0`的类型是数值,`null`的类型是Null(这是规格[4.3.13小节](http://www.ecma-international.org/ecma-262/6.0/#sec-4.3.13)的规定,是内部Type运算的结果,跟`typeof`运算符无关)。因此上面的前11步都得不到结果,要到第12步才能得到`false`。 - -```javascript -0 == null // false -``` - -## 数组的空位 - -下面再看另一个例子。 - -```javascript -const a1 = [undefined, undefined, undefined]; -const a2 = [, , ,]; - -a1.length // 3 -a2.length // 3 - -a1[0] // undefined -a2[0] // undefined - -a1[0] === a2[0] // true -``` - -上面代码中,数组`a1`的成员是三个`undefined`,数组`a2`的成员是三个空位。这两个数组很相似,长度都是3,每个位置的成员读取出来都是`undefined`。 - -但是,它们实际上存在重大差异。 - -```javascript -0 in a1 // true -0 in a2 // false - -a1.hasOwnProperty(0) // true -a2.hasOwnProperty(0) // false - -Object.keys(a1) // ["0", "1", "2"] -Object.keys(a2) // [] - -a1.map(n => 1) // [1, 1, 1] -a2.map(n => 1) // [, , ,] -``` - -上面代码一共列出了四种运算,数组`a1`和`a2`的结果都不一样。前三种运算(`in`运算符、数组的`hasOwnProperty`方法、`Object.keys`方法)都说明,数组`a2`取不到属性名。最后一种运算(数组的`map`方法)说明,数组`a2`没有发生遍历。 - -为什么`a1`与`a2`成员的行为不一致?数组的成员是`undefined`或空位,到底有什么不同? - -规格的[12.2.5小节《数组的初始化》](http://www.ecma-international.org/ecma-262/6.0/#sec-12.2.5)给出了答案。 - -> “Array elements may be elided at the beginning, middle or end of the element list. Whenever a comma in the element list is not preceded by an AssignmentExpression (i.e., a comma at the beginning or after another comma), the missing array element contributes to the length of the Array and increases the index of subsequent elements. Elided array elements are not defined. If an element is elided at the end of an array, that element does not contribute to the length of the Array.” - -翻译如下。 - -> "数组成员可以省略。只要逗号前面没有任何表达式,数组的`length`属性就会加1,并且相应增加其后成员的位置索引。被省略的成员不会被定义。如果被省略的成员是数组最后一个成员,则不会导致数组`length`属性增加。” - -上面的规格说得很清楚,数组的空位会反映在`length`属性,也就是说空位有自己的位置,但是这个位置的值是未定义,即这个值是不存在的。如果一定要读取,结果就是`undefined`(因为`undefined`在JavaScript语言中表示不存在)。 - -这就解释了为什么`in`运算符、数组的`hasOwnProperty`方法、`Object.keys`方法,都取不到空位的属性名。因为这个属性名根本就不存在,规格里面没说要为空位分配属性名(位置索引),只说要为下一个元素的位置索引加1。 - -至于为什么数组的`map`方法会跳过空位,请看下一节。 - -## 数组的map方法 - -规格的[22.1.3.15小节](http://www.ecma-international.org/ecma-262/6.0/#sec-22.1.3.15)定义了数组的`map`方法。该小节先是总体描述`map`方法的行为,里面没有提到数组空位。 - -后面的算法描述是这样的。 - -> 1. Let `O` be `ToObject(this value)`. -> 1. `ReturnIfAbrupt(O)`. -> 1. Let `len` be `ToLength(Get(O, "length"))`. -> 1. `ReturnIfAbrupt(len)`. -> 1. If `IsCallable(callbackfn)` is `false`, throw a TypeError exception. -> 1. If `thisArg` was supplied, let `T` be `thisArg`; else let `T` be `undefined`. -> 1. Let `A` be `ArraySpeciesCreate(O, len)`. -> 1. `ReturnIfAbrupt(A)`. -> 1. Let `k` be 0. -> 1. Repeat, while `k` < `len` -> a. Let `Pk` be `ToString(k)`. -> b. Let `kPresent` be `HasProperty(O, Pk)`. -> c. `ReturnIfAbrupt(kPresent)`. -> d. If `kPresent` is `true`, then -> d-1. Let `kValue` be `Get(O, Pk)`. -> d-2. `ReturnIfAbrupt(kValue)`. -> d-3. Let `mappedValue` be `Call(callbackfn, T, «kValue, k, O»)`. -> d-4. `ReturnIfAbrupt(mappedValue)`. -> d-5. Let `status` be `CreateDataPropertyOrThrow (A, Pk, mappedValue)`. -> d-6. `ReturnIfAbrupt(status)`. -> e. Increase `k` by 1. -> 1. Return `A`. - -翻译如下。 - -> 1. 得到当前数组的`this`对象 -> 1. 如果报错就返回 -> 1. 求出当前数组的`length`属性 -> 1. 如果报错就返回 -> 1. 如果map方法的参数`callbackfn`不可执行,就报错 -> 1. 如果map方法的参数之中,指定了`this`,就让`T`等于该参数,否则`T`为`undefined` -> 1. 生成一个新的数组`A`,跟当前数组的`length`属性保持一致 -> 1. 如果报错就返回 -> 1. 设定`k`等于0 -> 1. 只要`k`小于当前数组的`length`属性,就重复下面步骤 -> a. 设定`Pk`等于`ToString(k)`,即将`K`转为字符串 -> b. 设定`kPresent`等于`HasProperty(O, Pk)`,即求当前数组有没有指定属性 -> c. 如果报错就返回 -> d. 如果`kPresent`等于`true`,则进行下面步骤 -> d-1. 设定`kValue`等于`Get(O, Pk)`,取出当前数组的指定属性 -> d-2. 如果报错就返回 -> d-3. 设定`mappedValue`等于`Call(callbackfn, T, «kValue, k, O»)`,即执行回调函数 -> d-4. 如果报错就返回 -> d-5. 设定`status`等于`CreateDataPropertyOrThrow (A, Pk, mappedValue)`,即将回调函数的值放入`A`数组的指定位置 -> d-6. 如果报错就返回 -> e. `k`增加1 -> 1. 返回`A` - -仔细查看上面的算法,可以发现,当处理一个全是空位的数组时,前面步骤都没有问题。进入第10步的b时,`kpresent`会报错,因为空位对应的属性名,对于数组来说是不存在的,因此就会返回,不会进行后面的步骤。 - -```javascript -const arr = [, , ,]; -arr.map(n => { - console.log(n); - return 1; -}) // [, , ,] -``` - -上面代码中,`arr`是一个全是空位的数组,`map`方法遍历成员时,发现是空位,就直接跳过,不会进入回调函数。因此,回调函数里面的`console.log`语句根本不会执行,整个`map`方法返回一个全是空位的新数组。 - -V8引擎对`map`方法的[实现](https://github.com/v8/v8/blob/44c44521ae11859478b42004f57ea93df52526ee/src/js/array.js#L1347)如下,可以看到跟规格的算法描述完全一致。 - -```javascript -function ArrayMap(f, receiver) { - CHECK_OBJECT_COERCIBLE(this, "Array.prototype.map"); - - // Pull out the length so that modifications to the length in the - // loop will not affect the looping and side effects are visible. - var array = TO_OBJECT(this); - var length = TO_LENGTH_OR_UINT32(array.length); - return InnerArrayMap(f, receiver, array, length); -} - -function InnerArrayMap(f, receiver, array, length) { - if (!IS_CALLABLE(f)) throw MakeTypeError(kCalledNonCallable, f); - - var accumulator = new InternalArray(length); - var is_array = IS_ARRAY(array); - var stepping = DEBUG_IS_STEPPING(f); - for (var i = 0; i < length; i++) { - if (HAS_INDEX(array, i, is_array)) { - var element = array[i]; - // Prepare break slots for debugger step in. - if (stepping) %DebugPrepareStepInIfStepping(f); - accumulator[i] = %_Call(f, receiver, element, i, array); - } - } - var result = new GlobalArray(); - %MoveArrayContents(accumulator, result); - return result; -} -``` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/README.md" "b/02-ES\346\226\260\347\211\271\346\200\247/README.md" similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/README.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/README.md" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es-checker-master.zip" "b/02-ES\346\226\260\347\211\271\346\200\247/es-checker-master.zip" similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es-checker-master.zip" rename to "02-ES\346\226\260\347\211\271\346\200\247/es-checker-master.zip" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6features.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6features.md" similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6features.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6features.md" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/.gitignore" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/.gitignore" new file mode 100755 index 000000000..fb8cf1e5f --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/.gitignore" @@ -0,0 +1,22 @@ +git # OS X +Icon? +._* + +# Windows +Thumbs.db +ehthumbs.db +Desktop.ini + +# Linux +.directory +*~ + +# npm +node_modules +dist +*.gz + +# webstorm +.idea/ + + diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/.nojekyll" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/.nojekyll" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/.nojekyll" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/.nojekyll" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/404.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/404.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/404.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/404.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/CNAME" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/CNAME" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/CNAME" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/CNAME" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/LICENSE" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/LICENSE" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/LICENSE" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/LICENSE" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/README.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/README.md" new file mode 100755 index 000000000..a4cc5baec --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/README.md" @@ -0,0 +1,27 @@ +# ECMAScript 6 入门 + +《ECMAScript 6 入门》是一本开源的 JavaScript 语言教程,全面介绍 ECMAScript 6 新引入的语法特性。 + +[![cover](images/cover_thumbnail_3rd.jpg)](images/cover-3rd.jpg) + +本书覆盖 ES6 与上一个版本 ES5 的所有不同之处,对涉及的语法知识给予详细介绍,并给出大量简洁易懂的示例代码。 + +本书为中级难度,适合已经掌握 ES5 的读者,用来了解这门语言的最新发展;也可当作参考手册,查寻新增的语法点。如果你是 JavaScript 语言的初学者,建议先学完[《JavaScript 语言入门教程》](https://wangdoc.com/javascript/),再来看本书。 + +全书已由电子工业出版社出版,2017年9月推出了第三版,书名为《ES6 标准入门》。纸版是基于网站内容排版印刷的。 + +感谢张春雨编辑支持我将全书开源的做法。如果您认可这本书,建议购买纸版。这样可以使出版社不因出版开源书籍而亏钱,进而鼓励更多的作者开源自己的书籍。下面是第三版的购买地址。 + +- [淘宝](https://s.taobao.com/search?q=ES6%E6%A0%87%E5%87%86%E5%85%A5%E9%97%A8+%E7%AC%AC3%E7%89%88) +- [京东](https://search.jd.com/Search?keyword=ES6%E6%A0%87%E5%87%86%E5%85%A5%E9%97%A8%20%E7%AC%AC3%E7%89%88&enc=utf-8&wq=ES6%E6%A0%87%E5%87%86%E5%85%A5%E9%97%A8%20%E7%AC%AC3%E7%89%88) +- [当当](http://product.dangdang.com/25156888.html) +- [亚马逊](https://www.amazon.cn/ES6%E6%A0%87%E5%87%86%E5%85%A5%E9%97%A8-%E9%98%AE%E4%B8%80%E5%B3%B0/dp/B0755547ZZ) +- [China-pub](http://product.china-pub.com/6504650) + +### 版权许可 + +本书采用“保持署名—非商用”创意共享4.0许可证。 + +只要保持原作者署名和非商用,您可以自由地阅读、分享、修改本书。 + +详细的法律条文请参见[创意共享](http://creativecommons.org/licenses/by-nc/4.0/)网站。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/SUMMARY.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/SUMMARY.md" new file mode 100755 index 000000000..28dec1cc5 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/SUMMARY.md" @@ -0,0 +1,31 @@ +# Summary + +* [0. 前言](README.md) +* [1. ECMAScript 6简介](docs/intro.md) +* [2. let 和 const 命令](docs/let.md) +* [3. 变量的解构赋值](docs/destructuring.md) +* [4. 字符串的扩展](docs/string.md) +* [5. 正则的扩展](docs/regex.md) +* [6. 数值的扩展](docs/number.md) +* [7. 函数的扩展](docs/function.md) +* [8. 数组的扩展](docs/array.md) +* [9. 对象的扩展](docs/object.md) +* [10. Symbol](docs/symbol.md) +* [11. Set 和 Map 数据结构](docs/set-map.md) +* [12. Proxy](docs/proxy.md) +* [13. Reflect](docs/reflect.md) +* [14. Promise 对象](docs/promise.md) +* [15. Iterator 和 for...of 循环](docs/iterator.md) +* [16. Generator 函数的语法](docs/generator.md) +* [17. Generator 函数的异步应用](docs/generator-async.md) +* [18. async 函数](docs/async.md) +* [19. Class 的基本语法](docs/class.md) +* [20. Class 的继承](docs/class-extends.md) +* [21. Decorator](docs/decorator.md) +* [22. Module 的语法](docs/module.md) +* [23. Module 的加载实现](docs/module-loader.md) +* [24. 编程风格](docs/style.md) +* [25. 读懂规格](docs/spec.md) +* [26. ArrayBuffer](docs/arraybuffer.md) +* [27. 最新提案](docs/proposals.md) +* [28. 参考链接](docs/reference.md) \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.bower.json" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.bower.json" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.bower.json" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.bower.json" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.gitignore" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.gitignore" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.gitignore" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.gitignore" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.npmignore" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.npmignore" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.npmignore" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.npmignore" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.travis.yml" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.travis.yml" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/.travis.yml" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/.travis.yml" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/LICENSE" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/LICENSE" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/LICENSE" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/LICENSE" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/Makefile" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/Makefile" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/Makefile" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/Makefile" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/README.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/README.md" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/README.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/README.md" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/bin/marked" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/bin/marked" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/bin/marked" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/bin/marked" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/component.json" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/component.json" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/component.json" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/component.json" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/doc/broken.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/doc/broken.md" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/doc/broken.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/doc/broken.md" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/doc/todo.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/doc/todo.md" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/doc/todo.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/doc/todo.md" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/index.js" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/index.js" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/index.js" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/index.js" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/lib/marked.js" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/lib/marked.js" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/lib/marked.js" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/lib/marked.js" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/man/marked.1" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/man/marked.1" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/man/marked.1" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/man/marked.1" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/package.json" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/package.json" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/package.json" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/package.json" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/README" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/README" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/README" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/README" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.js" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.js" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.js" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/browser/index.js" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/browser/test.js" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/browser/test.js" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/browser/test.js" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/browser/test.js" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/index.js" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/index.js" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/index.js" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/index.js" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/autolink_lines.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/blockquote_list_item.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/case_insensitive_refs.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/def_blocks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/double_link.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/escaped_angles.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_break.breaks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_code_hr_list.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_del.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_em.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_links.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/gfm_tables.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/hr_list_break.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/lazy_blockquotes.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/list_item_text.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/loose_lists.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/main.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_code.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_em.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/nested_square_link.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/not_a_link.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/ref_paren.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/same_bullet.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/text.smartypants.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/toplevel_paragraphs.gfm.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/new/tricky_list.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/amps_and_angles_encoding.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/auto_links.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/backslash_escapes.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/blockquotes_with_code_blocks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_blocks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/code_spans.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/hard_wrapped_paragraphs_with_list_like_lines.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/horizontal_rules.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_advanced.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_comments.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/inline_html_simple.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_inline_style.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_reference_style.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/links_shortcut_references.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/literal_quotes_in_titles.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_basics.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/markdown_documentation_syntax.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/nested_blockquotes.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/ordered_and_unordered_lists.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/strong_and_em_together.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tabs.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/original/tidyness.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/amps_and_angles_encoding.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/auto_links.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/autolink_lines.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/backslash_escapes.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquote_list_item.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/blockquotes_with_code_blocks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/case_insensitive_refs.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_blocks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/code_spans.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/def_blocks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/double_link.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/escaped_angles.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_break.breaks.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_code_hr_list.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_del.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_em.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_links.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/gfm_tables.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hard_wrapped_paragraphs_with_list_like_lines.nogfm.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/horizontal_rules.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/hr_list_break.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_advanced.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_comments.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/inline_html_simple.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/lazy_blockquotes.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_inline_style.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_reference_style.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/links_shortcut_references.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/list_item_text.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/literal_quotes_in_titles.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/loose_lists.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/main.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_basics.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/markdown_documentation_syntax.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_blockquotes.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_code.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_em.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/nested_square_link.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/not_a_link.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ordered_and_unordered_lists.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/ref_paren.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/same_bullet.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/strong_and_em_together.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tabs.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/text.smartypants.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tidyness.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/toplevel_paragraphs.gfm.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.html" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.html" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.html" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.html" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.text" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.text" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.text" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/marked/test/tests/tricky_list.text" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/.bower.json" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/.bower.json" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/.bower.json" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/.bower.json" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/LICENSE.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/LICENSE.md" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/LICENSE.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/LICENSE.md" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/README.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/README.md" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/README.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/README.md" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/bower.json" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/bower.json" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/bower.json" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/bower.json" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/normalize.css" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/normalize.css" old mode 100644 new mode 100755 similarity index 100% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/app/bower_components/normalize-css/normalize.css" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/app/bower_components/normalize-css/normalize.css" diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/book.json" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/book.json" new file mode 100755 index 000000000..be5d775bd --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/book.json" @@ -0,0 +1,36 @@ +{ + "author": "阮一峰", + "description": "《ECMAScript 6 入门》是一本开源的 JavaScript 语言教程,全面介绍 ECMAScript 6 新引入的语法特性。", + "extension": null, + "generator": "site", + "isbn": "9787121324758", + "links": { + "sharing": { + "all": null, + "facebook": null, + "google": null, + "twitter": null, + "weibo": null + }, + "sidebar": { + "阮一峰的个人网站": "http://www.ruanyifeng.com/blog/" + } + }, + "output": null, + "pdf": { + "fontSize": 12, + "footerTemplate": null, + "headerTemplate": null, + "margin": { + "bottom": 36, + "left": 62, + "right": 62, + "top": 36 + }, + "pageNumbers": false, + "paperSize": "a4" + }, + "plugins": [], + "title": "ECMAScript 6 入门", + "variables": {} +} \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/config.js" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/config.js" old mode 100644 new mode 100755 similarity index 97% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/config.js" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/config.js" index 2ea5eb093..f0c3ad930 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/config.js" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/config.js" @@ -24,3 +24,4 @@ function addConfig(obj, conf) { }); } +ditto.run(); diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/cover.jpg" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/cover.jpg" new file mode 120000 index 000000000..0fa7635c3 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/cover.jpg" @@ -0,0 +1 @@ +images/cover-3rd.jpg \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/cover_small.jpg" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/cover_small.jpg" new file mode 120000 index 000000000..61091a8ce --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/cover_small.jpg" @@ -0,0 +1 @@ +images/cover_thumbnail_3rd.jpg \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/css/app.css" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/css/app.css" old mode 100644 new mode 100755 similarity index 99% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/css/app.css" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/css/app.css" index fe21dc7b4..a2e2f3c51 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/css/app.css" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/css/app.css" @@ -120,6 +120,7 @@ input[type=search] { height: 18px; text-align: left; border: none; + outline: none; } input.searchButton { diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/css/normalize.css" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/css/normalize.css" new file mode 120000 index 000000000..3d9454653 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/css/normalize.css" @@ -0,0 +1 @@ +../app/bower_components/normalize-css/normalize.css \ No newline at end of file diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/acknowledgment.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/acknowledgment.md" new file mode 100755 index 000000000..818faab9f --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/acknowledgment.md" @@ -0,0 +1,5 @@ +# 鸣谢 + +## Generator + +网友 vision57 提出,`next()`、`throw()`、`return()`这三个方法本质上是同一件事,可以放在一起理解。它们的作用都是让 Generator 函数恢复执行,并且使用不同的语句替换`yield`表达式。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/array.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/array.md" new file mode 100755 index 000000000..b0148b7cf --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/array.md" @@ -0,0 +1,949 @@ +# 数组的扩展 + +## 扩展运算符 + +### 含义 + +扩展运算符(spread)是三个点(`...`)。它好比 rest 参数的逆运算,将一个数组转为用逗号分隔的参数序列。 + +```javascript +console.log(...[1, 2, 3]) +// 1 2 3 + +console.log(1, ...[2, 3, 4], 5) +// 1 2 3 4 5 + +[...document.querySelectorAll('div')] +// [
,
,
] +``` + +该运算符主要用于函数调用。 + +```javascript +function push(array, ...items) { + array.push(...items); +} + +function add(x, y) { + return x + y; +} + +const numbers = [4, 38]; +add(...numbers) // 42 +``` + +上面代码中,`array.push(...items)`和`add(...numbers)`这两行,都是函数的调用,它们的都使用了扩展运算符。该运算符将一个数组,变为参数序列。 + +扩展运算符与正常的函数参数可以结合使用,非常灵活。 + +```javascript +function f(v, w, x, y, z) { } +const args = [0, 1]; +f(-1, ...args, 2, ...[3]); +``` + +扩展运算符后面还可以放置表达式。 + +```javascript +const arr = [ + ...(x > 0 ? ['a'] : []), + 'b', +]; +``` + +如果扩展运算符后面是一个空数组,则不产生任何效果。 + +```javascript +[...[], 1] +// [1] +``` + +注意,扩展运算符如果放在括号中,JavaScript 引擎就会认为这是函数调用。如果这时不是函数调用,就会报错。 + +```javascript +(...[1, 2]) +// Uncaught SyntaxError: Unexpected number + +console.log((...[1, 2])) +// Uncaught SyntaxError: Unexpected number + +console.log(...[1, 2]) +// 1 2 +``` + +上面前两种情况都会报错,因为扩展运算符所在的括号不是函数调用,而第三种情况`console.log(...[1, 2])`就不会报错,因为这时是函数调用。 + +### 替代函数的 apply 方法 + +由于扩展运算符可以展开数组,所以不再需要`apply`方法,将数组转为函数的参数了。 + +```javascript +// ES5 的写法 +function f(x, y, z) { + // ... +} +var args = [0, 1, 2]; +f.apply(null, args); + +// ES6的写法 +function f(x, y, z) { + // ... +} +let args = [0, 1, 2]; +f(...args); +``` + +下面是扩展运算符取代`apply`方法的一个实际的例子,应用`Math.max`方法,简化求出一个数组最大元素的写法。 + +```javascript +// ES5 的写法 +Math.max.apply(null, [14, 3, 77]) + +// ES6 的写法 +Math.max(...[14, 3, 77]) + +// 等同于 +Math.max(14, 3, 77); +``` + +上面代码中,由于 JavaScript 不提供求数组最大元素的函数,所以只能套用`Math.max`函数,将数组转为一个参数序列,然后求最大值。有了扩展运算符以后,就可以直接用`Math.max`了。 + +另一个例子是通过`push`函数,将一个数组添加到另一个数组的尾部。 + +```javascript +// ES5的 写法 +var arr1 = [0, 1, 2]; +var arr2 = [3, 4, 5]; +Array.prototype.push.apply(arr1, arr2); + +// ES6 的写法 +let arr1 = [0, 1, 2]; +let arr2 = [3, 4, 5]; +arr1.push(...arr2); +``` + +上面代码的 ES5 写法中,`push`方法的参数不能是数组,所以只好通过`apply`方法变通使用`push`方法。有了扩展运算符,就可以直接将数组传入`push`方法。 + +下面是另外一个例子。 + +```javascript +// ES5 +new (Date.bind.apply(Date, [null, 2015, 1, 1])) +// ES6 +new Date(...[2015, 1, 1]); +``` + +### 扩展运算符的应用 + +**(1)复制数组** + +数组是复合的数据类型,直接复制的话,只是复制了指向底层数据结构的指针,而不是克隆一个全新的数组。 + +```javascript +const a1 = [1, 2]; +const a2 = a1; + +a2[0] = 2; +a1 // [2, 2] +``` + +上面代码中,`a2`并不是`a1`的克隆,而是指向同一份数据的另一个指针。修改`a2`,会直接导致`a1`的变化。 + +ES5 只能用变通方法来复制数组。 + +```javascript +const a1 = [1, 2]; +const a2 = a1.concat(); + +a2[0] = 2; +a1 // [1, 2] +``` + +上面代码中,`a1`会返回原数组的克隆,再修改`a2`就不会对`a1`产生影响。 + +扩展运算符提供了复制数组的简便写法。 + +```javascript +const a1 = [1, 2]; +// 写法一 +const a2 = [...a1]; +// 写法二 +const [...a2] = a1; +``` + +上面的两种写法,`a2`都是`a1`的克隆。 + +**(2)合并数组** + +扩展运算符提供了数组合并的新写法。 + +```javascript +const arr1 = ['a', 'b']; +const arr2 = ['c']; +const arr3 = ['d', 'e']; + +// ES5 的合并数组 +arr1.concat(arr2, arr3); +// [ 'a', 'b', 'c', 'd', 'e' ] + +// ES6 的合并数组 +[...arr1, ...arr2, ...arr3] +// [ 'a', 'b', 'c', 'd', 'e' ] +``` + +不过,这两种方法都是浅拷贝,使用的时候需要注意。 + +```javascript +const a1 = [{ foo: 1 }]; +const a2 = [{ bar: 2 }]; + +const a3 = a1.concat(a2); +const a4 = [...a1, ...a2]; + +a3[0] === a1[0] // true +a4[0] === a1[0] // true +``` + +上面代码中,`a3`和`a4`是用两种不同方法合并而成的新数组,但是它们的成员都是对原数组成员的引用,这就是浅拷贝。如果修改了原数组的成员,会同步反映到新数组。 + +**(3)与解构赋值结合** + +扩展运算符可以与解构赋值结合起来,用于生成数组。 + +```javascript +// ES5 +a = list[0], rest = list.slice(1) +// ES6 +[a, ...rest] = list +``` + +下面是另外一些例子。 + +```javascript +const [first, ...rest] = [1, 2, 3, 4, 5]; +first // 1 +rest // [2, 3, 4, 5] + +const [first, ...rest] = []; +first // undefined +rest // [] + +const [first, ...rest] = ["foo"]; +first // "foo" +rest // [] +``` + +如果将扩展运算符用于数组赋值,只能放在参数的最后一位,否则会报错。 + +```javascript +const [...butLast, last] = [1, 2, 3, 4, 5]; +// 报错 + +const [first, ...middle, last] = [1, 2, 3, 4, 5]; +// 报错 +``` + +**(4)字符串** + +扩展运算符还可以将字符串转为真正的数组。 + +```javascript +[...'hello'] +// [ "h", "e", "l", "l", "o" ] +``` + +上面的写法,有一个重要的好处,那就是能够正确识别四个字节的 Unicode 字符。 + +```javascript +'x\uD83D\uDE80y'.length // 4 +[...'x\uD83D\uDE80y'].length // 3 +``` + +上面代码的第一种写法,JavaScript 会将四个字节的 Unicode 字符,识别为 2 个字符,采用扩展运算符就没有这个问题。因此,正确返回字符串长度的函数,可以像下面这样写。 + +```javascript +function length(str) { + return [...str].length; +} + +length('x\uD83D\uDE80y') // 3 +``` + +凡是涉及到操作四个字节的 Unicode 字符的函数,都有这个问题。因此,最好都用扩展运算符改写。 + +```javascript +let str = 'x\uD83D\uDE80y'; + +str.split('').reverse().join('') +// 'y\uDE80\uD83Dx' + +[...str].reverse().join('') +// 'y\uD83D\uDE80x' +``` + +上面代码中,如果不用扩展运算符,字符串的`reverse`操作就不正确。 + +**(5)实现了 Iterator 接口的对象** + +任何定义了遍历器(Iterator)接口的对象(参阅 Iterator 一章),都可以用扩展运算符转为真正的数组。 + +```javascript +let nodeList = document.querySelectorAll('div'); +let array = [...nodeList]; +``` + +上面代码中,`querySelectorAll`方法返回的是一个`NodeList`对象。它不是数组,而是一个类似数组的对象。这时,扩展运算符可以将其转为真正的数组,原因就在于`NodeList`对象实现了 Iterator 。 + +```javascript +Number.prototype[Symbol.iterator] = function*() { + let i = 0; + let num = this.valueOf(); + while (i < num) { + yield i++; + } +} + +console.log([...5]) // [0, 1, 2, 3, 4] +``` + +上面代码中,先定义了`Number`对象的遍历器接口,扩展运算符将`5`自动转成`Number`实例以后,就会调用这个接口,就会返回自定义的结果。 + +对于那些没有部署 Iterator 接口的类似数组的对象,扩展运算符就无法将其转为真正的数组。 + +```javascript +let arrayLike = { + '0': 'a', + '1': 'b', + '2': 'c', + length: 3 +}; + +// TypeError: Cannot spread non-iterable object. +let arr = [...arrayLike]; +``` + +上面代码中,`arrayLike`是一个类似数组的对象,但是没有部署 Iterator 接口,扩展运算符就会报错。这时,可以改为使用`Array.from`方法将`arrayLike`转为真正的数组。 + +**(6)Map 和 Set 结构,Generator 函数** + +扩展运算符内部调用的是数据结构的 Iterator 接口,因此只要具有 Iterator 接口的对象,都可以使用扩展运算符,比如 Map 结构。 + +```javascript +let map = new Map([ + [1, 'one'], + [2, 'two'], + [3, 'three'], +]); + +let arr = [...map.keys()]; // [1, 2, 3] +``` + +Generator 函数运行后,返回一个遍历器对象,因此也可以使用扩展运算符。 + +```javascript +const go = function*(){ + yield 1; + yield 2; + yield 3; +}; + +[...go()] // [1, 2, 3] +``` + +上面代码中,变量`go`是一个 Generator 函数,执行后返回的是一个遍历器对象,对这个遍历器对象执行扩展运算符,就会将内部遍历得到的值,转为一个数组。 + +如果对没有 Iterator 接口的对象,使用扩展运算符,将会报错。 + +```javascript +const obj = {a: 1, b: 2}; +let arr = [...obj]; // TypeError: Cannot spread non-iterable object +``` + +## Array.from() + +`Array.from`方法用于将两类对象转为真正的数组:类似数组的对象(array-like object)和可遍历(iterable)的对象(包括 ES6 新增的数据结构 Set 和 Map)。 + +下面是一个类似数组的对象,`Array.from`将它转为真正的数组。 + +```javascript +let arrayLike = { + '0': 'a', + '1': 'b', + '2': 'c', + length: 3 +}; + +// ES5的写法 +var arr1 = [].slice.call(arrayLike); // ['a', 'b', 'c'] + +// ES6的写法 +let arr2 = Array.from(arrayLike); // ['a', 'b', 'c'] +``` + +实际应用中,常见的类似数组的对象是 DOM 操作返回的 NodeList 集合,以及函数内部的`arguments`对象。`Array.from`都可以将它们转为真正的数组。 + +```javascript +// NodeList对象 +let ps = document.querySelectorAll('p'); +Array.from(ps).filter(p => { + return p.textContent.length > 100; +}); + +// arguments对象 +function foo() { + var args = Array.from(arguments); + // ... +} +``` + +上面代码中,`querySelectorAll`方法返回的是一个类似数组的对象,可以将这个对象转为真正的数组,再使用`filter`方法。 + +只要是部署了 Iterator 接口的数据结构,`Array.from`都能将其转为数组。 + +```javascript +Array.from('hello') +// ['h', 'e', 'l', 'l', 'o'] + +let namesSet = new Set(['a', 'b']) +Array.from(namesSet) // ['a', 'b'] +``` + +上面代码中,字符串和 Set 结构都具有 Iterator 接口,因此可以被`Array.from`转为真正的数组。 + +如果参数是一个真正的数组,`Array.from`会返回一个一模一样的新数组。 + +```javascript +Array.from([1, 2, 3]) +// [1, 2, 3] +``` + +值得提醒的是,扩展运算符(`...`)也可以将某些数据结构转为数组。 + +```javascript +// arguments对象 +function foo() { + const args = [...arguments]; +} + +// NodeList对象 +[...document.querySelectorAll('div')] +``` + +扩展运算符背后调用的是遍历器接口(`Symbol.iterator`),如果一个对象没有部署这个接口,就无法转换。`Array.from`方法还支持类似数组的对象。所谓类似数组的对象,本质特征只有一点,即必须有`length`属性。因此,任何有`length`属性的对象,都可以通过`Array.from`方法转为数组,而此时扩展运算符就无法转换。 + +```javascript +Array.from({ length: 3 }); +// [ undefined, undefined, undefined ] +``` + +上面代码中,`Array.from`返回了一个具有三个成员的数组,每个位置的值都是`undefined`。扩展运算符转换不了这个对象。 + +对于还没有部署该方法的浏览器,可以用`Array.prototype.slice`方法替代。 + +```javascript +const toArray = (() => + Array.from ? Array.from : obj => [].slice.call(obj) +)(); +``` + +`Array.from`还可以接受第二个参数,作用类似于数组的`map`方法,用来对每个元素进行处理,将处理后的值放入返回的数组。 + +```javascript +Array.from(arrayLike, x => x * x); +// 等同于 +Array.from(arrayLike).map(x => x * x); + +Array.from([1, 2, 3], (x) => x * x) +// [1, 4, 9] +``` + +下面的例子是取出一组 DOM 节点的文本内容。 + +```javascript +let spans = document.querySelectorAll('span.name'); + +// map() +let names1 = Array.prototype.map.call(spans, s => s.textContent); + +// Array.from() +let names2 = Array.from(spans, s => s.textContent) +``` + +下面的例子将数组中布尔值为`false`的成员转为`0`。 + +```javascript +Array.from([1, , 2, , 3], (n) => n || 0) +// [1, 0, 2, 0, 3] +``` + +另一个例子是返回各种数据的类型。 + +```javascript +function typesOf () { + return Array.from(arguments, value => typeof value) +} +typesOf(null, [], NaN) +// ['object', 'object', 'number'] +``` + +如果`map`函数里面用到了`this`关键字,还可以传入`Array.from`的第三个参数,用来绑定`this`。 + +`Array.from()`可以将各种值转为真正的数组,并且还提供`map`功能。这实际上意味着,只要有一个原始的数据结构,你就可以先对它的值进行处理,然后转成规范的数组结构,进而就可以使用数量众多的数组方法。 + +```javascript +Array.from({ length: 2 }, () => 'jack') +// ['jack', 'jack'] +``` + +上面代码中,`Array.from`的第一个参数指定了第二个参数运行的次数。这种特性可以让该方法的用法变得非常灵活。 + +`Array.from()`的另一个应用是,将字符串转为数组,然后返回字符串的长度。因为它能正确处理各种 Unicode 字符,可以避免 JavaScript 将大于`\uFFFF`的 Unicode 字符,算作两个字符的 bug。 + +```javascript +function countSymbols(string) { + return Array.from(string).length; +} +``` + +## Array.of() + +`Array.of`方法用于将一组值,转换为数组。 + +```javascript +Array.of(3, 11, 8) // [3,11,8] +Array.of(3) // [3] +Array.of(3).length // 1 +``` + +这个方法的主要目的,是弥补数组构造函数`Array()`的不足。因为参数个数的不同,会导致`Array()`的行为有差异。 + +```javascript +Array() // [] +Array(3) // [, , ,] +Array(3, 11, 8) // [3, 11, 8] +``` + +上面代码中,`Array`方法没有参数、一个参数、三个参数时,返回结果都不一样。只有当参数个数不少于 2 个时,`Array()`才会返回由参数组成的新数组。参数个数只有一个时,实际上是指定数组的长度。 + +`Array.of`基本上可以用来替代`Array()`或`new Array()`,并且不存在由于参数不同而导致的重载。它的行为非常统一。 + +```javascript +Array.of() // [] +Array.of(undefined) // [undefined] +Array.of(1) // [1] +Array.of(1, 2) // [1, 2] +``` + +`Array.of`总是返回参数值组成的数组。如果没有参数,就返回一个空数组。 + +`Array.of`方法可以用下面的代码模拟实现。 + +```javascript +function ArrayOf(){ + return [].slice.call(arguments); +} +``` + +## 数组实例的 copyWithin() + +数组实例的`copyWithin`方法,在当前数组内部,将指定位置的成员复制到其他位置(会覆盖原有成员),然后返回当前数组。也就是说,使用这个方法,会修改当前数组。 + +```javascript +Array.prototype.copyWithin(target, start = 0, end = this.length) +``` + +它接受三个参数。 + +- target(必需):从该位置开始替换数据。如果为负值,表示倒数。 +- start(可选):从该位置开始读取数据,默认为 0。如果为负值,表示倒数。 +- end(可选):到该位置前停止读取数据,默认等于数组长度。如果为负值,表示倒数。 + +这三个参数都应该是数值,如果不是,会自动转为数值。 + +```javascript +[1, 2, 3, 4, 5].copyWithin(0, 3) +// [4, 5, 3, 4, 5] +``` + +上面代码表示将从 3 号位直到数组结束的成员(4 和 5),复制到从 0 号位开始的位置,结果覆盖了原来的 1 和 2。 + +下面是更多例子。 + +```javascript +// 将3号位复制到0号位 +[1, 2, 3, 4, 5].copyWithin(0, 3, 4) +// [4, 2, 3, 4, 5] + +// -2相当于3号位,-1相当于4号位 +[1, 2, 3, 4, 5].copyWithin(0, -2, -1) +// [4, 2, 3, 4, 5] + +// 将3号位复制到0号位 +[].copyWithin.call({length: 5, 3: 1}, 0, 3) +// {0: 1, 3: 1, length: 5} + +// 将2号位到数组结束,复制到0号位 +let i32a = new Int32Array([1, 2, 3, 4, 5]); +i32a.copyWithin(0, 2); +// Int32Array [3, 4, 5, 4, 5] + +// 对于没有部署 TypedArray 的 copyWithin 方法的平台 +// 需要采用下面的写法 +[].copyWithin.call(new Int32Array([1, 2, 3, 4, 5]), 0, 3, 4); +// Int32Array [4, 2, 3, 4, 5] +``` + +## 数组实例的 find() 和 findIndex() + +数组实例的`find`方法,用于找出第一个符合条件的数组成员。它的参数是一个回调函数,所有数组成员依次执行该回调函数,直到找出第一个返回值为`true`的成员,然后返回该成员。如果没有符合条件的成员,则返回`undefined`。 + +```javascript +[1, 4, -5, 10].find((n) => n < 0) +// -5 +``` + +上面代码找出数组中第一个小于 0 的成员。 + +```javascript +[1, 5, 10, 15].find(function(value, index, arr) { + return value > 9; +}) // 10 +``` + +上面代码中,`find`方法的回调函数可以接受三个参数,依次为当前的值、当前的位置和原数组。 + +数组实例的`findIndex`方法的用法与`find`方法非常类似,返回第一个符合条件的数组成员的位置,如果所有成员都不符合条件,则返回`-1`。 + +```javascript +[1, 5, 10, 15].findIndex(function(value, index, arr) { + return value > 9; +}) // 2 +``` + +这两个方法都可以接受第二个参数,用来绑定回调函数的`this`对象。 + +```javascript +function f(v){ + return v > this.age; +} +let person = {name: 'John', age: 20}; +[10, 12, 26, 15].find(f, person); // 26 +``` + +上面的代码中,`find`函数接收了第二个参数`person`对象,回调函数中的`this`对象指向`person`对象。 + +另外,这两个方法都可以发现`NaN`,弥补了数组的`indexOf`方法的不足。 + +```javascript +[NaN].indexOf(NaN) +// -1 + +[NaN].findIndex(y => Object.is(NaN, y)) +// 0 +``` + +上面代码中,`indexOf`方法无法识别数组的`NaN`成员,但是`findIndex`方法可以借助`Object.is`方法做到。 + +## 数组实例的 fill() + +`fill`方法使用给定值,填充一个数组。 + +```javascript +['a', 'b', 'c'].fill(7) +// [7, 7, 7] + +new Array(3).fill(7) +// [7, 7, 7] +``` + +上面代码表明,`fill`方法用于空数组的初始化非常方便。数组中已有的元素,会被全部抹去。 + +`fill`方法还可以接受第二个和第三个参数,用于指定填充的起始位置和结束位置。 + +```javascript +['a', 'b', 'c'].fill(7, 1, 2) +// ['a', 7, 'c'] +``` + +上面代码表示,`fill`方法从 1 号位开始,向原数组填充 7,到 2 号位之前结束。 + +注意,如果填充的类型为对象,那么被赋值的是同一个内存地址的对象,而不是深拷贝对象。 + +```javascript +let arr = new Array(3).fill({name: "Mike"}); +arr[0].name = "Ben"; +arr +// [{name: "Ben"}, {name: "Ben"}, {name: "Ben"}] + +let arr = new Array(3).fill([]); +arr[0].push(5); +arr +// [[5], [5], [5]] +``` + +## 数组实例的 entries(),keys() 和 values() + +ES6 提供三个新的方法——`entries()`,`keys()`和`values()`——用于遍历数组。它们都返回一个遍历器对象(详见《Iterator》一章),可以用`for...of`循环进行遍历,唯一的区别是`keys()`是对键名的遍历、`values()`是对键值的遍历,`entries()`是对键值对的遍历。 + +```javascript +for (let index of ['a', 'b'].keys()) { + console.log(index); +} +// 0 +// 1 + +for (let elem of ['a', 'b'].values()) { + console.log(elem); +} +// 'a' +// 'b' + +for (let [index, elem] of ['a', 'b'].entries()) { + console.log(index, elem); +} +// 0 "a" +// 1 "b" +``` + +如果不使用`for...of`循环,可以手动调用遍历器对象的`next`方法,进行遍历。 + +```javascript +let letter = ['a', 'b', 'c']; +let entries = letter.entries(); +console.log(entries.next().value); // [0, 'a'] +console.log(entries.next().value); // [1, 'b'] +console.log(entries.next().value); // [2, 'c'] +``` + +## 数组实例的 includes() + +`Array.prototype.includes`方法返回一个布尔值,表示某个数组是否包含给定的值,与字符串的`includes`方法类似。ES2016 引入了该方法。 + +```javascript +[1, 2, 3].includes(2) // true +[1, 2, 3].includes(4) // false +[1, 2, NaN].includes(NaN) // true +``` + +该方法的第二个参数表示搜索的起始位置,默认为`0`。如果第二个参数为负数,则表示倒数的位置,如果这时它大于数组长度(比如第二个参数为`-4`,但数组长度为`3`),则会重置为从`0`开始。 + +```javascript +[1, 2, 3].includes(3, 3); // false +[1, 2, 3].includes(3, -1); // true +``` + +没有该方法之前,我们通常使用数组的`indexOf`方法,检查是否包含某个值。 + +```javascript +if (arr.indexOf(el) !== -1) { + // ... +} +``` + +`indexOf`方法有两个缺点,一是不够语义化,它的含义是找到参数值的第一个出现位置,所以要去比较是否不等于`-1`,表达起来不够直观。二是,它内部使用严格相等运算符(`===`)进行判断,这会导致对`NaN`的误判。 + +```javascript +[NaN].indexOf(NaN) +// -1 +``` + +`includes`使用的是不一样的判断算法,就没有这个问题。 + +```javascript +[NaN].includes(NaN) +// true +``` + +下面代码用来检查当前环境是否支持该方法,如果不支持,部署一个简易的替代版本。 + +```javascript +const contains = (() => + Array.prototype.includes + ? (arr, value) => arr.includes(value) + : (arr, value) => arr.some(el => el === value) +)(); +contains(['foo', 'bar'], 'baz'); // => false +``` + +另外,Map 和 Set 数据结构有一个`has`方法,需要注意与`includes`区分。 + +- Map 结构的`has`方法,是用来查找键名的,比如`Map.prototype.has(key)`、`WeakMap.prototype.has(key)`、`Reflect.has(target, propertyKey)`。 +- Set 结构的`has`方法,是用来查找值的,比如`Set.prototype.has(value)`、`WeakSet.prototype.has(value)`。 + +## 数组实例的 flat(),flatMap() + +数组的成员有时还是数组,`Array.prototype.flat()`用于将嵌套的数组“拉平”,变成一维的数组。该方法返回一个新数组,对原数据没有影响。 + +```javascript +[1, 2, [3, 4]].flat() +// [1, 2, 3, 4] +``` + +上面代码中,原数组的成员里面有一个数组,`flat()`方法将子数组的成员取出来,添加在原来的位置。 + +`flat()`默认只会“拉平”一层,如果想要“拉平”多层的嵌套数组,可以将`flat()`方法的参数写成一个整数,表示想要拉平的层数,默认为1。 + +```javascript +[1, 2, [3, [4, 5]]].flat() +// [1, 2, 3, [4, 5]] + +[1, 2, [3, [4, 5]]].flat(2) +// [1, 2, 3, 4, 5] +``` + +上面代码中,`flat()`的参数为2,表示要“拉平”两层的嵌套数组。 + +如果不管有多少层嵌套,都要转成一维数组,可以用`Infinity`关键字作为参数。 + +```javascript +[1, [2, [3]]].flat(Infinity) +// [1, 2, 3] +``` + +如果原数组有空位,`flat()`方法会跳过空位。 + +```javascript +[1, 2, , 4, 5].flat() +// [1, 2, 4, 5] +``` + +`flatMap()`方法对原数组的每个成员执行一个函数(相当于执行`Array.prototype.map()`),然后对返回值组成的数组执行`flat()`方法。该方法返回一个新数组,不改变原数组。 + +```javascript +// 相当于 [[2, 4], [3, 6], [4, 8]].flat() +[2, 3, 4].flatMap((x) => [x, x * 2]) +// [2, 4, 3, 6, 4, 8] +``` + +`flatMap()`只能展开一层数组。 + +```javascript +// 相当于 [[[2]], [[4]], [[6]], [[8]]].flat() +[1, 2, 3, 4].flatMap(x => [[x * 2]]) +// [[2], [4], [6], [8]] +``` + +上面代码中,遍历函数返回的是一个双层的数组,但是默认只能展开一层,因此`flatMap()`返回的还是一个嵌套数组。 + +`flatMap()`方法的参数是一个遍历函数,该函数可以接受三个参数,分别是当前数组成员、当前数组成员的位置(从零开始)、原数组。 + +```javascript +arr.flatMap(function callback(currentValue[, index[, array]]) { + // ... +}[, thisArg]) +``` + +`flatMap()`方法还可以有第二个参数,用来绑定遍历函数里面的`this`。 + +## 数组的空位 + +数组的空位指,数组的某一个位置没有任何值。比如,`Array`构造函数返回的数组都是空位。 + +```javascript +Array(3) // [, , ,] +``` + +上面代码中,`Array(3)`返回一个具有 3 个空位的数组。 + +注意,空位不是`undefined`,一个位置的值等于`undefined`,依然是有值的。空位是没有任何值,`in`运算符可以说明这一点。 + +```javascript +0 in [undefined, undefined, undefined] // true +0 in [, , ,] // false +``` + +上面代码说明,第一个数组的 0 号位置是有值的,第二个数组的 0 号位置没有值。 + +ES5 对空位的处理,已经很不一致了,大多数情况下会忽略空位。 + +- `forEach()`, `filter()`, `reduce()`, `every()` 和`some()`都会跳过空位。 +- `map()`会跳过空位,但会保留这个值 +- `join()`和`toString()`会将空位视为`undefined`,而`undefined`和`null`会被处理成空字符串。 + +```javascript +// forEach方法 +[,'a'].forEach((x,i) => console.log(i)); // 1 + +// filter方法 +['a',,'b'].filter(x => true) // ['a','b'] + +// every方法 +[,'a'].every(x => x==='a') // true + +// reduce方法 +[1,,2].reduce((x,y) => x+y) // 3 + +// some方法 +[,'a'].some(x => x !== 'a') // false + +// map方法 +[,'a'].map(x => 1) // [,1] + +// join方法 +[,'a',undefined,null].join('#') // "#a##" + +// toString方法 +[,'a',undefined,null].toString() // ",a,," +``` + +ES6 则是明确将空位转为`undefined`。 + +`Array.from`方法会将数组的空位,转为`undefined`,也就是说,这个方法不会忽略空位。 + +```javascript +Array.from(['a',,'b']) +// [ "a", undefined, "b" ] +``` + +扩展运算符(`...`)也会将空位转为`undefined`。 + +```javascript +[...['a',,'b']] +// [ "a", undefined, "b" ] +``` + +`copyWithin()`会连空位一起拷贝。 + +```javascript +[,'a','b',,].copyWithin(2,0) // [,"a",,"a"] +``` + +`fill()`会将空位视为正常的数组位置。 + +```javascript +new Array(3).fill('a') // ["a","a","a"] +``` + +`for...of`循环也会遍历空位。 + +```javascript +let arr = [, ,]; +for (let i of arr) { + console.log(1); +} +// 1 +// 1 +``` + +上面代码中,数组`arr`有两个空位,`for...of`并没有忽略它们。如果改成`map`方法遍历,空位是会跳过的。 + +`entries()`、`keys()`、`values()`、`find()`和`findIndex()`会将空位处理成`undefined`。 + +```javascript +// entries() +[...[,'a'].entries()] // [[0,undefined], [1,"a"]] + +// keys() +[...[,'a'].keys()] // [0,1] + +// values() +[...[,'a'].values()] // [undefined,"a"] + +// find() +[,'a'].find(x => true) // undefined + +// findIndex() +[,'a'].findIndex(x => true) // 0 +``` + +由于空位的处理规则非常不统一,所以建议避免出现空位。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/arraybuffer.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/arraybuffer.md" new file mode 100755 index 000000000..cf883c3f2 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/arraybuffer.md" @@ -0,0 +1,1332 @@ +# ArrayBuffer + +`ArrayBuffer`对象、`TypedArray`视图和`DataView`视图是 JavaScript 操作二进制数据的一个接口。这些对象早就存在,属于独立的规格(2011 年 2 月发布),ES6 将它们纳入了 ECMAScript 规格,并且增加了新的方法。它们都是以数组的语法处理二进制数据,所以统称为二进制数组。 + +这个接口的原始设计目的,与 WebGL 项目有关。所谓 WebGL,就是指浏览器与显卡之间的通信接口,为了满足 JavaScript 与显卡之间大量的、实时的数据交换,它们之间的数据通信必须是二进制的,而不能是传统的文本格式。文本格式传递一个 32 位整数,两端的 JavaScript 脚本与显卡都要进行格式转化,将非常耗时。这时要是存在一种机制,可以像 C 语言那样,直接操作字节,将 4 个字节的 32 位整数,以二进制形式原封不动地送入显卡,脚本的性能就会大幅提升。 + +二进制数组就是在这种背景下诞生的。它很像 C 语言的数组,允许开发者以数组下标的形式,直接操作内存,大大增强了 JavaScript 处理二进制数据的能力,使得开发者有可能通过 JavaScript 与操作系统的原生接口进行二进制通信。 + +二进制数组由三类对象组成。 + +**(1)`ArrayBuffer`对象**:代表内存之中的一段二进制数据,可以通过“视图”进行操作。“视图”部署了数组接口,这意味着,可以用数组的方法操作内存。 + +**(2)`TypedArray`视图**:共包括 9 种类型的视图,比如`Uint8Array`(无符号 8 位整数)数组视图, `Int16Array`(16 位整数)数组视图, `Float32Array`(32 位浮点数)数组视图等等。 + +**(3)`DataView`视图**:可以自定义复合格式的视图,比如第一个字节是 Uint8(无符号 8 位整数)、第二、三个字节是 Int16(16 位整数)、第四个字节开始是 Float32(32 位浮点数)等等,此外还可以自定义字节序。 + +简单说,`ArrayBuffer`对象代表原始的二进制数据,`TypedArray`视图用来读写简单类型的二进制数据,`DataView`视图用来读写复杂类型的二进制数据。 + +`TypedArray`视图支持的数据类型一共有 9 种(`DataView`视图支持除`Uint8C`以外的其他 8 种)。 + +| 数据类型 | 字节长度 | 含义 | 对应的 C 语言类型 | +| -------- | -------- | -------------------------------- | ----------------- | +| Int8 | 1 | 8 位带符号整数 | signed char | +| Uint8 | 1 | 8 位不带符号整数 | unsigned char | +| Uint8C | 1 | 8 位不带符号整数(自动过滤溢出) | unsigned char | +| Int16 | 2 | 16 位带符号整数 | short | +| Uint16 | 2 | 16 位不带符号整数 | unsigned short | +| Int32 | 4 | 32 位带符号整数 | int | +| Uint32 | 4 | 32 位不带符号的整数 | unsigned int | +| Float32 | 4 | 32 位浮点数 | float | +| Float64 | 8 | 64 位浮点数 | double | + +注意,二进制数组并不是真正的数组,而是类似数组的对象。 + +很多浏览器操作的 API,用到了二进制数组操作二进制数据,下面是其中的几个。 + +- File API +- XMLHttpRequest +- Fetch API +- Canvas +- WebSockets + +## ArrayBuffer 对象 + +### 概述 + +`ArrayBuffer`对象代表储存二进制数据的一段内存,它不能直接读写,只能通过视图(`TypedArray`视图和`DataView`视图)来读写,视图的作用是以指定格式解读二进制数据。 + +`ArrayBuffer`也是一个构造函数,可以分配一段可以存放数据的连续内存区域。 + +```javascript +const buf = new ArrayBuffer(32); +``` + +上面代码生成了一段 32 字节的内存区域,每个字节的值默认都是 0。可以看到,`ArrayBuffer`构造函数的参数是所需要的内存大小(单位字节)。 + +为了读写这段内容,需要为它指定视图。`DataView`视图的创建,需要提供`ArrayBuffer`对象实例作为参数。 + +```javascript +const buf = new ArrayBuffer(32); +const dataView = new DataView(buf); +dataView.getUint8(0) // 0 +``` + +上面代码对一段 32 字节的内存,建立`DataView`视图,然后以不带符号的 8 位整数格式,从头读取 8 位二进制数据,结果得到 0,因为原始内存的`ArrayBuffer`对象,默认所有位都是 0。 + +另一种`TypedArray`视图,与`DataView`视图的一个区别是,它不是一个构造函数,而是一组构造函数,代表不同的数据格式。 + +```javascript +const buffer = new ArrayBuffer(12); + +const x1 = new Int32Array(buffer); +x1[0] = 1; +const x2 = new Uint8Array(buffer); +x2[0] = 2; + +x1[0] // 2 +``` + +上面代码对同一段内存,分别建立两种视图:32 位带符号整数(`Int32Array`构造函数)和 8 位不带符号整数(`Uint8Array`构造函数)。由于两个视图对应的是同一段内存,一个视图修改底层内存,会影响到另一个视图。 + +`TypedArray`视图的构造函数,除了接受`ArrayBuffer`实例作为参数,还可以接受普通数组作为参数,直接分配内存生成底层的`ArrayBuffer`实例,并同时完成对这段内存的赋值。 + +```javascript +const typedArray = new Uint8Array([0,1,2]); +typedArray.length // 3 + +typedArray[0] = 5; +typedArray // [5, 1, 2] +``` + +上面代码使用`TypedArray`视图的`Uint8Array`构造函数,新建一个不带符号的 8 位整数视图。可以看到,`Uint8Array`直接使用普通数组作为参数,对底层内存的赋值同时完成。 + +### ArrayBuffer.prototype.byteLength + +`ArrayBuffer`实例的`byteLength`属性,返回所分配的内存区域的字节长度。 + +```javascript +const buffer = new ArrayBuffer(32); +buffer.byteLength +// 32 +``` + +如果要分配的内存区域很大,有可能分配失败(因为没有那么多的连续空余内存),所以有必要检查是否分配成功。 + +```javascript +if (buffer.byteLength === n) { + // 成功 +} else { + // 失败 +} +``` + +### ArrayBuffer.prototype.slice() + +`ArrayBuffer`实例有一个`slice`方法,允许将内存区域的一部分,拷贝生成一个新的`ArrayBuffer`对象。 + +```javascript +const buffer = new ArrayBuffer(8); +const newBuffer = buffer.slice(0, 3); +``` + +上面代码拷贝`buffer`对象的前 3 个字节(从 0 开始,到第 3 个字节前面结束),生成一个新的`ArrayBuffer`对象。`slice`方法其实包含两步,第一步是先分配一段新内存,第二步是将原来那个`ArrayBuffer`对象拷贝过去。 + +`slice`方法接受两个参数,第一个参数表示拷贝开始的字节序号(含该字节),第二个参数表示拷贝截止的字节序号(不含该字节)。如果省略第二个参数,则默认到原`ArrayBuffer`对象的结尾。 + +除了`slice`方法,`ArrayBuffer`对象不提供任何直接读写内存的方法,只允许在其上方建立视图,然后通过视图读写。 + +### ArrayBuffer.isView() + +`ArrayBuffer`有一个静态方法`isView`,返回一个布尔值,表示参数是否为`ArrayBuffer`的视图实例。这个方法大致相当于判断参数,是否为`TypedArray`实例或`DataView`实例。 + +```javascript +const buffer = new ArrayBuffer(8); +ArrayBuffer.isView(buffer) // false + +const v = new Int32Array(buffer); +ArrayBuffer.isView(v) // true +``` + +## TypedArray 视图 + +### 概述 + +`ArrayBuffer`对象作为内存区域,可以存放多种类型的数据。同一段内存,不同数据有不同的解读方式,这就叫做“视图”(view)。`ArrayBuffer`有两种视图,一种是`TypedArray`视图,另一种是`DataView`视图。前者的数组成员都是同一个数据类型,后者的数组成员可以是不同的数据类型。 + +目前,`TypedArray`视图一共包括 9 种类型,每一种视图都是一种构造函数。 + +- **`Int8Array`**:8 位有符号整数,长度 1 个字节。 +- **`Uint8Array`**:8 位无符号整数,长度 1 个字节。 +- **`Uint8ClampedArray`**:8 位无符号整数,长度 1 个字节,溢出处理不同。 +- **`Int16Array`**:16 位有符号整数,长度 2 个字节。 +- **`Uint16Array`**:16 位无符号整数,长度 2 个字节。 +- **`Int32Array`**:32 位有符号整数,长度 4 个字节。 +- **`Uint32Array`**:32 位无符号整数,长度 4 个字节。 +- **`Float32Array`**:32 位浮点数,长度 4 个字节。 +- **`Float64Array`**:64 位浮点数,长度 8 个字节。 + +这 9 个构造函数生成的数组,统称为`TypedArray`视图。它们很像普通数组,都有`length`属性,都能用方括号运算符(`[]`)获取单个元素,所有数组的方法,在它们上面都能使用。普通数组与 TypedArray 数组的差异主要在以下方面。 + +- TypedArray 数组的所有成员,都是同一种类型。 +- TypedArray 数组的成员是连续的,不会有空位。 +- TypedArray 数组成员的默认值为 0。比如,`new Array(10)`返回一个普通数组,里面没有任何成员,只是 10 个空位;`new Uint8Array(10)`返回一个 TypedArray 数组,里面 10 个成员都是 0。 +- TypedArray 数组只是一层视图,本身不储存数据,它的数据都储存在底层的`ArrayBuffer`对象之中,要获取底层对象必须使用`buffer`属性。 + +### 构造函数 + +TypedArray 数组提供 9 种构造函数,用来生成相应类型的数组实例。 + +构造函数有多种用法。 + +**(1)TypedArray(buffer, byteOffset=0, length?)** + +同一个`ArrayBuffer`对象之上,可以根据不同的数据类型,建立多个视图。 + +```javascript +// 创建一个8字节的ArrayBuffer +const b = new ArrayBuffer(8); + +// 创建一个指向b的Int32视图,开始于字节0,直到缓冲区的末尾 +const v1 = new Int32Array(b); + +// 创建一个指向b的Uint8视图,开始于字节2,直到缓冲区的末尾 +const v2 = new Uint8Array(b, 2); + +// 创建一个指向b的Int16视图,开始于字节2,长度为2 +const v3 = new Int16Array(b, 2, 2); +``` + +上面代码在一段长度为 8 个字节的内存(`b`)之上,生成了三个视图:`v1`、`v2`和`v3`。 + +视图的构造函数可以接受三个参数: + +- 第一个参数(必需):视图对应的底层`ArrayBuffer`对象。 +- 第二个参数(可选):视图开始的字节序号,默认从 0 开始。 +- 第三个参数(可选):视图包含的数据个数,默认直到本段内存区域结束。 + +因此,`v1`、`v2`和`v3`是重叠的:`v1[0]`是一个 32 位整数,指向字节 0 ~字节 3;`v2[0]`是一个 8 位无符号整数,指向字节 2;`v3[0]`是一个 16 位整数,指向字节 2 ~字节 3。只要任何一个视图对内存有所修改,就会在另外两个视图上反应出来。 + +注意,`byteOffset`必须与所要建立的数据类型一致,否则会报错。 + +```javascript +const buffer = new ArrayBuffer(8); +const i16 = new Int16Array(buffer, 1); +// Uncaught RangeError: start offset of Int16Array should be a multiple of 2 +``` + +上面代码中,新生成一个 8 个字节的`ArrayBuffer`对象,然后在这个对象的第一个字节,建立带符号的 16 位整数视图,结果报错。因为,带符号的 16 位整数需要两个字节,所以`byteOffset`参数必须能够被 2 整除。 + +如果想从任意字节开始解读`ArrayBuffer`对象,必须使用`DataView`视图,因为`TypedArray`视图只提供 9 种固定的解读格式。 + +**(2)TypedArray(length)** + +视图还可以不通过`ArrayBuffer`对象,直接分配内存而生成。 + +```javascript +const f64a = new Float64Array(8); +f64a[0] = 10; +f64a[1] = 20; +f64a[2] = f64a[0] + f64a[1]; +``` + +上面代码生成一个 8 个成员的`Float64Array`数组(共 64 字节),然后依次对每个成员赋值。这时,视图构造函数的参数就是成员的个数。可以看到,视图数组的赋值操作与普通数组的操作毫无两样。 + +**(3)TypedArray(typedArray)** + +TypedArray 数组的构造函数,可以接受另一个`TypedArray`实例作为参数。 + +```javascript +const typedArray = new Int8Array(new Uint8Array(4)); +``` + +上面代码中,`Int8Array`构造函数接受一个`Uint8Array`实例作为参数。 + +注意,此时生成的新数组,只是复制了参数数组的值,对应的底层内存是不一样的。新数组会开辟一段新的内存储存数据,不会在原数组的内存之上建立视图。 + +```javascript +const x = new Int8Array([1, 1]); +const y = new Int8Array(x); +x[0] // 1 +y[0] // 1 + +x[0] = 2; +y[0] // 1 +``` + +上面代码中,数组`y`是以数组`x`为模板而生成的,当`x`变动的时候,`y`并没有变动。 + +如果想基于同一段内存,构造不同的视图,可以采用下面的写法。 + +```javascript +const x = new Int8Array([1, 1]); +const y = new Int8Array(x.buffer); +x[0] // 1 +y[0] // 1 + +x[0] = 2; +y[0] // 2 +``` + +**(4)TypedArray(arrayLikeObject)** + +构造函数的参数也可以是一个普通数组,然后直接生成`TypedArray`实例。 + +```javascript +const typedArray = new Uint8Array([1, 2, 3, 4]); +``` + +注意,这时`TypedArray`视图会重新开辟内存,不会在原数组的内存上建立视图。 + +上面代码从一个普通的数组,生成一个 8 位无符号整数的`TypedArray`实例。 + +TypedArray 数组也可以转换回普通数组。 + +```javascript +const normalArray = [...typedArray]; +// or +const normalArray = Array.from(typedArray); +// or +const normalArray = Array.prototype.slice.call(typedArray); +``` + +### 数组方法 + +普通数组的操作方法和属性,对 TypedArray 数组完全适用。 + +- `TypedArray.prototype.copyWithin(target, start[, end = this.length])` +- `TypedArray.prototype.entries()` +- `TypedArray.prototype.every(callbackfn, thisArg?)` +- `TypedArray.prototype.fill(value, start=0, end=this.length)` +- `TypedArray.prototype.filter(callbackfn, thisArg?)` +- `TypedArray.prototype.find(predicate, thisArg?)` +- `TypedArray.prototype.findIndex(predicate, thisArg?)` +- `TypedArray.prototype.forEach(callbackfn, thisArg?)` +- `TypedArray.prototype.indexOf(searchElement, fromIndex=0)` +- `TypedArray.prototype.join(separator)` +- `TypedArray.prototype.keys()` +- `TypedArray.prototype.lastIndexOf(searchElement, fromIndex?)` +- `TypedArray.prototype.map(callbackfn, thisArg?)` +- `TypedArray.prototype.reduce(callbackfn, initialValue?)` +- `TypedArray.prototype.reduceRight(callbackfn, initialValue?)` +- `TypedArray.prototype.reverse()` +- `TypedArray.prototype.slice(start=0, end=this.length)` +- `TypedArray.prototype.some(callbackfn, thisArg?)` +- `TypedArray.prototype.sort(comparefn)` +- `TypedArray.prototype.toLocaleString(reserved1?, reserved2?)` +- `TypedArray.prototype.toString()` +- `TypedArray.prototype.values()` + +上面所有方法的用法,请参阅数组方法的介绍,这里不再重复了。 + +注意,TypedArray 数组没有`concat`方法。如果想要合并多个 TypedArray 数组,可以用下面这个函数。 + +```javascript +function concatenate(resultConstructor, ...arrays) { + let totalLength = 0; + for (let arr of arrays) { + totalLength += arr.length; + } + let result = new resultConstructor(totalLength); + let offset = 0; + for (let arr of arrays) { + result.set(arr, offset); + offset += arr.length; + } + return result; +} + +concatenate(Uint8Array, Uint8Array.of(1, 2), Uint8Array.of(3, 4)) +// Uint8Array [1, 2, 3, 4] +``` + +另外,TypedArray 数组与普通数组一样,部署了 Iterator 接口,所以可以被遍历。 + +```javascript +let ui8 = Uint8Array.of(0, 1, 2); +for (let byte of ui8) { + console.log(byte); +} +// 0 +// 1 +// 2 +``` + +### 字节序 + +字节序指的是数值在内存中的表示方式。 + +```javascript +const buffer = new ArrayBuffer(16); +const int32View = new Int32Array(buffer); + +for (let i = 0; i < int32View.length; i++) { + int32View[i] = i * 2; +} +``` + +上面代码生成一个 16 字节的`ArrayBuffer`对象,然后在它的基础上,建立了一个 32 位整数的视图。由于每个 32 位整数占据 4 个字节,所以一共可以写入 4 个整数,依次为 0,2,4,6。 + +如果在这段数据上接着建立一个 16 位整数的视图,则可以读出完全不一样的结果。 + +```javascript +const int16View = new Int16Array(buffer); + +for (let i = 0; i < int16View.length; i++) { + console.log("Entry " + i + ": " + int16View[i]); +} +// Entry 0: 0 +// Entry 1: 0 +// Entry 2: 2 +// Entry 3: 0 +// Entry 4: 4 +// Entry 5: 0 +// Entry 6: 6 +// Entry 7: 0 +``` + +由于每个 16 位整数占据 2 个字节,所以整个`ArrayBuffer`对象现在分成 8 段。然后,由于 x86 体系的计算机都采用小端字节序(little endian),相对重要的字节排在后面的内存地址,相对不重要字节排在前面的内存地址,所以就得到了上面的结果。 + +比如,一个占据四个字节的 16 进制数`0x12345678`,决定其大小的最重要的字节是“12”,最不重要的是“78”。小端字节序将最不重要的字节排在前面,储存顺序就是`78563412`;大端字节序则完全相反,将最重要的字节排在前面,储存顺序就是`12345678`。目前,所有个人电脑几乎都是小端字节序,所以 TypedArray 数组内部也采用小端字节序读写数据,或者更准确的说,按照本机操作系统设定的字节序读写数据。 + +这并不意味大端字节序不重要,事实上,很多网络设备和特定的操作系统采用的是大端字节序。这就带来一个严重的问题:如果一段数据是大端字节序,TypedArray 数组将无法正确解析,因为它只能处理小端字节序!为了解决这个问题,JavaScript 引入`DataView`对象,可以设定字节序,下文会详细介绍。 + +下面是另一个例子。 + +```javascript +// 假定某段buffer包含如下字节 [0x02, 0x01, 0x03, 0x07] +const buffer = new ArrayBuffer(4); +const v1 = new Uint8Array(buffer); +v1[0] = 2; +v1[1] = 1; +v1[2] = 3; +v1[3] = 7; + +const uInt16View = new Uint16Array(buffer); + +// 计算机采用小端字节序 +// 所以头两个字节等于258 +if (uInt16View[0] === 258) { + console.log('OK'); // "OK" +} + +// 赋值运算 +uInt16View[0] = 255; // 字节变为[0xFF, 0x00, 0x03, 0x07] +uInt16View[0] = 0xff05; // 字节变为[0x05, 0xFF, 0x03, 0x07] +uInt16View[1] = 0x0210; // 字节变为[0x05, 0xFF, 0x10, 0x02] +``` + +下面的函数可以用来判断,当前视图是小端字节序,还是大端字节序。 + +```javascript +const BIG_ENDIAN = Symbol('BIG_ENDIAN'); +const LITTLE_ENDIAN = Symbol('LITTLE_ENDIAN'); + +function getPlatformEndianness() { + let arr32 = Uint32Array.of(0x12345678); + let arr8 = new Uint8Array(arr32.buffer); + switch ((arr8[0]*0x1000000) + (arr8[1]*0x10000) + (arr8[2]*0x100) + (arr8[3])) { + case 0x12345678: + return BIG_ENDIAN; + case 0x78563412: + return LITTLE_ENDIAN; + default: + throw new Error('Unknown endianness'); + } +} +``` + +总之,与普通数组相比,TypedArray 数组的最大优点就是可以直接操作内存,不需要数据类型转换,所以速度快得多。 + +### BYTES_PER_ELEMENT 属性 + +每一种视图的构造函数,都有一个`BYTES_PER_ELEMENT`属性,表示这种数据类型占据的字节数。 + +```javascript +Int8Array.BYTES_PER_ELEMENT // 1 +Uint8Array.BYTES_PER_ELEMENT // 1 +Uint8ClampedArray.BYTES_PER_ELEMENT // 1 +Int16Array.BYTES_PER_ELEMENT // 2 +Uint16Array.BYTES_PER_ELEMENT // 2 +Int32Array.BYTES_PER_ELEMENT // 4 +Uint32Array.BYTES_PER_ELEMENT // 4 +Float32Array.BYTES_PER_ELEMENT // 4 +Float64Array.BYTES_PER_ELEMENT // 8 +``` + +这个属性在`TypedArray`实例上也能获取,即有`TypedArray.prototype.BYTES_PER_ELEMENT`。 + +### ArrayBuffer 与字符串的互相转换 + +`ArrayBuffer`转为字符串,或者字符串转为`ArrayBuffer`,有一个前提,即字符串的编码方法是确定的。假定字符串采用 UTF-16 编码(JavaScript 的内部编码方式),可以自己编写转换函数。 + +```javascript +// ArrayBuffer 转为字符串,参数为 ArrayBuffer 对象 +function ab2str(buf) { + // 注意,如果是大型二进制数组,为了避免溢出, + // 必须一个一个字符地转 + if (buf && buf.byteLength < 1024) { + return String.fromCharCode.apply(null, new Uint16Array(buf)); + } + + const bufView = new Uint16Array(buf); + const len = bufView.length; + const bstr = new Array(len); + for (let i = 0; i < len; i++) { + bstr[i] = String.fromCharCode.call(null, bufView[i]); + } + return bstr.join(''); +} + +// 字符串转为 ArrayBuffer 对象,参数为字符串 +function str2ab(str) { + const buf = new ArrayBuffer(str.length * 2); // 每个字符占用2个字节 + const bufView = new Uint16Array(buf); + for (let i = 0, strLen = str.length; i < strLen; i++) { + bufView[i] = str.charCodeAt(i); + } + return buf; +} +``` + +### 溢出 + +不同的视图类型,所能容纳的数值范围是确定的。超出这个范围,就会出现溢出。比如,8 位视图只能容纳一个 8 位的二进制值,如果放入一个 9 位的值,就会溢出。 + +TypedArray 数组的溢出处理规则,简单来说,就是抛弃溢出的位,然后按照视图类型进行解释。 + +```javascript +const uint8 = new Uint8Array(1); + +uint8[0] = 256; +uint8[0] // 0 + +uint8[0] = -1; +uint8[0] // 255 +``` + +上面代码中,`uint8`是一个 8 位视图,而 256 的二进制形式是一个 9 位的值`100000000`,这时就会发生溢出。根据规则,只会保留后 8 位,即`00000000`。`uint8`视图的解释规则是无符号的 8 位整数,所以`00000000`就是`0`。 + +负数在计算机内部采用“2 的补码”表示,也就是说,将对应的正数值进行否运算,然后加`1`。比如,`-1`对应的正值是`1`,进行否运算以后,得到`11111110`,再加上`1`就是补码形式`11111111`。`uint8`按照无符号的 8 位整数解释`11111111`,返回结果就是`255`。 + +一个简单转换规则,可以这样表示。 + +- 正向溢出(overflow):当输入值大于当前数据类型的最大值,结果等于当前数据类型的最小值加上余值,再减去 1。 +- 负向溢出(underflow):当输入值小于当前数据类型的最小值,结果等于当前数据类型的最大值减去余值的绝对值,再加上 1。 + +上面的“余值”就是模运算的结果,即 JavaScript 里面的`%`运算符的结果。 + +```javascript +12 % 4 // 0 +12 % 5 // 2 +``` + +上面代码中,12 除以 4 是没有余值的,而除以 5 会得到余值 2。 + +请看下面的例子。 + +```javascript +const int8 = new Int8Array(1); + +int8[0] = 128; +int8[0] // -128 + +int8[0] = -129; +int8[0] // 127 +``` + +上面例子中,`int8`是一个带符号的 8 位整数视图,它的最大值是 127,最小值是-128。输入值为`128`时,相当于正向溢出`1`,根据“最小值加上余值(128 除以 127 的余值是 1),再减去 1”的规则,就会返回`-128`;输入值为`-129`时,相当于负向溢出`1`,根据“最大值减去余值的绝对值(-129 除以-128 的余值的绝对值是 1),再加上 1”的规则,就会返回`127`。 + +`Uint8ClampedArray`视图的溢出规则,与上面的规则不同。它规定,凡是发生正向溢出,该值一律等于当前数据类型的最大值,即 255;如果发生负向溢出,该值一律等于当前数据类型的最小值,即 0。 + +```javascript +const uint8c = new Uint8ClampedArray(1); + +uint8c[0] = 256; +uint8c[0] // 255 + +uint8c[0] = -1; +uint8c[0] // 0 +``` + +上面例子中,`uint8C`是一个`Uint8ClampedArray`视图,正向溢出时都返回 255,负向溢出都返回 0。 + +### TypedArray.prototype.buffer + +`TypedArray`实例的`buffer`属性,返回整段内存区域对应的`ArrayBuffer`对象。该属性为只读属性。 + +```javascript +const a = new Float32Array(64); +const b = new Uint8Array(a.buffer); +``` + +上面代码的`a`视图对象和`b`视图对象,对应同一个`ArrayBuffer`对象,即同一段内存。 + +### TypedArray.prototype.byteLength,TypedArray.prototype.byteOffset + +`byteLength`属性返回 TypedArray 数组占据的内存长度,单位为字节。`byteOffset`属性返回 TypedArray 数组从底层`ArrayBuffer`对象的哪个字节开始。这两个属性都是只读属性。 + +```javascript +const b = new ArrayBuffer(8); + +const v1 = new Int32Array(b); +const v2 = new Uint8Array(b, 2); +const v3 = new Int16Array(b, 2, 2); + +v1.byteLength // 8 +v2.byteLength // 6 +v3.byteLength // 4 + +v1.byteOffset // 0 +v2.byteOffset // 2 +v3.byteOffset // 2 +``` + +### TypedArray.prototype.length + +`length`属性表示 TypedArray 数组含有多少个成员。注意将`byteLength`属性和`length`属性区分,前者是字节长度,后者是成员长度。 + +```javascript +const a = new Int16Array(8); + +a.length // 8 +a.byteLength // 16 +``` + +### TypedArray.prototype.set() + +TypedArray 数组的`set`方法用于复制数组(普通数组或 TypedArray 数组),也就是将一段内容完全复制到另一段内存。 + +```javascript +const a = new Uint8Array(8); +const b = new Uint8Array(8); + +b.set(a); +``` + +上面代码复制`a`数组的内容到`b`数组,它是整段内存的复制,比一个个拷贝成员的那种复制快得多。 + +`set`方法还可以接受第二个参数,表示从`b`对象的哪一个成员开始复制`a`对象。 + +```javascript +const a = new Uint16Array(8); +const b = new Uint16Array(10); + +b.set(a, 2) +``` + +上面代码的`b`数组比`a`数组多两个成员,所以从`b[2]`开始复制。 + +### TypedArray.prototype.subarray() + +`subarray`方法是对于 TypedArray 数组的一部分,再建立一个新的视图。 + +```javascript +const a = new Uint16Array(8); +const b = a.subarray(2,3); + +a.byteLength // 16 +b.byteLength // 2 +``` + +`subarray`方法的第一个参数是起始的成员序号,第二个参数是结束的成员序号(不含该成员),如果省略则包含剩余的全部成员。所以,上面代码的`a.subarray(2,3)`,意味着 b 只包含`a[2]`一个成员,字节长度为 2。 + +### TypedArray.prototype.slice() + +TypeArray 实例的`slice`方法,可以返回一个指定位置的新的`TypedArray`实例。 + +```javascript +let ui8 = Uint8Array.of(0, 1, 2); +ui8.slice(-1) +// Uint8Array [ 2 ] +``` + +上面代码中,`ui8`是 8 位无符号整数数组视图的一个实例。它的`slice`方法可以从当前视图之中,返回一个新的视图实例。 + +`slice`方法的参数,表示原数组的具体位置,开始生成新数组。负值表示逆向的位置,即-1 为倒数第一个位置,-2 表示倒数第二个位置,以此类推。 + +### TypedArray.of() + +TypedArray 数组的所有构造函数,都有一个静态方法`of`,用于将参数转为一个`TypedArray`实例。 + +```javascript +Float32Array.of(0.151, -8, 3.7) +// Float32Array [ 0.151, -8, 3.7 ] +``` + +下面三种方法都会生成同样一个 TypedArray 数组。 + +```javascript +// 方法一 +let tarr = new Uint8Array([1,2,3]); + +// 方法二 +let tarr = Uint8Array.of(1,2,3); + +// 方法三 +let tarr = new Uint8Array(3); +tarr[0] = 1; +tarr[1] = 2; +tarr[2] = 3; +``` + +### TypedArray.from() + +静态方法`from`接受一个可遍历的数据结构(比如数组)作为参数,返回一个基于这个结构的`TypedArray`实例。 + +```javascript +Uint16Array.from([0, 1, 2]) +// Uint16Array [ 0, 1, 2 ] +``` + +这个方法还可以将一种`TypedArray`实例,转为另一种。 + +```javascript +const ui16 = Uint16Array.from(Uint8Array.of(0, 1, 2)); +ui16 instanceof Uint16Array // true +``` + +`from`方法还可以接受一个函数,作为第二个参数,用来对每个元素进行遍历,功能类似`map`方法。 + +```javascript +Int8Array.of(127, 126, 125).map(x => 2 * x) +// Int8Array [ -2, -4, -6 ] + +Int16Array.from(Int8Array.of(127, 126, 125), x => 2 * x) +// Int16Array [ 254, 252, 250 ] +``` + +上面的例子中,`from`方法没有发生溢出,这说明遍历不是针对原来的 8 位整数数组。也就是说,`from`会将第一个参数指定的 TypedArray 数组,拷贝到另一段内存之中,处理之后再将结果转成指定的数组格式。 + +## 复合视图 + +由于视图的构造函数可以指定起始位置和长度,所以在同一段内存之中,可以依次存放不同类型的数据,这叫做“复合视图”。 + +```javascript +const buffer = new ArrayBuffer(24); + +const idView = new Uint32Array(buffer, 0, 1); +const usernameView = new Uint8Array(buffer, 4, 16); +const amountDueView = new Float32Array(buffer, 20, 1); +``` + +上面代码将一个 24 字节长度的`ArrayBuffer`对象,分成三个部分: + +- 字节 0 到字节 3:1 个 32 位无符号整数 +- 字节 4 到字节 19:16 个 8 位整数 +- 字节 20 到字节 23:1 个 32 位浮点数 + +这种数据结构可以用如下的 C 语言描述: + +```c +struct someStruct { + unsigned long id; + char username[16]; + float amountDue; +}; +``` + +## DataView 视图 + +如果一段数据包括多种类型(比如服务器传来的 HTTP 数据),这时除了建立`ArrayBuffer`对象的复合视图以外,还可以通过`DataView`视图进行操作。 + +`DataView`视图提供更多操作选项,而且支持设定字节序。本来,在设计目的上,`ArrayBuffer`对象的各种`TypedArray`视图,是用来向网卡、声卡之类的本机设备传送数据,所以使用本机的字节序就可以了;而`DataView`视图的设计目的,是用来处理网络设备传来的数据,所以大端字节序或小端字节序是可以自行设定的。 + +`DataView`视图本身也是构造函数,接受一个`ArrayBuffer`对象作为参数,生成视图。 + +```javascript +DataView(ArrayBuffer buffer [, 字节起始位置 [, 长度]]); +``` + +下面是一个例子。 + +```javascript +const buffer = new ArrayBuffer(24); +const dv = new DataView(buffer); +``` + +`DataView`实例有以下属性,含义与`TypedArray`实例的同名方法相同。 + +- `DataView.prototype.buffer`:返回对应的 ArrayBuffer 对象 +- `DataView.prototype.byteLength`:返回占据的内存字节长度 +- `DataView.prototype.byteOffset`:返回当前视图从对应的 ArrayBuffer 对象的哪个字节开始 + +`DataView`实例提供 8 个方法读取内存。 + +- **`getInt8`**:读取 1 个字节,返回一个 8 位整数。 +- **`getUint8`**:读取 1 个字节,返回一个无符号的 8 位整数。 +- **`getInt16`**:读取 2 个字节,返回一个 16 位整数。 +- **`getUint16`**:读取 2 个字节,返回一个无符号的 16 位整数。 +- **`getInt32`**:读取 4 个字节,返回一个 32 位整数。 +- **`getUint32`**:读取 4 个字节,返回一个无符号的 32 位整数。 +- **`getFloat32`**:读取 4 个字节,返回一个 32 位浮点数。 +- **`getFloat64`**:读取 8 个字节,返回一个 64 位浮点数。 + +这一系列`get`方法的参数都是一个字节序号(不能是负数,否则会报错),表示从哪个字节开始读取。 + +```javascript +const buffer = new ArrayBuffer(24); +const dv = new DataView(buffer); + +// 从第1个字节读取一个8位无符号整数 +const v1 = dv.getUint8(0); + +// 从第2个字节读取一个16位无符号整数 +const v2 = dv.getUint16(1); + +// 从第4个字节读取一个16位无符号整数 +const v3 = dv.getUint16(3); +``` + +上面代码读取了`ArrayBuffer`对象的前 5 个字节,其中有一个 8 位整数和两个十六位整数。 + +如果一次读取两个或两个以上字节,就必须明确数据的存储方式,到底是小端字节序还是大端字节序。默认情况下,`DataView`的`get`方法使用大端字节序解读数据,如果需要使用小端字节序解读,必须在`get`方法的第二个参数指定`true`。 + +```javascript +// 小端字节序 +const v1 = dv.getUint16(1, true); + +// 大端字节序 +const v2 = dv.getUint16(3, false); + +// 大端字节序 +const v3 = dv.getUint16(3); +``` + +DataView 视图提供 8 个方法写入内存。 + +- **`setInt8`**:写入 1 个字节的 8 位整数。 +- **`setUint8`**:写入 1 个字节的 8 位无符号整数。 +- **`setInt16`**:写入 2 个字节的 16 位整数。 +- **`setUint16`**:写入 2 个字节的 16 位无符号整数。 +- **`setInt32`**:写入 4 个字节的 32 位整数。 +- **`setUint32`**:写入 4 个字节的 32 位无符号整数。 +- **`setFloat32`**:写入 4 个字节的 32 位浮点数。 +- **`setFloat64`**:写入 8 个字节的 64 位浮点数。 + +这一系列`set`方法,接受两个参数,第一个参数是字节序号,表示从哪个字节开始写入,第二个参数为写入的数据。对于那些写入两个或两个以上字节的方法,需要指定第三个参数,`false`或者`undefined`表示使用大端字节序写入,`true`表示使用小端字节序写入。 + +```javascript +// 在第1个字节,以大端字节序写入值为25的32位整数 +dv.setInt32(0, 25, false); + +// 在第5个字节,以大端字节序写入值为25的32位整数 +dv.setInt32(4, 25); + +// 在第9个字节,以小端字节序写入值为2.5的32位浮点数 +dv.setFloat32(8, 2.5, true); +``` + +如果不确定正在使用的计算机的字节序,可以采用下面的判断方式。 + +```javascript +const littleEndian = (function() { + const buffer = new ArrayBuffer(2); + new DataView(buffer).setInt16(0, 256, true); + return new Int16Array(buffer)[0] === 256; +})(); +``` + +如果返回`true`,就是小端字节序;如果返回`false`,就是大端字节序。 + +## 二进制数组的应用 + +大量的 Web API 用到了`ArrayBuffer`对象和它的视图对象。 + +### AJAX + +传统上,服务器通过 AJAX 操作只能返回文本数据,即`responseType`属性默认为`text`。`XMLHttpRequest`第二版`XHR2`允许服务器返回二进制数据,这时分成两种情况。如果明确知道返回的二进制数据类型,可以把返回类型(`responseType`)设为`arraybuffer`;如果不知道,就设为`blob`。 + +```javascript +let xhr = new XMLHttpRequest(); +xhr.open('GET', someUrl); +xhr.responseType = 'arraybuffer'; + +xhr.onload = function () { + let arrayBuffer = xhr.response; + // ··· +}; + +xhr.send(); +``` + +如果知道传回来的是 32 位整数,可以像下面这样处理。 + +```javascript +xhr.onreadystatechange = function () { + if (req.readyState === 4 ) { + const arrayResponse = xhr.response; + const dataView = new DataView(arrayResponse); + const ints = new Uint32Array(dataView.byteLength / 4); + + xhrDiv.style.backgroundColor = "#00FF00"; + xhrDiv.innerText = "Array is " + ints.length + "uints long"; + } +} +``` + +### Canvas + +网页`Canvas`元素输出的二进制像素数据,就是 TypedArray 数组。 + +```javascript +const canvas = document.getElementById('myCanvas'); +const ctx = canvas.getContext('2d'); + +const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height); +const uint8ClampedArray = imageData.data; +``` + +需要注意的是,上面代码的`uint8ClampedArray`虽然是一个 TypedArray 数组,但是它的视图类型是一种针对`Canvas`元素的专有类型`Uint8ClampedArray`。这个视图类型的特点,就是专门针对颜色,把每个字节解读为无符号的 8 位整数,即只能取值 0 ~ 255,而且发生运算的时候自动过滤高位溢出。这为图像处理带来了巨大的方便。 + +举例来说,如果把像素的颜色值设为`Uint8Array`类型,那么乘以一个 gamma 值的时候,就必须这样计算: + +```javascript +u8[i] = Math.min(255, Math.max(0, u8[i] * gamma)); +``` + +因为`Uint8Array`类型对于大于 255 的运算结果(比如`0xFF+1`),会自动变为`0x00`,所以图像处理必须要像上面这样算。这样做很麻烦,而且影响性能。如果将颜色值设为`Uint8ClampedArray`类型,计算就简化许多。 + +```javascript +pixels[i] *= gamma; +``` + +`Uint8ClampedArray`类型确保将小于 0 的值设为 0,将大于 255 的值设为 255。注意,IE 10 不支持该类型。 + +### WebSocket + +`WebSocket`可以通过`ArrayBuffer`,发送或接收二进制数据。 + +```javascript +let socket = new WebSocket('ws://127.0.0.1:8081'); +socket.binaryType = 'arraybuffer'; + +// Wait until socket is open +socket.addEventListener('open', function (event) { + // Send binary data + const typedArray = new Uint8Array(4); + socket.send(typedArray.buffer); +}); + +// Receive binary data +socket.addEventListener('message', function (event) { + const arrayBuffer = event.data; + // ··· +}); +``` + +### Fetch API + +Fetch API 取回的数据,就是`ArrayBuffer`对象。 + +```javascript +fetch(url) +.then(function(response){ + return response.arrayBuffer() +}) +.then(function(arrayBuffer){ + // ... +}); +``` + +### File API + +如果知道一个文件的二进制数据类型,也可以将这个文件读取为`ArrayBuffer`对象。 + +```javascript +const fileInput = document.getElementById('fileInput'); +const file = fileInput.files[0]; +const reader = new FileReader(); +reader.readAsArrayBuffer(file); +reader.onload = function () { + const arrayBuffer = reader.result; + // ··· +}; +``` + +下面以处理 bmp 文件为例。假定`file`变量是一个指向 bmp 文件的文件对象,首先读取文件。 + +```javascript +const reader = new FileReader(); +reader.addEventListener("load", processimage, false); +reader.readAsArrayBuffer(file); +``` + +然后,定义处理图像的回调函数:先在二进制数据之上建立一个`DataView`视图,再建立一个`bitmap`对象,用于存放处理后的数据,最后将图像展示在`Canvas`元素之中。 + +```javascript +function processimage(e) { + const buffer = e.target.result; + const datav = new DataView(buffer); + const bitmap = {}; + // 具体的处理步骤 +} +``` + +具体处理图像数据时,先处理 bmp 的文件头。具体每个文件头的格式和定义,请参阅有关资料。 + +```javascript +bitmap.fileheader = {}; +bitmap.fileheader.bfType = datav.getUint16(0, true); +bitmap.fileheader.bfSize = datav.getUint32(2, true); +bitmap.fileheader.bfReserved1 = datav.getUint16(6, true); +bitmap.fileheader.bfReserved2 = datav.getUint16(8, true); +bitmap.fileheader.bfOffBits = datav.getUint32(10, true); +``` + +接着处理图像元信息部分。 + +```javascript +bitmap.infoheader = {}; +bitmap.infoheader.biSize = datav.getUint32(14, true); +bitmap.infoheader.biWidth = datav.getUint32(18, true); +bitmap.infoheader.biHeight = datav.getUint32(22, true); +bitmap.infoheader.biPlanes = datav.getUint16(26, true); +bitmap.infoheader.biBitCount = datav.getUint16(28, true); +bitmap.infoheader.biCompression = datav.getUint32(30, true); +bitmap.infoheader.biSizeImage = datav.getUint32(34, true); +bitmap.infoheader.biXPelsPerMeter = datav.getUint32(38, true); +bitmap.infoheader.biYPelsPerMeter = datav.getUint32(42, true); +bitmap.infoheader.biClrUsed = datav.getUint32(46, true); +bitmap.infoheader.biClrImportant = datav.getUint32(50, true); +``` + +最后处理图像本身的像素信息。 + +```javascript +const start = bitmap.fileheader.bfOffBits; +bitmap.pixels = new Uint8Array(buffer, start); +``` + +至此,图像文件的数据全部处理完成。下一步,可以根据需要,进行图像变形,或者转换格式,或者展示在`Canvas`网页元素之中。 + +## SharedArrayBuffer + +JavaScript 是单线程的,Web worker 引入了多线程:主线程用来与用户互动,Worker 线程用来承担计算任务。每个线程的数据都是隔离的,通过`postMessage()`通信。下面是一个例子。 + +```javascript +// 主线程 +const w = new Worker('myworker.js'); +``` + +上面代码中,主线程新建了一个 Worker 线程。该线程与主线程之间会有一个通信渠道,主线程通过`w.postMessage`向 Worker 线程发消息,同时通过`message`事件监听 Worker 线程的回应。 + +```javascript +// 主线程 +w.postMessage('hi'); +w.onmessage = function (ev) { + console.log(ev.data); +} +``` + +上面代码中,主线程先发一个消息`hi`,然后在监听到 Worker 线程的回应后,就将其打印出来。 + +Worker 线程也是通过监听`message`事件,来获取主线程发来的消息,并作出反应。 + +```javascript +// Worker 线程 +onmessage = function (ev) { + console.log(ev.data); + postMessage('ho'); +} +``` + +线程之间的数据交换可以是各种格式,不仅仅是字符串,也可以是二进制数据。这种交换采用的是复制机制,即一个进程将需要分享的数据复制一份,通过`postMessage`方法交给另一个进程。如果数据量比较大,这种通信的效率显然比较低。很容易想到,这时可以留出一块内存区域,由主线程与 Worker 线程共享,两方都可以读写,那么就会大大提高效率,协作起来也会比较简单(不像`postMessage`那么麻烦)。 + +ES2017 引入[`SharedArrayBuffer`](https://github.com/tc39/ecmascript_sharedmem/blob/master/TUTORIAL.md),允许 Worker 线程与主线程共享同一块内存。`SharedArrayBuffer`的 API 与`ArrayBuffer`一模一样,唯一的区别是后者无法共享数据。 + +```javascript +// 主线程 + +// 新建 1KB 共享内存 +const sharedBuffer = new SharedArrayBuffer(1024); + +// 主线程将共享内存的地址发送出去 +w.postMessage(sharedBuffer); + +// 在共享内存上建立视图,供写入数据 +const sharedArray = new Int32Array(sharedBuffer); +``` + +上面代码中,`postMessage`方法的参数是`SharedArrayBuffer`对象。 + +Worker 线程从事件的`data`属性上面取到数据。 + +```javascript +// Worker 线程 +onmessage = function (ev) { + // 主线程共享的数据,就是 1KB 的共享内存 + const sharedBuffer = ev.data; + + // 在共享内存上建立视图,方便读写 + const sharedArray = new Int32Array(sharedBuffer); + + // ... +}; +``` + +共享内存也可以在 Worker 线程创建,发给主线程。 + +`SharedArrayBuffer`与`ArrayBuffer`一样,本身是无法读写的,必须在上面建立视图,然后通过视图读写。 + +```javascript +// 分配 10 万个 32 位整数占据的内存空间 +const sab = new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * 100000); + +// 建立 32 位整数视图 +const ia = new Int32Array(sab); // ia.length == 100000 + +// 新建一个质数生成器 +const primes = new PrimeGenerator(); + +// 将 10 万个质数,写入这段内存空间 +for ( let i=0 ; i < ia.length ; i++ ) + ia[i] = primes.next(); + +// 向 Worker 线程发送这段共享内存 +w.postMessage(ia); +``` + +Worker 线程收到数据后的处理如下。 + +```javascript +// Worker 线程 +let ia; +onmessage = function (ev) { + ia = ev.data; + console.log(ia.length); // 100000 + console.log(ia[37]); // 输出 163,因为这是第38个质数 +}; +``` + +## Atomics 对象 + +多线程共享内存,最大的问题就是如何防止两个线程同时修改某个地址,或者说,当一个线程修改共享内存以后,必须有一个机制让其他线程同步。SharedArrayBuffer API 提供`Atomics`对象,保证所有共享内存的操作都是“原子性”的,并且可以在所有线程内同步。 + +什么叫“原子性操作”呢?现代编程语言中,一条普通的命令被编译器处理以后,会变成多条机器指令。如果是单线程运行,这是没有问题的;多线程环境并且共享内存时,就会出问题,因为这一组机器指令的运行期间,可能会插入其他线程的指令,从而导致运行结果出错。请看下面的例子。 + +```javascript +// 主线程 +ia[42] = 314159; // 原先的值 191 +ia[37] = 123456; // 原先的值 163 + +// Worker 线程 +console.log(ia[37]); +console.log(ia[42]); +// 可能的结果 +// 123456 +// 191 +``` + +上面代码中,主线程的原始顺序是先对 42 号位置赋值,再对 37 号位置赋值。但是,编译器和 CPU 为了优化,可能会改变这两个操作的执行顺序(因为它们之间互不依赖),先对 37 号位置赋值,再对 42 号位置赋值。而执行到一半的时候,Worker 线程可能就会来读取数据,导致打印出`123456`和`191`。 + +下面是另一个例子。 + +```javascript +// 主线程 +const sab = new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * 100000); +const ia = new Int32Array(sab); + +for (let i = 0; i < ia.length; i++) { + ia[i] = primes.next(); // 将质数放入 ia +} + +// worker 线程 +ia[112]++; // 错误 +Atomics.add(ia, 112, 1); // 正确 +``` + +上面代码中,Worker 线程直接改写共享内存`ia[112]++`是不正确的。因为这行语句会被编译成多条机器指令,这些指令之间无法保证不会插入其他进程的指令。请设想如果两个线程同时`ia[112]++`,很可能它们得到的结果都是不正确的。 + +`Atomics`对象就是为了解决这个问题而提出,它可以保证一个操作所对应的多条机器指令,一定是作为一个整体运行的,中间不会被打断。也就是说,它所涉及的操作都可以看作是原子性的单操作,这可以避免线程竞争,提高多线程共享内存时的操作安全。所以,`ia[112]++`要改写成`Atomics.add(ia, 112, 1)`。 + +`Atomics`对象提供多种方法。 + +**(1)Atomics.store(),Atomics.load()** + +`store()`方法用来向共享内存写入数据,`load()`方法用来从共享内存读出数据。比起直接的读写操作,它们的好处是保证了读写操作的原子性。 + +此外,它们还用来解决一个问题:多个线程使用共享内存的某个位置作为开关(flag),一旦该位置的值变了,就执行特定操作。这时,必须保证该位置的赋值操作,一定是在它前面的所有可能会改写内存的操作结束后执行;而该位置的取值操作,一定是在它后面所有可能会读取该位置的操作开始之前执行。`store`方法和`load`方法就能做到这一点,编译器不会为了优化,而打乱机器指令的执行顺序。 + +```javascript +Atomics.load(array, index) +Atomics.store(array, index, value) +``` + +`store`方法接受三个参数:SharedBuffer 的视图、位置索引和值,返回`sharedArray[index]`的值。`load`方法只接受两个参数:SharedBuffer 的视图和位置索引,也是返回`sharedArray[index]`的值。 + +```javascript +// 主线程 main.js +ia[42] = 314159; // 原先的值 191 +Atomics.store(ia, 37, 123456); // 原先的值是 163 + +// Worker 线程 worker.js +while (Atomics.load(ia, 37) == 163); +console.log(ia[37]); // 123456 +console.log(ia[42]); // 314159 +``` + +上面代码中,主线程的`Atomics.store`向 42 号位置的赋值,一定是早于 37 位置的赋值。只要 37 号位置等于 163,Worker 线程就不会终止循环,而对 37 号位置和 42 号位置的取值,一定是在`Atomics.load`操作之后。 + +下面是另一个例子。 + +```javascript +// 主线程 +const worker = new Worker('worker.js'); +const length = 10; +const size = Int32Array.BYTES_PER_ELEMENT * length; +// 新建一段共享内存 +const sharedBuffer = new SharedArrayBuffer(size); +const sharedArray = new Int32Array(sharedBuffer); +for (let i = 0; i < 10; i++) { + // 向共享内存写入 10 个整数 + Atomics.store(sharedArray, i, 0); +} +worker.postMessage(sharedBuffer); +``` + +上面代码中,主线程用`Atomics.store()`方法写入数据。下面是 Worker 线程用`Atomics.load()`方法读取数据。 + +```javascript +// worker.js +self.addEventListener('message', (event) => { + const sharedArray = new Int32Array(event.data); + for (let i = 0; i < 10; i++) { + const arrayValue = Atomics.load(sharedArray, i); + console.log(`The item at array index ${i} is ${arrayValue}`); + } +}, false); +``` + +**(2)Atomics.exchange()** + +Worker 线程如果要写入数据,可以使用上面的`Atomics.store()`方法,也可以使用`Atomics.exchange()`方法。它们的区别是,`Atomics.store()`返回写入的值,而`Atomics.exchange()`返回被替换的值。 + +```javascript +// Worker 线程 +self.addEventListener('message', (event) => { + const sharedArray = new Int32Array(event.data); + for (let i = 0; i < 10; i++) { + if (i % 2 === 0) { + const storedValue = Atomics.store(sharedArray, i, 1); + console.log(`The item at array index ${i} is now ${storedValue}`); + } else { + const exchangedValue = Atomics.exchange(sharedArray, i, 2); + console.log(`The item at array index ${i} was ${exchangedValue}, now 2`); + } + } +}, false); +``` + +上面代码将共享内存的偶数位置的值改成`1`,奇数位置的值改成`2`。 + +**(3)Atomics.wait(),Atomics.wake()** + +使用`while`循环等待主线程的通知,不是很高效,如果用在主线程,就会造成卡顿,`Atomics`对象提供了`wait()`和`wake()`两个方法用于等待通知。这两个方法相当于锁内存,即在一个线程进行操作时,让其他线程休眠(建立锁),等到操作结束,再唤醒那些休眠的线程(解除锁)。 + +```javascript +// Worker 线程 +self.addEventListener('message', (event) => { + const sharedArray = new Int32Array(event.data); + const arrayIndex = 0; + const expectedStoredValue = 50; + Atomics.wait(sharedArray, arrayIndex, expectedStoredValue); + console.log(Atomics.load(sharedArray, arrayIndex)); +}, false); +``` + +上面代码中,`Atomics.wait()`方法等同于告诉 Worker 线程,只要满足给定条件(`sharedArray`的`0`号位置等于`50`),就在这一行 Worker 线程进入休眠。 + +主线程一旦更改了指定位置的值,就可以唤醒 Worker 线程。 + +```javascript +// 主线程 +const newArrayValue = 100; +Atomics.store(sharedArray, 0, newArrayValue); +const arrayIndex = 0; +const queuePos = 1; +Atomics.wake(sharedArray, arrayIndex, queuePos); +``` + +上面代码中,`sharedArray`的`0`号位置改为`100`,然后就执行`Atomics.wake()`方法,唤醒在`sharedArray`的`0`号位置休眠队列里的一个线程。 + +`Atomics.wait()`方法的使用格式如下。 + +```javascript +Atomics.wait(sharedArray, index, value, timeout) +``` + +它的四个参数含义如下。 + +- sharedArray:共享内存的视图数组。 +- index:视图数据的位置(从0开始)。 +- value:该位置的预期值。一旦实际值等于预期值,就进入休眠。 +- timeout:整数,表示过了这个时间以后,就自动唤醒,单位毫秒。该参数可选,默认值是`Infinity`,即无限期的休眠,只有通过`Atomics.wake()`方法才能唤醒。 + +`Atomics.wait()`的返回值是一个字符串,共有三种可能的值。如果`sharedArray[index]`不等于`value`,就返回字符串`not-equal`,否则就进入休眠。如果`Atomics.wake()`方法唤醒,就返回字符串`ok`;如果因为超时唤醒,就返回字符串`timed-out`。 + +`Atomics.wake()`方法的使用格式如下。 + +```javascript +Atomics.wake(sharedArray, index, count) +``` + +它的三个参数含义如下。 + +- sharedArray:共享内存的视图数组。 +- index:视图数据的位置(从0开始)。 +- count:需要唤醒的 Worker 线程的数量,默认为`Infinity`。 + +`Atomics.wake()`方法一旦唤醒休眠的 Worker 线程,就会让它继续往下运行。 + +请看一个例子。 + +```javascript +// 主线程 +console.log(ia[37]); // 163 +Atomics.store(ia, 37, 123456); +Atomics.wake(ia, 37, 1); + +// Worker 线程 +Atomics.wait(ia, 37, 163); +console.log(ia[37]); // 123456 +``` + +上面代码中,视图数组`ia`的第 37 号位置,原来的值是`163`。Worker 线程使用`Atomics.wait()`方法,指定只要`ia[37]`等于`163`,就进入休眠状态。主线程使用`Atomics.store()`方法,将`123456`写入`ia[37]`,然后使用`Atomics.wake()`方法唤醒 Worker 线程。 + +另外,基于`wait`和`wake`这两个方法的锁内存实现,可以看 Lars T Hansen 的 [js-lock-and-condition](https://github.com/lars-t-hansen/js-lock-and-condition) 这个库。 + +注意,浏览器的主线程不宜设置休眠,这会导致用户失去响应。而且,主线程实际上会拒绝进入休眠。 + +**(4)运算方法** + +共享内存上面的某些运算是不能被打断的,即不能在运算过程中,让其他线程改写内存上面的值。Atomics 对象提供了一些运算方法,防止数据被改写。 + +```javascript +Atomics.add(sharedArray, index, value) +``` + +`Atomics.add`用于将`value`加到`sharedArray[index]`,返回`sharedArray[index]`旧的值。 + +```javascript +Atomics.sub(sharedArray, index, value) +``` + +`Atomics.sub`用于将`value`从`sharedArray[index]`减去,返回`sharedArray[index]`旧的值。 + +```javascript +Atomics.and(sharedArray, index, value) +``` + +`Atomics.and`用于将`value`与`sharedArray[index]`进行位运算`and`,放入`sharedArray[index]`,并返回旧的值。 + +```javascript +Atomics.or(sharedArray, index, value) +``` + +`Atomics.or`用于将`value`与`sharedArray[index]`进行位运算`or`,放入`sharedArray[index]`,并返回旧的值。 + +```javascript +Atomics.xor(sharedArray, index, value) +``` + +`Atomic.xor`用于将`vaule`与`sharedArray[index]`进行位运算`xor`,放入`sharedArray[index]`,并返回旧的值。 + +**(5)其他方法** + +`Atomics`对象还有以下方法。 + +- `Atomics.compareExchange(sharedArray, index, oldval, newval)`:如果`sharedArray[index]`等于`oldval`,就写入`newval`,返回`oldval`。 +- `Atomics.isLockFree(size)`:返回一个布尔值,表示`Atomics`对象是否可以处理某个`size`的内存锁定。如果返回`false`,应用程序就需要自己来实现锁定。 + +`Atomics.compareExchange`的一个用途是,从 SharedArrayBuffer 读取一个值,然后对该值进行某个操作,操作结束以后,检查一下 SharedArrayBuffer 里面原来那个值是否发生变化(即被其他线程改写过)。如果没有改写过,就将它写回原来的位置,否则读取新的值,再重头进行一次操作。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/async.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/async.md" old mode 100644 new mode 100755 similarity index 63% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/async.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/async.md" index de1bc598d..8e707a3b5 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/async.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/async.md" @@ -9,31 +9,31 @@ async 函数是什么?一句话,它就是 Generator 函数的语法糖。 前文有一个 Generator 函数,依次读取两个文件。 ```javascript -var fs = require('fs'); +const fs = require('fs'); -var readFile = function (fileName) { +const readFile = function (fileName) { return new Promise(function (resolve, reject) { fs.readFile(fileName, function(error, data) { - if (error) reject(error); + if (error) return reject(error); resolve(data); }); }); }; -var gen = function* () { - var f1 = yield readFile('/etc/fstab'); - var f2 = yield readFile('/etc/shells'); +const gen = function* () { + const f1 = yield readFile('/etc/fstab'); + const f2 = yield readFile('/etc/shells'); console.log(f1.toString()); console.log(f2.toString()); }; ``` -写成`async`函数,就是下面这样。 +上面代码的函数`gen`可以写成`async`函数,就是下面这样。 ```javascript -var asyncReadFile = async function () { - var f1 = await readFile('/etc/fstab'); - var f2 = await readFile('/etc/shells'); +const asyncReadFile = async function () { + const f1 = await readFile('/etc/fstab'); + const f2 = await readFile('/etc/shells'); console.log(f1.toString()); console.log(f2.toString()); }; @@ -48,7 +48,7 @@ var asyncReadFile = async function () { Generator 函数的执行必须靠执行器,所以才有了`co`模块,而`async`函数自带执行器。也就是说,`async`函数的执行,与普通函数一模一样,只要一行。 ```javascript -var result = asyncReadFile(); +asyncReadFile(); ``` 上面的代码调用了`asyncReadFile`函数,然后它就会自动执行,输出最后结果。这完全不像 Generator 函数,需要调用`next`方法,或者用`co`模块,才能真正执行,得到最后结果。 @@ -59,7 +59,7 @@ var result = asyncReadFile(); (3)更广的适用性。 -`co`模块约定,`yield`命令后面只能是 Thunk 函数或 Promise 对象,而`async`函数的`await`命令后面,可以是Promise 对象和原始类型的值(数值、字符串和布尔值,但这时等同于同步操作)。 +`co`模块约定,`yield`命令后面只能是 Thunk 函数或 Promise 对象,而`async`函数的`await`命令后面,可以是 Promise 对象和原始类型的值(数值、字符串和布尔值,但这时会自动转成立即 resolved 的 Promise 对象)。 (4)返回值是 Promise。 @@ -67,9 +67,7 @@ var result = asyncReadFile(); 进一步说,`async`函数完全可以看作多个异步操作,包装成的一个 Promise 对象,而`await`命令就是内部`then`命令的语法糖。 -## 用法 - -### 基本用法 +## 基本用法 `async`函数返回一个 Promise 对象,可以使用`then`方法添加回调函数。当函数执行的时候,一旦遇到`await`就会先返回,等到异步操作完成,再接着执行函数体内后面的语句。 @@ -77,8 +75,8 @@ var result = asyncReadFile(); ```javascript async function getStockPriceByName(name) { - var symbol = await getStockSymbol(name); - var stockPrice = await getStockPrice(symbol); + const symbol = await getStockSymbol(name); + const stockPrice = await getStockPrice(symbol); return stockPrice; } @@ -100,13 +98,30 @@ function timeout(ms) { async function asyncPrint(value, ms) { await timeout(ms); - console.log(value) + console.log(value); } asyncPrint('hello world', 50); ``` -上面代码指定50毫秒以后,输出`hello world`。 +上面代码指定 50 毫秒以后,输出`hello world`。 + +由于`async`函数返回的是 Promise 对象,可以作为`await`命令的参数。所以,上面的例子也可以写成下面的形式。 + +```javascript +async function timeout(ms) { + await new Promise((resolve) => { + setTimeout(resolve, ms); + }); +} + +async function asyncPrint(value, ms) { + await timeout(ms); + console.log(value); +} + +asyncPrint('hello world', 50); +``` async 函数有多种使用形式。 @@ -195,10 +210,12 @@ getTitle('https://tc39.github.io/ecma262/').then(console.log) ### await 命令 -正常情况下,`await`命令后面是一个 Promise 对象。如果不是,会被转成一个立即`resolve`的 Promise 对象。 +正常情况下,`await`命令后面是一个 Promise 对象,返回该对象的结果。如果不是 Promise 对象,就直接返回对应的值。 ```javascript async function f() { + // 等同于 + // return 123; return await 123; } @@ -206,7 +223,31 @@ f().then(v => console.log(v)) // 123 ``` -上面代码中,`await`命令的参数是数值`123`,它被转成 Promise 对象,并立即`resolve`。 +上面代码中,`await`命令的参数是数值`123`,这时等同于`return 123`。 + +另一种情况是,`await`命令后面是一个`thenable`对象(即定义`then`方法的对象),那么`await`会将其等同于 Promise 对象。 + +```javascript +class Sleep { + constructor(timeout) { + this.timeout = timeout; + } + then(resolve, reject) { + const startTime = Date.now(); + setTimeout( + () => resolve(Date.now() - startTime), + this.timeout + ); + } +} + +(async () => { + const actualTime = await new Sleep(1000); + console.log(actualTime); +})(); +``` + +上面代码中,`await`命令后面是一个`Sleep`对象的实例。这个实例不是 Promise 对象,但是因为定义了`then`方法,`await`会将其视为`Promise`处理。 `await`命令后面的 Promise 对象如果变为`reject`状态,则`reject`的参数会被`catch`方法的回调函数接收到。 @@ -223,7 +264,7 @@ f() 注意,上面代码中,`await`语句前面没有`return`,但是`reject`方法的参数依然传入了`catch`方法的回调函数。这里如果在`await`前面加上`return`,效果是一样的。 -只要一个`await`语句后面的 Promise 变为`reject`,那么整个`async`函数都会中断执行。 +任何一个`await`语句后面的 Promise 对象变为`reject`状态,那么整个`async`函数都会中断执行。 ```javascript async function f() { @@ -303,9 +344,9 @@ async function f() { ```javascript async function main() { try { - var val1 = await firstStep(); - var val2 = await secondStep(val1); - var val3 = await thirdStep(val1, val2); + const val1 = await firstStep(); + const val2 = await secondStep(val1); + const val3 = await thirdStep(val1, val2); console.log('Final: ', val3); } @@ -315,6 +356,28 @@ async function main() { } ``` +下面的例子使用`try...catch`结构,实现多次重复尝试。 + +```javascript +const superagent = require('superagent'); +const NUM_RETRIES = 3; + +async function test() { + let i; + for (i = 0; i < NUM_RETRIES; ++i) { + try { + await superagent.get('http://google.com/this-throws-an-error'); + break; + } catch(err) {} + } + console.log(i); // 3 +} + +test(); +``` + +上面代码中,如果`await`操作成功,就会使用`break`语句退出循环;如果失败,会被`catch`语句捕捉,然后进入下一轮循环。 + ### 使用注意点 第一点,前面已经说过,`await`命令后面的`Promise`对象,运行结果可能是`rejected`,所以最好把`await`命令放在`try...catch`代码块中。 @@ -334,7 +397,7 @@ async function myFunction() { await somethingThatReturnsAPromise() .catch(function (err) { console.log(err); - }; + }); } ``` @@ -398,7 +461,7 @@ async function dbFuc(db) { } ``` -如果确实希望多个请求并发执行,可以使用`Promise.all`方法。 +如果确实希望多个请求并发执行,可以使用`Promise.all`方法。当三个请求都会`resolved`时,下面两种写法效果相同。 ```javascript async function dbFuc(db) { @@ -423,6 +486,45 @@ async function dbFuc(db) { } ``` +目前,[`esm`](https://www.npmjs.com/package/esm)模块加载器支持顶层`await`,即`await`命令可以不放在 async 函数里面,直接使用。 + +```javascript +// async 函数的写法 +const start = async () => { + const res = await fetch('google.com'); + return res.text(); +}; + +start().then(console.log); + +// 顶层 await 的写法 +const res = await fetch('google.com'); +console.log(await res.text()); +``` + +上面代码中,第二种写法的脚本必须使用`esm`加载器,才会生效。 + +第四点,async 函数可以保留运行堆栈。 + +```javascript +const a = () => { + b().then(() => c()); +}; +``` + +上面代码中,函数`a`内部运行了一个异步任务`b()`。当`b()`运行的时候,函数`a()`不会中断,而是继续执行。等到`b()`运行结束,可能`a()`早就运行结束了,`b()`所在的上下文环境已经消失了。如果`b()`或`c()`报错,错误堆栈将不包括`a()`。 + +现在将这个例子改成`async`函数。 + +```javascript +const a = async () => { + await b(); + c(); +}; +``` + +上面代码中,`b()`运行的时候,`a()`是暂停执行,上下文环境都保存着。一旦`b()`或`c()`报错,错误堆栈将包括`a()`。 + ## async 函数的实现原理 async 函数的实现原理,就是将 Generator 函数和自动执行器,包装在一个函数里。 @@ -448,10 +550,11 @@ function fn(args) { ```javascript function spawn(genF) { return new Promise(function(resolve, reject) { - var gen = genF(); + const gen = genF(); function step(nextF) { + let next; try { - var next = nextF(); + next = nextF(); } catch(e) { return reject(e); } @@ -481,13 +584,13 @@ function spawn(genF) { function chainAnimationsPromise(elem, animations) { // 变量ret用来保存上一个动画的返回值 - var ret = null; + let ret = null; // 新建一个空的Promise - var p = Promise.resolve(); + let p = Promise.resolve(); // 使用then方法,添加所有动画 - for(var anim of animations) { + for(let anim of animations) { p = p.then(function(val) { ret = val; return anim(elem); @@ -512,9 +615,9 @@ function chainAnimationsPromise(elem, animations) { function chainAnimationsGenerator(elem, animations) { return spawn(function*() { - var ret = null; + let ret = null; try { - for(var anim of animations) { + for(let anim of animations) { ret = yield anim(elem); } } catch(e) { @@ -532,9 +635,9 @@ function chainAnimationsGenerator(elem, animations) { ```javascript async function chainAnimationsAsync(elem, animations) { - var ret = null; + let ret = null; try { - for(var anim of animations) { + for(let anim of animations) { ret = await anim(elem); } } catch(e) { @@ -544,7 +647,7 @@ async function chainAnimationsAsync(elem, animations) { } ``` -可以看到Async函数的实现最简洁,最符合语义,几乎没有语义不相关的代码。它将Generator写法中的自动执行器,改在语言层面提供,不暴露给用户,因此代码量最少。如果使用Generator写法,自动执行器需要用户自己提供。 +可以看到 Async 函数的实现最简洁,最符合语义,几乎没有语义不相关的代码。它将 Generator 写法中的自动执行器,改在语言层面提供,不暴露给用户,因此代码量最少。如果使用 Generator 写法,自动执行器需要用户自己提供。 ## 实例:按顺序完成异步操作 @@ -580,7 +683,7 @@ async function logInOrder(urls) { } ``` -上面代码确实大大简化,问题是所有远程操作都是继发。只有前一个URL返回结果,才会去读取下一个URL,这样做效率很差,非常浪费时间。我们需要的是并发发出远程请求。 +上面代码确实大大简化,问题是所有远程操作都是继发。只有前一个 URL 返回结果,才会去读取下一个 URL,这样做效率很差,非常浪费时间。我们需要的是并发发出远程请求。 ```javascript async function logInOrder(urls) { @@ -605,7 +708,7 @@ async function logInOrder(urls) { 这里隐含着一个规定,`next`方法必须是同步的,只要调用就必须立刻返回值。也就是说,一旦执行`next`方法,就必须同步地得到`value`和`done`这两个属性。如果遍历指针正好指向同步操作,当然没有问题,但对于异步操作,就不太合适了。目前的解决方法是,Generator 函数里面的异步操作,返回一个 Thunk 函数或者 Promise 对象,即`value`属性是一个 Thunk 函数或者 Promise 对象,等待以后返回真正的值,而`done`属性则还是同步产生的。 -目前,有一个[提案](https://github.com/tc39/proposal-async-iteration),为异步操作提供原生的遍历器接口,即`value`和`done`这两个属性都是异步产生,这称为”异步遍历器“(Async Iterator)。 +ES2018 [引入](https://github.com/tc39/proposal-async-iteration)了“异步遍历器”(Async Iterator),为异步操作提供原生的遍历器接口,即`value`和`done`这两个属性都是异步产生。 ### 异步遍历的接口 @@ -663,12 +766,13 @@ async function f() { 上面代码中,`next`方法用`await`处理以后,就不必使用`then`方法了。整个流程已经很接近同步处理了。 -注意,异步遍历器的`next`方法是可以连续调用的,不必等到上一步产生的Promise对象`resolve`以后再调用。这种情况下,`next`方法会累积起来,自动按照每一步的顺序运行下去。下面是一个例子,把所有的`next`方法放在`Promise.all`方法里面。 +注意,异步遍历器的`next`方法是可以连续调用的,不必等到上一步产生的 Promise 对象`resolve`以后再调用。这种情况下,`next`方法会累积起来,自动按照每一步的顺序运行下去。下面是一个例子,把所有的`next`方法放在`Promise.all`方法里面。 ```javascript -const asyncGenObj = createAsyncIterable(['a', 'b']); +const asyncIterable = createAsyncIterable(['a', 'b']); +const asyncIterator = asyncIterable[Symbol.asyncIterator](); const [{value: v1}, {value: v2}] = await Promise.all([ - asyncGenObj.next(), asyncGenObj.next() + asyncIterator.next(), asyncIterator.next() ]); console.log(v1, v2); // a b @@ -677,10 +781,14 @@ console.log(v1, v2); // a b 另一种用法是一次性调用所有的`next`方法,然后`await`最后一步操作。 ```javascript -const writer = openFile('someFile.txt'); -writer.next('hello'); -writer.next('world'); -await writer.return(); +async function runner() { + const writer = openFile('someFile.txt'); + writer.next('hello'); + writer.next('world'); + await writer.return(); +} + +runner(); ``` ### for await...of @@ -697,20 +805,23 @@ async function f() { // b ``` -上面代码中,`createAsyncIterable()`返回一个异步遍历器,`for...of`循环自动调用这个遍历器的`next`方法,会得到一个Promise对象。`await`用来处理这个Promise对象,一旦`resolve`,就把得到的值(`x`)传入`for...of`的循环体。 +上面代码中,`createAsyncIterable()`返回一个拥有异步遍历器接口的对象,`for...of`循环自动调用这个对象的异步遍历器的`next`方法,会得到一个 Promise 对象。`await`用来处理这个 Promise 对象,一旦`resolve`,就把得到的值(`x`)传入`for...of`的循环体。 `for await...of`循环的一个用途,是部署了 asyncIterable 操作的异步接口,可以直接放入这个循环。 ```javascript let body = ''; -for await(const data of req) body += data; -const parsed = JSON.parse(body); -console.log('got', parsed); + +async function f() { + for await(const data of req) body += data; + const parsed = JSON.parse(body); + console.log('got', parsed); +} ``` 上面代码中,`req`是一个 asyncIterable 对象,用来异步读取数据。可以看到,使用`for await...of`循环以后,代码会非常简洁。 -如果`next`方法返回的Promise对象被`reject`,那么就要用`try...catch`捕捉。 +如果`next`方法返回的 Promise 对象被`reject`,`for await...of`就会报错,要用`try...catch`捕捉。 ```javascript async function () { @@ -736,12 +847,82 @@ async function () { // b ``` -### 异步Generator函数 +Node v10 支持异步遍历器,Stream 就部署了这个接口。下面是读取文件的传统写法与异步遍历器写法的差异。 + +```javascript +// 传统写法 +function main(inputFilePath) { + const readStream = fs.createReadStream( + inputFilePath, + { encoding: 'utf8', highWaterMark: 1024 } + ); + readStream.on('data', (chunk) => { + console.log('>>> '+chunk); + }); + readStream.on('end', () => { + console.log('### DONE ###'); + }); +} + +// 异步遍历器写法 +async function main(inputFilePath) { + const readStream = fs.createReadStream( + inputFilePath, + { encoding: 'utf8', highWaterMark: 1024 } + ); + + for await (const chunk of readStream) { + console.log('>>> '+chunk); + } + console.log('### DONE ###'); +} +``` + +### 异步 Generator 函数 就像 Generator 函数返回一个同步遍历器对象一样,异步 Generator 函数的作用,是返回一个异步遍历器对象。 在语法上,异步 Generator 函数就是`async`函数与 Generator 函数的结合。 +```javascript +async function* gen() { + yield 'hello'; +} +const genObj = gen(); +genObj.next().then(x => console.log(x)); +// { value: 'hello', done: false } +``` + +上面代码中,`gen`是一个异步 Generator 函数,执行后返回一个异步 Iterator 对象。对该对象调用`next`方法,返回一个 Promise 对象。 + +异步遍历器的设计目的之一,就是 Generator 函数处理同步操作和异步操作时,能够使用同一套接口。 + +```javascript +// 同步 Generator 函数 +function* map(iterable, func) { + const iter = iterable[Symbol.iterator](); + while (true) { + const {value, done} = iter.next(); + if (done) break; + yield func(value); + } +} + +// 异步 Generator 函数 +async function* map(iterable, func) { + const iter = iterable[Symbol.asyncIterator](); + while (true) { + const {value, done} = await iter.next(); + if (done) break; + yield func(value); + } +} +``` + +上面代码中,`map`是一个 Generator 函数,第一个参数是可遍历对象`iterable`,第二个参数是一个回调函数`func`。`map`的作用是将`iterable`每一步返回的值,使用`func`进行处理。上面有两个版本的`map`,前一个处理同步遍历器,后一个处理异步遍历器,可以看到两个版本的写法基本上是一致的。 + +下面是另一个异步 Generator 函数的例子。 + ```javascript async function* readLines(path) { let file = await fileOpen(path); @@ -756,14 +937,18 @@ async function* readLines(path) { } ``` -上面代码中,异步操作前面使用`await`关键字标明,即`await`后面的操作,应该返回Promise对象。凡是使用`yield`关键字的地方,就是`next`方法的停下来的地方,它后面的表达式的值(即`await file.readLine()`的值),会作为`next()`返回对象的`value`属性,这一点是于同步Generator函数一致的。 +上面代码中,异步操作前面使用`await`关键字标明,即`await`后面的操作,应该返回 Promise 对象。凡是使用`yield`关键字的地方,就是`next`方法停下来的地方,它后面的表达式的值(即`await file.readLine()`的值),会作为`next()`返回对象的`value`属性,这一点是与同步 Generator 函数一致的。 + +异步 Generator 函数内部,能够同时使用`await`和`yield`命令。可以这样理解,`await`命令用于将外部操作产生的值输入函数内部,`yield`命令用于将函数内部的值输出。 -可以像下面这样,使用上面代码定义的异步Generator函数。 +上面代码定义的异步 Generator 函数的用法如下。 ```javascript -for await (const line of readLines(filePath)) { - console.log(line); -} +(async function () { + for await (const line of readLines(filePath)) { + console.log(line); + } +})() ``` 异步 Generator 函数可以与`for await...of`循环结合起来使用。 @@ -776,20 +961,53 @@ async function* prefixLines(asyncIterable) { } ``` -`yield`命令依然是立刻返回的,但是返回的是一个Promise对象。 +异步 Generator 函数的返回值是一个异步 Iterator,即每次调用它的`next`方法,会返回一个 Promise 对象,也就是说,跟在`yield`命令后面的,应该是一个 Promise 对象。如果像上面那个例子那样,`yield`命令后面是一个字符串,会被自动包装成一个 Promise 对象。 ```javascript +function fetchRandom() { + const url = 'https://www.random.org/decimal-fractions/' + + '?num=1&dec=10&col=1&format=plain&rnd=new'; + return fetch(url); +} + async function* asyncGenerator() { console.log('Start'); - const result = await doSomethingAsync(); // (A) - yield 'Result: '+ result; // (B) + const result = await fetchRandom(); // (A) + yield 'Result: ' + await result.text(); // (B) console.log('Done'); } + +const ag = asyncGenerator(); +ag.next().then(({value, done}) => { + console.log(value); +}) ``` -上面代码中,调用`next`方法以后,会在`B`处暂停执行,`yield`命令立刻返回一个Promise对象。这个Promise对象不同于`A`处`await`命令后面的那个 Promise 对象。主要有两点不同,一是`A`处的Promise对象`resolve`以后产生的值,会放入`result`变量;二是`B`处的Promise对象`resolve`以后产生的值,是表达式`'Result: ' + result`的值;二是`A`处的 Promise 对象一定先于`B`处的 Promise 对象`resolve`。 +上面代码中,`ag`是`asyncGenerator`函数返回的异步遍历器对象。调用`ag.next()`以后,上面代码的执行顺序如下。 -如果异步 Generator 函数抛出错误,会被 Promise 对象`reject`,然后抛出的错误被`catch`方法捕获。 +1. `ag.next()`立刻返回一个 Promise 对象。 +1. `asyncGenerator`函数开始执行,打印出`Start`。 +1. `await`命令返回一个 Promise 对象,`asyncGenerator`函数停在这里。 +1. A 处变成 fulfilled 状态,产生的值放入`result`变量,`asyncGenerator`函数继续往下执行。 +1. 函数在 B 处的`yield`暂停执行,一旦`yield`命令取到值,`ag.next()`返回的那个 Promise 对象变成 fulfilled 状态。 +1. `ag.next()`后面的`then`方法指定的回调函数开始执行。该回调函数的参数是一个对象`{value, done}`,其中`value`的值是`yield`命令后面的那个表达式的值,`done`的值是`false`。 + +A 和 B 两行的作用类似于下面的代码。 + +```javascript +return new Promise((resolve, reject) => { + fetchRandom() + .then(result => result.text()) + .then(result => { + resolve({ + value: 'Result: ' + result, + done: false, + }); + }); +}); +``` + +如果异步 Generator 函数抛出错误,会导致 Promise 对象的状态变为`reject`,然后抛出的错误被`catch`方法捕获。 ```javascript async function* asyncGenerator() { @@ -801,14 +1019,14 @@ asyncGenerator() .catch(err => console.log(err)); // Error: Problem! ``` -注意,普通的 async 函数返回的是一个 Promise 对象,而异步 Generator 函数返回的是一个异步Iterator对象。基本上,可以这样理解,`async`函数和异步 Generator 函数,是封装异步操作的两种方法,都用来达到同一种目的。区别在于,前者自带执行器,后者通过`for await...of`执行,或者自己编写执行器。下面就是一个异步 Generator 函数的执行器。 +注意,普通的 async 函数返回的是一个 Promise 对象,而异步 Generator 函数返回的是一个异步 Iterator 对象。可以这样理解,async 函数和异步 Generator 函数,是封装异步操作的两种方法,都用来达到同一种目的。区别在于,前者自带执行器,后者通过`for await...of`执行,或者自己编写执行器。下面就是一个异步 Generator 函数的执行器。 ```javascript -async function takeAsync(asyncIterable, count=Infinity) { +async function takeAsync(asyncIterable, count = Infinity) { const result = []; const iterator = asyncIterable[Symbol.asyncIterator](); while (result.length < count) { - const {value,done} = await iterator.next(); + const {value, done} = await iterator.next(); if (done) break; result.push(value); } @@ -816,7 +1034,7 @@ async function takeAsync(asyncIterable, count=Infinity) { } ``` -上面代码中,异步Generator函数产生的异步遍历器,会通过`while`循环自动执行,每当`await iterator.next()`完成,就会进入下一轮循环。 +上面代码中,异步 Generator 函数产生的异步遍历器,会通过`while`循环自动执行,每当`await iterator.next()`完成,就会进入下一轮循环。一旦`done`属性变为`true`,就会跳出循环,异步遍历器执行结束。 下面是这个自动执行器的一个使用实例。 @@ -836,7 +1054,18 @@ f().then(function (result) { }) ``` -异步 Generator 函数出现以后,JavaScript就有了四种函数形式:普通函数、async 函数、Generator 函数和异步 Generator 函数。请注意区分每种函数的不同之处。 +异步 Generator 函数出现以后,JavaScript 就有了四种函数形式:普通函数、async 函数、Generator 函数和异步 Generator 函数。请注意区分每种函数的不同之处。基本上,如果是一系列按照顺序执行的异步操作(比如读取文件,然后写入新内容,再存入硬盘),可以使用 async 函数;如果是一系列产生相同数据结构的异步操作(比如一行一行读取文件),可以使用异步 Generator 函数。 + +异步 Generator 函数也可以通过`next`方法的参数,接收外部传入的数据。 + +```javascript +const writer = openFile('someFile.txt'); +writer.next('hello'); // 立即执行 +writer.next('world'); // 立即执行 +await writer.return(); // 等待写入结束 +``` + +上面代码中,`openFile`是一个异步 Generator 函数。`next`方法的参数,向该函数内部的操作传入数据。每次`next`方法都是同步执行的,最后的`await`命令用于等待整个写入操作结束。 最后,同步的数据结构,也可以使用异步 Generator 函数。 @@ -850,7 +1079,7 @@ async function* createAsyncIterable(syncIterable) { 上面代码中,由于没有异步操作,所以也就没有使用`await`关键字。 -### yield* 语句 +### yield\* 语句 `yield*`语句也可以跟一个异步遍历器。 @@ -862,13 +1091,14 @@ async function* gen1() { } async function* gen2() { + // result 最终会等于 2 const result = yield* gen1(); } ``` 上面代码中,`gen2`函数里面的`result`变量,最后的值是`2`。 -与同步Generator函数一样,`for await...of`循环会展开`yield*`。 +与同步 Generator 函数一样,`for await...of`循环会展开`yield*`。 ```javascript (async function () { @@ -879,4 +1109,3 @@ async function* gen2() { // a // b ``` - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/class-extends.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/class-extends.md" new file mode 100755 index 000000000..5d112c4a2 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/class-extends.md" @@ -0,0 +1,726 @@ +# Class 的继承 + +## 简介 + +Class 可以通过`extends`关键字实现继承,这比 ES5 的通过修改原型链实现继承,要清晰和方便很多。 + +```javascript +class Point { +} + +class ColorPoint extends Point { +} +``` + +上面代码定义了一个`ColorPoint`类,该类通过`extends`关键字,继承了`Point`类的所有属性和方法。但是由于没有部署任何代码,所以这两个类完全一样,等于复制了一个`Point`类。下面,我们在`ColorPoint`内部加上代码。 + +```javascript +class ColorPoint extends Point { + constructor(x, y, color) { + super(x, y); // 调用父类的constructor(x, y) + this.color = color; + } + + toString() { + return this.color + ' ' + super.toString(); // 调用父类的toString() + } +} +``` + +上面代码中,`constructor`方法和`toString`方法之中,都出现了`super`关键字,它在这里表示父类的构造函数,用来新建父类的`this`对象。 + +子类必须在`constructor`方法中调用`super`方法,否则新建实例时会报错。这是因为子类自己的`this`对象,必须先通过父类的构造函数完成塑造,得到与父类同样的实例属性和方法,然后再对其进行加工,加上子类自己的实例属性和方法。如果不调用`super`方法,子类就得不到`this`对象。 + +```javascript +class Point { /* ... */ } + +class ColorPoint extends Point { + constructor() { + } +} + +let cp = new ColorPoint(); // ReferenceError +``` + +上面代码中,`ColorPoint`继承了父类`Point`,但是它的构造函数没有调用`super`方法,导致新建实例时报错。 + +ES5 的继承,实质是先创造子类的实例对象`this`,然后再将父类的方法添加到`this`上面(`Parent.apply(this)`)。ES6 的继承机制完全不同,实质是先将父类实例对象的属性和方法,加到`this`上面(所以必须先调用`super`方法),然后再用子类的构造函数修改`this`。 + +如果子类没有定义`constructor`方法,这个方法会被默认添加,代码如下。也就是说,不管有没有显式定义,任何一个子类都有`constructor`方法。 + +```javascript +class ColorPoint extends Point { +} + +// 等同于 +class ColorPoint extends Point { + constructor(...args) { + super(...args); + } +} +``` + +另一个需要注意的地方是,在子类的构造函数中,只有调用`super`之后,才可以使用`this`关键字,否则会报错。这是因为子类实例的构建,基于父类实例,只有`super`方法才能调用父类实例。 + +```javascript +class Point { + constructor(x, y) { + this.x = x; + this.y = y; + } +} + +class ColorPoint extends Point { + constructor(x, y, color) { + this.color = color; // ReferenceError + super(x, y); + this.color = color; // 正确 + } +} +``` + +上面代码中,子类的`constructor`方法没有调用`super`之前,就使用`this`关键字,结果报错,而放在`super`方法之后就是正确的。 + +下面是生成子类实例的代码。 + +```javascript +let cp = new ColorPoint(25, 8, 'green'); + +cp instanceof ColorPoint // true +cp instanceof Point // true +``` + +上面代码中,实例对象`cp`同时是`ColorPoint`和`Point`两个类的实例,这与 ES5 的行为完全一致。 + +最后,父类的静态方法,也会被子类继承。 + +```javascript +class A { + static hello() { + console.log('hello world'); + } +} + +class B extends A { +} + +B.hello() // hello world +``` + +上面代码中,`hello()`是`A`类的静态方法,`B`继承`A`,也继承了`A`的静态方法。 + +## Object.getPrototypeOf() + +`Object.getPrototypeOf`方法可以用来从子类上获取父类。 + +```javascript +Object.getPrototypeOf(ColorPoint) === Point +// true +``` + +因此,可以使用这个方法判断,一个类是否继承了另一个类。 + +## super 关键字 + +`super`这个关键字,既可以当作函数使用,也可以当作对象使用。在这两种情况下,它的用法完全不同。 + +第一种情况,`super`作为函数调用时,代表父类的构造函数。ES6 要求,子类的构造函数必须执行一次`super`函数。 + +```javascript +class A {} + +class B extends A { + constructor() { + super(); + } +} +``` + +上面代码中,子类`B`的构造函数之中的`super()`,代表调用父类的构造函数。这是必须的,否则 JavaScript 引擎会报错。 + +注意,`super`虽然代表了父类`A`的构造函数,但是返回的是子类`B`的实例,即`super`内部的`this`指的是`B`的实例,因此`super()`在这里相当于`A.prototype.constructor.call(this)`。 + +```javascript +class A { + constructor() { + console.log(new.target.name); + } +} +class B extends A { + constructor() { + super(); + } +} +new A() // A +new B() // B +``` + +上面代码中,`new.target`指向当前正在执行的函数。可以看到,在`super()`执行时,它指向的是子类`B`的构造函数,而不是父类`A`的构造函数。也就是说,`super()`内部的`this`指向的是`B`。 + +作为函数时,`super()`只能用在子类的构造函数之中,用在其他地方就会报错。 + +```javascript +class A {} + +class B extends A { + m() { + super(); // 报错 + } +} +``` + +上面代码中,`super()`用在`B`类的`m`方法之中,就会造成句法错误。 + +第二种情况,`super`作为对象时,在普通方法中,指向父类的原型对象;在静态方法中,指向父类。 + +```javascript +class A { + p() { + return 2; + } +} + +class B extends A { + constructor() { + super(); + console.log(super.p()); // 2 + } +} + +let b = new B(); +``` + +上面代码中,子类`B`当中的`super.p()`,就是将`super`当作一个对象使用。这时,`super`在普通方法之中,指向`A.prototype`,所以`super.p()`就相当于`A.prototype.p()`。 + +这里需要注意,由于`super`指向父类的原型对象,所以定义在父类实例上的方法或属性,是无法通过`super`调用的。 + +```javascript +class A { + constructor() { + this.p = 2; + } +} + +class B extends A { + get m() { + return super.p; + } +} + +let b = new B(); +b.m // undefined +``` + +上面代码中,`p`是父类`A`实例的属性,`super.p`就引用不到它。 + +如果属性定义在父类的原型对象上,`super`就可以取到。 + +```javascript +class A {} +A.prototype.x = 2; + +class B extends A { + constructor() { + super(); + console.log(super.x) // 2 + } +} + +let b = new B(); +``` + +上面代码中,属性`x`是定义在`A.prototype`上面的,所以`super.x`可以取到它的值。 + +ES6 规定,在子类普通方法中通过`super`调用父类的方法时,方法内部的`this`指向当前的子类实例。 + +```javascript +class A { + constructor() { + this.x = 1; + } + print() { + console.log(this.x); + } +} + +class B extends A { + constructor() { + super(); + this.x = 2; + } + m() { + super.print(); + } +} + +let b = new B(); +b.m() // 2 +``` + +上面代码中,`super.print()`虽然调用的是`A.prototype.print()`,但是`A.prototype.print()`内部的`this`指向子类`B`的实例,导致输出的是`2`,而不是`1`。也就是说,实际上执行的是`super.print.call(this)`。 + +由于`this`指向子类实例,所以如果通过`super`对某个属性赋值,这时`super`就是`this`,赋值的属性会变成子类实例的属性。 + +```javascript +class A { + constructor() { + this.x = 1; + } +} + +class B extends A { + constructor() { + super(); + this.x = 2; + super.x = 3; + console.log(super.x); // undefined + console.log(this.x); // 3 + } +} + +let b = new B(); +``` + +上面代码中,`super.x`赋值为`3`,这时等同于对`this.x`赋值为`3`。而当读取`super.x`的时候,读的是`A.prototype.x`,所以返回`undefined`。 + +如果`super`作为对象,用在静态方法之中,这时`super`将指向父类,而不是父类的原型对象。 + +```javascript +class Parent { + static myMethod(msg) { + console.log('static', msg); + } + + myMethod(msg) { + console.log('instance', msg); + } +} + +class Child extends Parent { + static myMethod(msg) { + super.myMethod(msg); + } + + myMethod(msg) { + super.myMethod(msg); + } +} + +Child.myMethod(1); // static 1 + +var child = new Child(); +child.myMethod(2); // instance 2 +``` + +上面代码中,`super`在静态方法之中指向父类,在普通方法之中指向父类的原型对象。 + +另外,在子类的静态方法中通过`super`调用父类的方法时,方法内部的`this`指向当前的子类,而不是子类的实例。 + +```javascript +class A { + constructor() { + this.x = 1; + } + static print() { + console.log(this.x); + } +} + +class B extends A { + constructor() { + super(); + this.x = 2; + } + static m() { + super.print(); + } +} + +B.x = 3; +B.m() // 3 +``` + +上面代码中,静态方法`B.m`里面,`super.print`指向父类的静态方法。这个方法里面的`this`指向的是`B`,而不是`B`的实例。 + +注意,使用`super`的时候,必须显式指定是作为函数、还是作为对象使用,否则会报错。 + +```javascript +class A {} + +class B extends A { + constructor() { + super(); + console.log(super); // 报错 + } +} +``` + +上面代码中,`console.log(super)`当中的`super`,无法看出是作为函数使用,还是作为对象使用,所以 JavaScript 引擎解析代码的时候就会报错。这时,如果能清晰地表明`super`的数据类型,就不会报错。 + +```javascript +class A {} + +class B extends A { + constructor() { + super(); + console.log(super.valueOf() instanceof B); // true + } +} + +let b = new B(); +``` + +上面代码中,`super.valueOf()`表明`super`是一个对象,因此就不会报错。同时,由于`super`使得`this`指向`B`的实例,所以`super.valueOf()`返回的是一个`B`的实例。 + +最后,由于对象总是继承其他对象的,所以可以在任意一个对象中,使用`super`关键字。 + +```javascript +var obj = { + toString() { + return "MyObject: " + super.toString(); + } +}; + +obj.toString(); // MyObject: [object Object] +``` + +## 类的 prototype 属性和\_\_proto\_\_属性 + +大多数浏览器的 ES5 实现之中,每一个对象都有`__proto__`属性,指向对应的构造函数的`prototype`属性。Class 作为构造函数的语法糖,同时有`prototype`属性和`__proto__`属性,因此同时存在两条继承链。 + +(1)子类的`__proto__`属性,表示构造函数的继承,总是指向父类。 + +(2)子类`prototype`属性的`__proto__`属性,表示方法的继承,总是指向父类的`prototype`属性。 + +```javascript +class A { +} + +class B extends A { +} + +B.__proto__ === A // true +B.prototype.__proto__ === A.prototype // true +``` + +上面代码中,子类`B`的`__proto__`属性指向父类`A`,子类`B`的`prototype`属性的`__proto__`属性指向父类`A`的`prototype`属性。 + +这样的结果是因为,类的继承是按照下面的模式实现的。 + +```javascript +class A { +} + +class B { +} + +// B 的实例继承 A 的实例 +Object.setPrototypeOf(B.prototype, A.prototype); + +// B 继承 A 的静态属性 +Object.setPrototypeOf(B, A); + +const b = new B(); +``` + +《对象的扩展》一章给出过`Object.setPrototypeOf`方法的实现。 + +```javascript +Object.setPrototypeOf = function (obj, proto) { + obj.__proto__ = proto; + return obj; +} +``` + +因此,就得到了上面的结果。 + +```javascript +Object.setPrototypeOf(B.prototype, A.prototype); +// 等同于 +B.prototype.__proto__ = A.prototype; + +Object.setPrototypeOf(B, A); +// 等同于 +B.__proto__ = A; +``` + +这两条继承链,可以这样理解:作为一个对象,子类(`B`)的原型(`__proto__`属性)是父类(`A`);作为一个构造函数,子类(`B`)的原型对象(`prototype`属性)是父类的原型对象(`prototype`属性)的实例。 + +```javascript +Object.create(A.prototype); +// 等同于 +B.prototype.__proto__ = A.prototype; +``` + +`extends`关键字后面可以跟多种类型的值。 + +```javascript +class B extends A { +} +``` + +上面代码的`A`,只要是一个有`prototype`属性的函数,就能被`B`继承。由于函数都有`prototype`属性(除了`Function.prototype`函数),因此`A`可以是任意函数。 + +下面,讨论两种情况。第一种,子类继承`Object`类。 + +```javascript +class A extends Object { +} + +A.__proto__ === Object // true +A.prototype.__proto__ === Object.prototype // true +``` + +这种情况下,`A`其实就是构造函数`Object`的复制,`A`的实例就是`Object`的实例。 + +第二种情况,不存在任何继承。 + +```javascript +class A { +} + +A.__proto__ === Function.prototype // true +A.prototype.__proto__ === Object.prototype // true +``` + +这种情况下,`A`作为一个基类(即不存在任何继承),就是一个普通函数,所以直接继承`Function.prototype`。但是,`A`调用后返回一个空对象(即`Object`实例),所以`A.prototype.__proto__`指向构造函数(`Object`)的`prototype`属性。 + +### 实例的 \_\_proto\_\_ 属性 + +子类实例的`__proto__`属性的`__proto__`属性,指向父类实例的`__proto__`属性。也就是说,子类的原型的原型,是父类的原型。 + +```javascript +var p1 = new Point(2, 3); +var p2 = new ColorPoint(2, 3, 'red'); + +p2.__proto__ === p1.__proto__ // false +p2.__proto__.__proto__ === p1.__proto__ // true +``` + +上面代码中,`ColorPoint`继承了`Point`,导致前者原型的原型是后者的原型。 + +因此,通过子类实例的`__proto__.__proto__`属性,可以修改父类实例的行为。 + +```javascript +p2.__proto__.__proto__.printName = function () { + console.log('Ha'); +}; + +p1.printName() // "Ha" +``` + +上面代码在`ColorPoint`的实例`p2`上向`Point`类添加方法,结果影响到了`Point`的实例`p1`。 + +## 原生构造函数的继承 + +原生构造函数是指语言内置的构造函数,通常用来生成数据结构。ECMAScript 的原生构造函数大致有下面这些。 + +- Boolean() +- Number() +- String() +- Array() +- Date() +- Function() +- RegExp() +- Error() +- Object() + +以前,这些原生构造函数是无法继承的,比如,不能自己定义一个`Array`的子类。 + +```javascript +function MyArray() { + Array.apply(this, arguments); +} + +MyArray.prototype = Object.create(Array.prototype, { + constructor: { + value: MyArray, + writable: true, + configurable: true, + enumerable: true + } +}); +``` + +上面代码定义了一个继承 Array 的`MyArray`类。但是,这个类的行为与`Array`完全不一致。 + +```javascript +var colors = new MyArray(); +colors[0] = "red"; +colors.length // 0 + +colors.length = 0; +colors[0] // "red" +``` + +之所以会发生这种情况,是因为子类无法获得原生构造函数的内部属性,通过`Array.apply()`或者分配给原型对象都不行。原生构造函数会忽略`apply`方法传入的`this`,也就是说,原生构造函数的`this`无法绑定,导致拿不到内部属性。 + +ES5 是先新建子类的实例对象`this`,再将父类的属性添加到子类上,由于父类的内部属性无法获取,导致无法继承原生的构造函数。比如,`Array`构造函数有一个内部属性`[[DefineOwnProperty]]`,用来定义新属性时,更新`length`属性,这个内部属性无法在子类获取,导致子类的`length`属性行为不正常。 + +下面的例子中,我们想让一个普通对象继承`Error`对象。 + +```javascript +var e = {}; + +Object.getOwnPropertyNames(Error.call(e)) +// [ 'stack' ] + +Object.getOwnPropertyNames(e) +// [] +``` + +上面代码中,我们想通过`Error.call(e)`这种写法,让普通对象`e`具有`Error`对象的实例属性。但是,`Error.call()`完全忽略传入的第一个参数,而是返回一个新对象,`e`本身没有任何变化。这证明了`Error.call(e)`这种写法,无法继承原生构造函数。 + +ES6 允许继承原生构造函数定义子类,因为 ES6 是先新建父类的实例对象`this`,然后再用子类的构造函数修饰`this`,使得父类的所有行为都可以继承。下面是一个继承`Array`的例子。 + +```javascript +class MyArray extends Array { + constructor(...args) { + super(...args); + } +} + +var arr = new MyArray(); +arr[0] = 12; +arr.length // 1 + +arr.length = 0; +arr[0] // undefined +``` + +上面代码定义了一个`MyArray`类,继承了`Array`构造函数,因此就可以从`MyArray`生成数组的实例。这意味着,ES6 可以自定义原生数据结构(比如`Array`、`String`等)的子类,这是 ES5 无法做到的。 + +上面这个例子也说明,`extends`关键字不仅可以用来继承类,还可以用来继承原生的构造函数。因此可以在原生数据结构的基础上,定义自己的数据结构。下面就是定义了一个带版本功能的数组。 + +```javascript +class VersionedArray extends Array { + constructor() { + super(); + this.history = [[]]; + } + commit() { + this.history.push(this.slice()); + } + revert() { + this.splice(0, this.length, ...this.history[this.history.length - 1]); + } +} + +var x = new VersionedArray(); + +x.push(1); +x.push(2); +x // [1, 2] +x.history // [[]] + +x.commit(); +x.history // [[], [1, 2]] + +x.push(3); +x // [1, 2, 3] +x.history // [[], [1, 2]] + +x.revert(); +x // [1, 2] +``` + +上面代码中,`VersionedArray`会通过`commit`方法,将自己的当前状态生成一个版本快照,存入`history`属性。`revert`方法用来将数组重置为最新一次保存的版本。除此之外,`VersionedArray`依然是一个普通数组,所有原生的数组方法都可以在它上面调用。 + +下面是一个自定义`Error`子类的例子,可以用来定制报错时的行为。 + +```javascript +class ExtendableError extends Error { + constructor(message) { + super(); + this.message = message; + this.stack = (new Error()).stack; + this.name = this.constructor.name; + } +} + +class MyError extends ExtendableError { + constructor(m) { + super(m); + } +} + +var myerror = new MyError('ll'); +myerror.message // "ll" +myerror instanceof Error // true +myerror.name // "MyError" +myerror.stack +// Error +// at MyError.ExtendableError +// ... +``` + +注意,继承`Object`的子类,有一个[行为差异](http://stackoverflow.com/questions/36203614/super-does-not-pass-arguments-when-instantiating-a-class-extended-from-object)。 + +```javascript +class NewObj extends Object{ + constructor(){ + super(...arguments); + } +} +var o = new NewObj({attr: true}); +o.attr === true // false +``` + +上面代码中,`NewObj`继承了`Object`,但是无法通过`super`方法向父类`Object`传参。这是因为 ES6 改变了`Object`构造函数的行为,一旦发现`Object`方法不是通过`new Object()`这种形式调用,ES6 规定`Object`构造函数会忽略参数。 + +## Mixin 模式的实现 + +Mixin 指的是多个对象合成一个新的对象,新对象具有各个组成成员的接口。它的最简单实现如下。 + +```javascript +const a = { + a: 'a' +}; +const b = { + b: 'b' +}; +const c = {...a, ...b}; // {a: 'a', b: 'b'} +``` + +上面代码中,`c`对象是`a`对象和`b`对象的合成,具有两者的接口。 + +下面是一个更完备的实现,将多个类的接口“混入”(mix in)另一个类。 + +```javascript +function mix(...mixins) { + class Mix { + constructor() { + for (let mixin of mixins) { + copyProperties(this, new mixin()); // 拷贝实例属性 + } + } + } + + for (let mixin of mixins) { + copyProperties(Mix, mixin); // 拷贝静态属性 + copyProperties(Mix.prototype, mixin.prototype); // 拷贝原型属性 + } + + return Mix; +} + +function copyProperties(target, source) { + for (let key of Reflect.ownKeys(source)) { + if ( key !== 'constructor' + && key !== 'prototype' + && key !== 'name' + ) { + let desc = Object.getOwnPropertyDescriptor(source, key); + Object.defineProperty(target, key, desc); + } + } +} +``` + +上面代码的`mix`函数,可以将多个对象合成为一个类。使用的时候,只要继承这个类即可。 + +```javascript +class DistributedEdit extends mix(Loggable, Serializable) { + // ... +} +``` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/class.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/class.md" new file mode 100755 index 000000000..e31c31771 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/class.md" @@ -0,0 +1,1011 @@ +# Class 的基本语法 + +## 简介 + +### 类的由来 + +JavaScript 语言中,生成实例对象的传统方法是通过构造函数。下面是一个例子。 + +```javascript +function Point(x, y) { + this.x = x; + this.y = y; +} + +Point.prototype.toString = function () { + return '(' + this.x + ', ' + this.y + ')'; +}; + +var p = new Point(1, 2); +``` + +上面这种写法跟传统的面向对象语言(比如 C++ 和 Java)差异很大,很容易让新学习这门语言的程序员感到困惑。 + +ES6 提供了更接近传统语言的写法,引入了 Class(类)这个概念,作为对象的模板。通过`class`关键字,可以定义类。 + +基本上,ES6 的`class`可以看作只是一个语法糖,它的绝大部分功能,ES5 都可以做到,新的`class`写法只是让对象原型的写法更加清晰、更像面向对象编程的语法而已。上面的代码用 ES6 的`class`改写,就是下面这样。 + +```javascript +class Point { + constructor(x, y) { + this.x = x; + this.y = y; + } + + toString() { + return '(' + this.x + ', ' + this.y + ')'; + } +} +``` + +上面代码定义了一个“类”,可以看到里面有一个`constructor`方法,这就是构造方法,而`this`关键字则代表实例对象。也就是说,ES5 的构造函数`Point`,对应 ES6 的`Point`类的构造方法。 + +`Point`类除了构造方法,还定义了一个`toString`方法。注意,定义“类”的方法的时候,前面不需要加上`function`这个关键字,直接把函数定义放进去了就可以了。另外,方法之间不需要逗号分隔,加了会报错。 + +ES6 的类,完全可以看作构造函数的另一种写法。 + +```javascript +class Point { + // ... +} + +typeof Point // "function" +Point === Point.prototype.constructor // true +``` + +上面代码表明,类的数据类型就是函数,类本身就指向构造函数。 + +使用的时候,也是直接对类使用`new`命令,跟构造函数的用法完全一致。 + +```javascript +class Bar { + doStuff() { + console.log('stuff'); + } +} + +var b = new Bar(); +b.doStuff() // "stuff" +``` + +构造函数的`prototype`属性,在 ES6 的“类”上面继续存在。事实上,类的所有方法都定义在类的`prototype`属性上面。 + +```javascript +class Point { + constructor() { + // ... + } + + toString() { + // ... + } + + toValue() { + // ... + } +} + +// 等同于 + +Point.prototype = { + constructor() {}, + toString() {}, + toValue() {}, +}; +``` + +在类的实例上面调用方法,其实就是调用原型上的方法。 + +```javascript +class B {} +let b = new B(); + +b.constructor === B.prototype.constructor // true +``` + +上面代码中,`b`是`B`类的实例,它的`constructor`方法就是`B`类原型的`constructor`方法。 + +由于类的方法都定义在`prototype`对象上面,所以类的新方法可以添加在`prototype`对象上面。`Object.assign`方法可以很方便地一次向类添加多个方法。 + +```javascript +class Point { + constructor(){ + // ... + } +} + +Object.assign(Point.prototype, { + toString(){}, + toValue(){} +}); +``` + +`prototype`对象的`constructor`属性,直接指向“类”的本身,这与 ES5 的行为是一致的。 + +```javascript +Point.prototype.constructor === Point // true +``` + +另外,类的内部所有定义的方法,都是不可枚举的(non-enumerable)。 + +```javascript +class Point { + constructor(x, y) { + // ... + } + + toString() { + // ... + } +} + +Object.keys(Point.prototype) +// [] +Object.getOwnPropertyNames(Point.prototype) +// ["constructor","toString"] +``` + +上面代码中,`toString`方法是`Point`类内部定义的方法,它是不可枚举的。这一点与 ES5 的行为不一致。 + +```javascript +var Point = function (x, y) { + // ... +}; + +Point.prototype.toString = function() { + // ... +}; + +Object.keys(Point.prototype) +// ["toString"] +Object.getOwnPropertyNames(Point.prototype) +// ["constructor","toString"] +``` + +上面代码采用 ES5 的写法,`toString`方法就是可枚举的。 + +### constructor 方法 + +`constructor`方法是类的默认方法,通过`new`命令生成对象实例时,自动调用该方法。一个类必须有`constructor`方法,如果没有显式定义,一个空的`constructor`方法会被默认添加。 + +```javascript +class Point { +} + +// 等同于 +class Point { + constructor() {} +} +``` + +上面代码中,定义了一个空的类`Point`,JavaScript 引擎会自动为它添加一个空的`constructor`方法。 + +`constructor`方法默认返回实例对象(即`this`),完全可以指定返回另外一个对象。 + +```javascript +class Foo { + constructor() { + return Object.create(null); + } +} + +new Foo() instanceof Foo +// false +``` + +上面代码中,`constructor`函数返回一个全新的对象,结果导致实例对象不是`Foo`类的实例。 + +类必须使用`new`调用,否则会报错。这是它跟普通构造函数的一个主要区别,后者不用`new`也可以执行。 + +```javascript +class Foo { + constructor() { + return Object.create(null); + } +} + +Foo() +// TypeError: Class constructor Foo cannot be invoked without 'new' +``` + +### 类的实例 + +生成类的实例的写法,与 ES5 完全一样,也是使用`new`命令。前面说过,如果忘记加上`new`,像函数那样调用`Class`,将会报错。 + +```javascript +class Point { + // ... +} + +// 报错 +var point = Point(2, 3); + +// 正确 +var point = new Point(2, 3); +``` + +与 ES5 一样,实例的属性除非显式定义在其本身(即定义在`this`对象上),否则都是定义在原型上(即定义在`class`上)。 + +```javascript +//定义类 +class Point { + + constructor(x, y) { + this.x = x; + this.y = y; + } + + toString() { + return '(' + this.x + ', ' + this.y + ')'; + } + +} + +var point = new Point(2, 3); + +point.toString() // (2, 3) + +point.hasOwnProperty('x') // true +point.hasOwnProperty('y') // true +point.hasOwnProperty('toString') // false +point.__proto__.hasOwnProperty('toString') // true +``` + +上面代码中,`x`和`y`都是实例对象`point`自身的属性(因为定义在`this`变量上),所以`hasOwnProperty`方法返回`true`,而`toString`是原型对象的属性(因为定义在`Point`类上),所以`hasOwnProperty`方法返回`false`。这些都与 ES5 的行为保持一致。 + +与 ES5 一样,类的所有实例共享一个原型对象。 + +```javascript +var p1 = new Point(2,3); +var p2 = new Point(3,2); + +p1.__proto__ === p2.__proto__ +//true +``` + +上面代码中,`p1`和`p2`都是`Point`的实例,它们的原型都是`Point.prototype`,所以`__proto__`属性是相等的。 + +这也意味着,可以通过实例的`__proto__`属性为“类”添加方法。 + +> `__proto__` 并不是语言本身的特性,这是各大厂商具体实现时添加的私有属性,虽然目前很多现代浏览器的 JS 引擎中都提供了这个私有属性,但依旧不建议在生产中使用该属性,避免对环境产生依赖。生产环境中,我们可以使用 `Object.getPrototypeOf` 方法来获取实例对象的原型,然后再来为原型添加方法/属性。 + +```javascript +var p1 = new Point(2,3); +var p2 = new Point(3,2); + +p1.__proto__.printName = function () { return 'Oops' }; + +p1.printName() // "Oops" +p2.printName() // "Oops" + +var p3 = new Point(4,2); +p3.printName() // "Oops" +``` + +上面代码在`p1`的原型上添加了一个`printName`方法,由于`p1`的原型就是`p2`的原型,因此`p2`也可以调用这个方法。而且,此后新建的实例`p3`也可以调用这个方法。这意味着,使用实例的`__proto__`属性改写原型,必须相当谨慎,不推荐使用,因为这会改变“类”的原始定义,影响到所有实例。 + +### 取值函数(getter)和存值函数(setter) + +与 ES5 一样,在“类”的内部可以使用`get`和`set`关键字,对某个属性设置存值函数和取值函数,拦截该属性的存取行为。 + +```javascript +class MyClass { + constructor() { + // ... + } + get prop() { + return 'getter'; + } + set prop(value) { + console.log('setter: '+value); + } +} + +let inst = new MyClass(); + +inst.prop = 123; +// setter: 123 + +inst.prop +// 'getter' +``` + +上面代码中,`prop`属性有对应的存值函数和取值函数,因此赋值和读取行为都被自定义了。 + +存值函数和取值函数是设置在属性的 Descriptor 对象上的。 + +```javascript +class CustomHTMLElement { + constructor(element) { + this.element = element; + } + + get html() { + return this.element.innerHTML; + } + + set html(value) { + this.element.innerHTML = value; + } +} + +var descriptor = Object.getOwnPropertyDescriptor( + CustomHTMLElement.prototype, "html" +); + +"get" in descriptor // true +"set" in descriptor // true +``` + +上面代码中,存值函数和取值函数是定义在`html`属性的描述对象上面,这与 ES5 完全一致。 + +### 属性表达式 + +类的属性名,可以采用表达式。 + +```javascript +let methodName = 'getArea'; + +class Square { + constructor(length) { + // ... + } + + [methodName]() { + // ... + } +} +``` + +上面代码中,`Square`类的方法名`getArea`,是从表达式得到的。 + +### Class 表达式 + +与函数一样,类也可以使用表达式的形式定义。 + +```javascript +const MyClass = class Me { + getClassName() { + return Me.name; + } +}; +``` + +上面代码使用表达式定义了一个类。需要注意的是,这个类的名字是`Me`,但是`Me`只在 Class 的内部可用,指代当前类。在 Class 外部,这个类只能用`MyClass`引用。 + +```javascript +let inst = new MyClass(); +inst.getClassName() // Me +Me.name // ReferenceError: Me is not defined +``` + +上面代码表示,`Me`只在 Class 内部有定义。 + +如果类的内部没用到的话,可以省略`Me`,也就是可以写成下面的形式。 + +```javascript +const MyClass = class { /* ... */ }; +``` + +采用 Class 表达式,可以写出立即执行的 Class。 + +```javascript +let person = new class { + constructor(name) { + this.name = name; + } + + sayName() { + console.log(this.name); + } +}('张三'); + +person.sayName(); // "张三" +``` + +上面代码中,`person`是一个立即执行的类的实例。 + +### 注意点 + +**(1)严格模式** + +类和模块的内部,默认就是严格模式,所以不需要使用`use strict`指定运行模式。只要你的代码写在类或模块之中,就只有严格模式可用。考虑到未来所有的代码,其实都是运行在模块之中,所以 ES6 实际上把整个语言升级到了严格模式。 + +**(2)不存在提升** + +类不存在变量提升(hoist),这一点与 ES5 完全不同。 + +```javascript +new Foo(); // ReferenceError +class Foo {} +``` + +上面代码中,`Foo`类使用在前,定义在后,这样会报错,因为 ES6 不会把类的声明提升到代码头部。这种规定的原因与下文要提到的继承有关,必须保证子类在父类之后定义。 + +```javascript +{ + let Foo = class {}; + class Bar extends Foo { + } +} +``` + +上面的代码不会报错,因为`Bar`继承`Foo`的时候,`Foo`已经有定义了。但是,如果存在`class`的提升,上面代码就会报错,因为`class`会被提升到代码头部,而`let`命令是不提升的,所以导致`Bar`继承`Foo`的时候,`Foo`还没有定义。 + +**(3)name 属性** + +由于本质上,ES6 的类只是 ES5 的构造函数的一层包装,所以函数的许多特性都被`Class`继承,包括`name`属性。 + +```javascript +class Point {} +Point.name // "Point" +``` + +`name`属性总是返回紧跟在`class`关键字后面的类名。 + +**(4)Generator 方法** + +如果某个方法之前加上星号(`*`),就表示该方法是一个 Generator 函数。 + +```javascript +class Foo { + constructor(...args) { + this.args = args; + } + * [Symbol.iterator]() { + for (let arg of this.args) { + yield arg; + } + } +} + +for (let x of new Foo('hello', 'world')) { + console.log(x); +} +// hello +// world +``` + +上面代码中,`Foo`类的`Symbol.iterator`方法前有一个星号,表示该方法是一个 Generator 函数。`Symbol.iterator`方法返回一个`Foo`类的默认遍历器,`for...of`循环会自动调用这个遍历器。 + +**(5)this 的指向** + +类的方法内部如果含有`this`,它默认指向类的实例。但是,必须非常小心,一旦单独使用该方法,很可能报错。 + +```javascript +class Logger { + printName(name = 'there') { + this.print(`Hello ${name}`); + } + + print(text) { + console.log(text); + } +} + +const logger = new Logger(); +const { printName } = logger; +printName(); // TypeError: Cannot read property 'print' of undefined +``` + +上面代码中,`printName`方法中的`this`,默认指向`Logger`类的实例。但是,如果将这个方法提取出来单独使用,`this`会指向该方法运行时所在的环境(由于 class 内部是严格模式,所以 this 实际指向的是`undefined`),从而导致找不到`print`方法而报错。 + +一个比较简单的解决方法是,在构造方法中绑定`this`,这样就不会找不到`print`方法了。 + +```javascript +class Logger { + constructor() { + this.printName = this.printName.bind(this); + } + + // ... +} +``` + +另一种解决方法是使用箭头函数。 + +```javascript +class Logger { + constructor() { + this.printName = (name = 'there') => { + this.print(`Hello ${name}`); + }; + } + + // ... +} +``` + +还有一种解决方法是使用`Proxy`,获取方法的时候,自动绑定`this`。 + +```javascript +function selfish (target) { + const cache = new WeakMap(); + const handler = { + get (target, key) { + const value = Reflect.get(target, key); + if (typeof value !== 'function') { + return value; + } + if (!cache.has(value)) { + cache.set(value, value.bind(target)); + } + return cache.get(value); + } + }; + const proxy = new Proxy(target, handler); + return proxy; +} + +const logger = selfish(new Logger()); +``` + +## 静态方法 + +类相当于实例的原型,所有在类中定义的方法,都会被实例继承。如果在一个方法前,加上`static`关键字,就表示该方法不会被实例继承,而是直接通过类来调用,这就称为“静态方法”。 + +```javascript +class Foo { + static classMethod() { + return 'hello'; + } +} + +Foo.classMethod() // 'hello' + +var foo = new Foo(); +foo.classMethod() +// TypeError: foo.classMethod is not a function +``` + +上面代码中,`Foo`类的`classMethod`方法前有`static`关键字,表明该方法是一个静态方法,可以直接在`Foo`类上调用(`Foo.classMethod()`),而不是在`Foo`类的实例上调用。如果在实例上调用静态方法,会抛出一个错误,表示不存在该方法。 + +注意,如果静态方法包含`this`关键字,这个`this`指的是类,而不是实例。 + +```javascript +class Foo { + static bar() { + this.baz(); + } + static baz() { + console.log('hello'); + } + baz() { + console.log('world'); + } +} + +Foo.bar() // hello +``` + +上面代码中,静态方法`bar`调用了`this.baz`,这里的`this`指的是`Foo`类,而不是`Foo`的实例,等同于调用`Foo.baz`。另外,从这个例子还可以看出,静态方法可以与非静态方法重名。 + +父类的静态方法,可以被子类继承。 + +```javascript +class Foo { + static classMethod() { + return 'hello'; + } +} + +class Bar extends Foo { +} + +Bar.classMethod() // 'hello' +``` + +上面代码中,父类`Foo`有一个静态方法,子类`Bar`可以调用这个方法。 + +静态方法也是可以从`super`对象上调用的。 + +```javascript +class Foo { + static classMethod() { + return 'hello'; + } +} + +class Bar extends Foo { + static classMethod() { + return super.classMethod() + ', too'; + } +} + +Bar.classMethod() // "hello, too" +``` + +## 实例属性的新写法 + +实例属性除了定义在`constructor()`方法里面的`this`上面,也可以定义在类的最顶层。 + +```javascript +class IncreasingCounter { + constructor() { + this._count = 0; + } + get value() { + console.log('Getting the current value!'); + return this._count; + } + increment() { + this._count++; + } +} +``` + +上面代码中,实例属性`this._count`定义在`constructor()`方法里面。另一种写法是,这个属性也可以定义在类的最顶层,其他都不变。 + +```javascript +class IncreasingCounter { + _count = 0; + get value() { + console.log('Getting the current value!'); + return this._count; + } + increment() { + this._count++; + } +} +``` + +上面代码中,实例属性`_count`与取值函数`value()`和`increment()`方法,处于同一个层级。这时,不需要在实例属性前面加上`this`。 + +这种新写法的好处是,所有实例对象自身的属性都定义在类的头部,看上去比较整齐,一眼就能看出这个类有哪些实例属性。 + +```javascript +class foo { + bar = 'hello'; + baz = 'world'; + + constructor() { + // ... + } +} +``` + +上面的代码,一眼就能看出,`foo`类有两个实例属性,一目了然。另外,写起来也比较简洁。 + +## 静态属性 + +静态属性指的是 Class 本身的属性,即`Class.propName`,而不是定义在实例对象(`this`)上的属性。 + +```javascript +class Foo { +} + +Foo.prop = 1; +Foo.prop // 1 +``` + +上面的写法为`Foo`类定义了一个静态属性`prop`。 + +目前,只有这种写法可行,因为 ES6 明确规定,Class 内部只有静态方法,没有静态属性。现在有一个[提案](https://github.com/tc39/proposal-class-fields)提供了类的静态属性,写法是在实例属性法的前面,加上`static`关键字。 + +```javascript +class MyClass { + static myStaticProp = 42; + + constructor() { + console.log(MyClass.myStaticProp); // 42 + } +} +``` + +这个新写法大大方便了静态属性的表达。 + +```javascript +// 老写法 +class Foo { + // ... +} +Foo.prop = 1; + +// 新写法 +class Foo { + static prop = 1; +} +``` + +上面代码中,老写法的静态属性定义在类的外部。整个类生成以后,再生成静态属性。这样让人很容易忽略这个静态属性,也不符合相关代码应该放在一起的代码组织原则。另外,新写法是显式声明(declarative),而不是赋值处理,语义更好。 + +## 私有方法和私有属性 + +### 现有的解决方案 + +私有方法和私有属性,是只能在类的内部访问的方法和属性,外部不能访问。这是常见需求,有利于代码的封装,但 ES6 不提供,只能通过变通方法模拟实现。 + +一种做法是在命名上加以区别。 + +```javascript +class Widget { + + // 公有方法 + foo (baz) { + this._bar(baz); + } + + // 私有方法 + _bar(baz) { + return this.snaf = baz; + } + + // ... +} +``` + +上面代码中,`_bar`方法前面的下划线,表示这是一个只限于内部使用的私有方法。但是,这种命名是不保险的,在类的外部,还是可以调用到这个方法。 + +另一种方法就是索性将私有方法移出模块,因为模块内部的所有方法都是对外可见的。 + +```javascript +class Widget { + foo (baz) { + bar.call(this, baz); + } + + // ... +} + +function bar(baz) { + return this.snaf = baz; +} +``` + +上面代码中,`foo`是公开方法,内部调用了`bar.call(this, baz)`。这使得`bar`实际上成为了当前模块的私有方法。 + +还有一种方法是利用`Symbol`值的唯一性,将私有方法的名字命名为一个`Symbol`值。 + +```javascript +const bar = Symbol('bar'); +const snaf = Symbol('snaf'); + +export default class myClass{ + + // 公有方法 + foo(baz) { + this[bar](baz); + } + + // 私有方法 + [bar](baz) { + return this[snaf] = baz; + } + + // ... +}; +``` + +上面代码中,`bar`和`snaf`都是`Symbol`值,一般情况下无法获取到它们,因此达到了私有方法和私有属性的效果。但是也不是绝对不行,`Reflect.ownKeys()`依然可以拿到它们。 + +```javascript +const inst = new myClass(); + +Reflect.ownKeys(myClass.prototype) +// [ 'constructor', 'foo', Symbol(bar) ] +``` + +上面代码中,Symbol 值的属性名依然可以从类的外部拿到。 + +### 私有属性的提案 + +目前,有一个[提案](https://github.com/tc39/proposal-private-methods),为`class`加了私有属性。方法是在属性名之前,使用`#`表示。 + +```javascript +class IncreasingCounter { + #count = 0; + get value() { + console.log('Getting the current value!'); + return this.#count; + } + increment() { + this.#count++; + } +} +``` + +上面代码中,`#count`就是私有属性,只能在类的内部使用(`this.#count`)。如果在类的外部使用,就会报错。 + +```javascript +const counter = new IncreasingCounter(); +counter.#count // 报错 +counter.#count = 42 // 报错 +``` + +上面代码在类的外部,读取私有属性,就会报错。 + +下面是另一个例子。 + +```javascript +class Point { + #x; + + constructor(x = 0) { + this.#x = +x; + } + + get x() { + return this.#x; + } + + set x(value) { + this.#x = +value; + } +} +``` + +上面代码中,`#x`就是私有属性,在`Point`类之外是读取不到这个属性的。由于井号`#`是属性名的一部分,使用时必须带有`#`一起使用,所以`#x`和`x`是两个不同的属性。 + +之所以要引入一个新的前缀`#`表示私有属性,而没有采用`private`关键字,是因为 JavaScript 是一门动态语言,没有类型声明,使用独立的符号似乎是唯一的比较方便可靠的方法,能够准确地区分一种属性是否为私有属性。另外,Ruby 语言使用`@`表示私有属性,ES6 没有用这个符号而使用`#`,是因为`@`已经被留给了 Decorator。 + +这种写法不仅可以写私有属性,还可以用来写私有方法。 + +```javascript +class Foo { + #a; + #b; + constructor(a, b) { + this.#a = a; + this.#b = b; + } + #sum() { + return #a + #b; + } + printSum() { + console.log(this.#sum()); + } +} +``` + +上面代码中,`#sum()`就是一个私有方法。 + +另外,私有属性也可以设置 getter 和 setter 方法。 + +```javascript +class Counter { + #xValue = 0; + + constructor() { + super(); + // ... + } + + get #x() { return #xValue; } + set #x(value) { + this.#xValue = value; + } +} +``` + +上面代码中,`#x`是一个私有属性,它的读写都通过`get #x()`和`set #x()`来完成。 + +私有属性不限于从`this`引用,只要是在类的内部,实例也可以引用私有属性。 + +```javascript +class Foo { + #privateValue = 42; + static getPrivateValue(foo) { + return foo.#privateValue; + } +} + +Foo.getPrivateValue(new Foo()); // 42 +``` + +上面代码允许从实例`foo`上面引用私有属性。 + +私有属性和私有方法前面,也可以加上`static`关键字,表示这是一个静态的私有属性或私有方法。 + +```javascript +class FakeMath { + static PI = 22 / 7; + static #totallyRandomNumber = 4; + + static #computeRandomNumber() { + return FakeMath.#totallyRandomNumber; + } + + static random() { + console.log('I heard you like random numbers…') + return FakeMath.#computeRandomNumber(); + } +} + +FakeMath.PI // 3.142857142857143 +FakeMath.random() +// I heard you like random numbers… +// 4 +FakeMath.#totallyRandomNumber // 报错 +FakeMath.#computeRandomNumber() // 报错 +``` + +上面代码中,`#totallyRandomNumber`是私有属性,`#computeRandomNumber()`是私有方法,只能在`FakeMath`这个类的内部调用,外部调用就会报错。 + +## new.target 属性 + +`new`是从构造函数生成实例对象的命令。ES6 为`new`命令引入了一个`new.target`属性,该属性一般用在构造函数之中,返回`new`命令作用于的那个构造函数。如果构造函数不是通过`new`命令或`Reflect.construct()`调用的,`new.target`会返回`undefined`,因此这个属性可以用来确定构造函数是怎么调用的。 + +```javascript +function Person(name) { + if (new.target !== undefined) { + this.name = name; + } else { + throw new Error('必须使用 new 命令生成实例'); + } +} + +// 另一种写法 +function Person(name) { + if (new.target === Person) { + this.name = name; + } else { + throw new Error('必须使用 new 命令生成实例'); + } +} + +var person = new Person('张三'); // 正确 +var notAPerson = Person.call(person, '张三'); // 报错 +``` + +上面代码确保构造函数只能通过`new`命令调用。 + +Class 内部调用`new.target`,返回当前 Class。 + +```javascript +class Rectangle { + constructor(length, width) { + console.log(new.target === Rectangle); + this.length = length; + this.width = width; + } +} + +var obj = new Rectangle(3, 4); // 输出 true +``` + +需要注意的是,子类继承父类时,`new.target`会返回子类。 + +```javascript +class Rectangle { + constructor(length, width) { + console.log(new.target === Rectangle); + // ... + } +} + +class Square extends Rectangle { + constructor(length) { + super(length, width); + } +} + +var obj = new Square(3); // 输出 false +``` + +上面代码中,`new.target`会返回子类。 + +利用这个特点,可以写出不能独立使用、必须继承后才能使用的类。 + +```javascript +class Shape { + constructor() { + if (new.target === Shape) { + throw new Error('本类不能实例化'); + } + } +} + +class Rectangle extends Shape { + constructor(length, width) { + super(); + // ... + } +} + +var x = new Shape(); // 报错 +var y = new Rectangle(3, 4); // 正确 +``` + +上面代码中,`Shape`类不能被实例化,只能用于继承。 + +注意,在函数外部,使用`new.target`会报错。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/decorator.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/decorator.md" old mode 100644 new mode 100755 similarity index 69% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/decorator.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/decorator.md" index 690370f38..8e647bb0d --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/decorator.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/decorator.md" @@ -1,23 +1,25 @@ # 修饰器 -## 类的修饰 +[说明] Decorator 提案经过了大幅修改,目前还没有定案,不知道语法会不会再变。下面的内容完全依据以前的提案,已经有点过时了。等待定案以后,需要完全重写。 -修饰器(Decorator)是一个函数,用来修改类的行为。这是ES7的一个[提案](https://github.com/wycats/javascript-decorators),目前Babel转码器已经支持。 +## 类的修饰 -修饰器对类的行为的改变,是代码编译时发生的,而不是在运行时。这意味着,修饰器能在编译阶段运行代码。 +许多面向对象的语言都有修饰器(Decorator)函数,用来修改类的行为。目前,有一个[提案](https://github.com/tc39/proposal-decorators)将这项功能,引入了 ECMAScript。 ```javascript +@testable +class MyTestableClass { + // ... +} + function testable(target) { target.isTestable = true; } -@testable -class MyTestableClass {} - -console.log(MyTestableClass.isTestable) // true +MyTestableClass.isTestable // true ``` -上面代码中,`@testable`就是一个修饰器。它修改了`MyTestableClass`这个类的行为,为它加上了静态属性`isTestable`。 +上面代码中,`@testable`就是一个修饰器。它修改了`MyTestableClass`这个类的行为,为它加上了静态属性`isTestable`。`testable`函数的参数`target`是`MyTestableClass`类本身。 基本上,修饰器的行为就是下面这样。 @@ -31,9 +33,7 @@ class A {} A = decorator(A) || A; ``` -也就是说,修饰器本质就是编译时执行的函数。 - -修饰器函数的第一个参数,就是所要修饰的目标类。 +也就是说,修饰器是一个对类进行处理的函数。修饰器函数的第一个参数,就是所要修饰的目标类。 ```javascript function testable(target) { @@ -63,6 +63,8 @@ MyClass.isTestable // false 上面代码中,修饰器`testable`可以接受参数,这就等于可以修改修饰器的行为。 +注意,修饰器对类的行为的改变,是代码编译时发生的,而不是在运行时。这意味着,修饰器能在编译阶段运行代码。也就是说,修饰器本质就是编译时执行的函数。 + 前面的例子是为类添加一个静态属性,如果想添加实例属性,可以通过目标类的`prototype`对象操作。 ```javascript @@ -103,7 +105,7 @@ let obj = new MyClass(); obj.foo() // 'foo' ``` -上面代码通过修饰器`mixins`,把`Foo`类的方法添加到了`MyClass`的实例上面。可以用`Object.assign()`模拟这个功能。 +上面代码通过修饰器`mixins`,把`Foo`对象的方法添加到了`MyClass`的实例上面。可以用`Object.assign()`模拟这个功能。 ```javascript const Foo = { @@ -118,6 +120,23 @@ let obj = new MyClass(); obj.foo() // 'foo' ``` +实际开发中,React 与 Redux 库结合使用时,常常需要写成下面这样。 + +```javascript +class MyReactComponent extends React.Component {} + +export default connect(mapStateToProps, mapDispatchToProps)(MyReactComponent); +``` + +有了装饰器,就可以改写上面的代码。 + +```javascript +@connect(mapStateToProps, mapDispatchToProps) +export default class MyReactComponent extends React.Component {} +``` + +相对来说,后一种写法看上去更容易理解。 + ## 方法的修饰 修饰器不仅可以修饰类,还可以修饰类的属性。 @@ -131,7 +150,7 @@ class Person { 上面代码中,修饰器`readonly`用来修饰“类”的`name`方法。 -此时,修饰器函数一共可以接受三个参数,第一个参数是所要修饰的目标对象,第二个参数是所要修饰的属性名,第三个参数是该属性的描述对象。 +修饰器函数`readonly`一共可以接受三个参数。 ```javascript function readonly(target, name, descriptor){ @@ -151,7 +170,9 @@ readonly(Person.prototype, 'name', descriptor); Object.defineProperty(Person.prototype, 'name', descriptor); ``` -上面代码说明,修饰器(readonly)会修改属性的描述对象(descriptor),然后被修改的描述对象再用来定义属性。 +修饰器第一个参数是类的原型对象,上例是`Person.prototype`,修饰器的本意是要“修饰”类的实例,但是这个时候实例还没生成,所以只能去修饰原型(这不同于类的修饰,那种情况时`target`参数指的是类本身);第二个参数是所要修饰的属性名,第三个参数是该属性的描述对象。 + +另外,上面代码说明,修饰器(readonly)会修改属性的描述对象(descriptor),然后被修改的描述对象再用来定义属性。 下面是另一个例子,修改属性描述对象的`enumerable`属性,使得该属性不可遍历。 @@ -181,8 +202,8 @@ function log(target, name, descriptor) { var oldValue = descriptor.value; descriptor.value = function() { - console.log(`Calling "${name}" with`, arguments); - return oldValue.apply(null, arguments); + console.log(`Calling ${name} with`, arguments); + return oldValue.apply(this, arguments); }; return descriptor; @@ -209,12 +230,32 @@ class Person { 从上面代码中,我们一眼就能看出,`Person`类是可测试的,而`name`方法是只读和不可枚举的。 +下面是使用 Decorator 写法的[组件](https://github.com/ionic-team/stencil),看上去一目了然。 + +```javascript +@Component({ + tag: 'my-component', + styleUrl: 'my-component.scss' +}) +export class MyComponent { + @Prop() first: string; + @Prop() last: string; + @State() isVisible: boolean = true; + + render() { + return ( +

Hello, my name is {this.first} {this.last}

+ ); + } +} +``` + 如果同一个方法有多个修饰器,会像剥洋葱一样,先从外到内进入,然后由内向外执行。 ```javascript function dec(id){ - console.log('evaluated', id); - return (target, property, descriptor) => console.log('executed', id); + console.log('evaluated', id); + return (target, property, descriptor) => console.log('executed', id); } class Example { @@ -230,7 +271,7 @@ class Example { 上面代码中,外层修饰器`@dec(1)`先进入,但是内层修饰器`@dec(2)`先执行。 -除了注释,修饰器还能用来类型检查。所以,对于类来说,这项功能相当有用。从长期来看,它将是JavaScript代码静态分析的重要工具。 +除了注释,修饰器还能用来类型检查。所以,对于类来说,这项功能相当有用。从长期来看,它将是 JavaScript 代码静态分析的重要工具。 ## 为什么修饰器不能用于函数? @@ -248,7 +289,7 @@ function foo() { } ``` -上面的代码,意图是执行后`counter`等于1,但是实际上结果是`counter`等于0。因为函数提升,使得实际执行的代码是下面这样。 +上面的代码,意图是执行后`counter`等于 1,但是实际上结果是`counter`等于 0。因为函数提升,使得实际执行的代码是下面这样。 ```javascript @add @@ -289,6 +330,25 @@ readOnly = require("some-decorator"); 总之,由于存在函数提升,使得修饰器不能用于函数。类是不会提升的,所以就没有这方面的问题。 +另一方面,如果一定要修饰函数,可以采用高阶函数的形式直接执行。 + +```javascript +function doSomething(name) { + console.log('Hello, ' + name); +} + +function loggingDecorator(wrapped) { + return function() { + console.log('Starting'); + const result = wrapped.apply(this, arguments); + console.log('Finished'); + return result; + } +} + +const wrapped = loggingDecorator(doSomething); +``` + ## core-decorators.js [core-decorators.js](https://github.com/jayphelps/core-decorators.js)是一个第三方模块,提供了几个常见的修饰器,通过它可以更好地理解修饰器。 @@ -394,7 +454,7 @@ person.facepalmHarder(); **(5)@suppressWarnings** -`suppressWarnings`修饰器抑制`decorated`修饰器导致的`console.warn()`调用。但是,异步代码发出的调用除外。 +`suppressWarnings`修饰器抑制`deprecated`修饰器导致的`console.warn()`调用。但是,异步代码发出的调用除外。 ```javascript import { suppressWarnings } from 'core-decorators'; @@ -420,15 +480,23 @@ person.facepalmWithoutWarning(); 我们可以使用修饰器,使得对象的方法被调用时,自动发出一个事件。 ```javascript -import postal from "postal/lib/postal.lodash"; +const postal = require("postal/lib/postal.lodash"); export default function publish(topic, channel) { + const channelName = channel || '/'; + const msgChannel = postal.channel(channelName); + msgChannel.subscribe(topic, v => { + console.log('频道: ', channelName); + console.log('事件: ', topic); + console.log('数据: ', v); + }); + return function(target, name, descriptor) { const fn = descriptor.value; descriptor.value = function() { let value = fn.apply(this, arguments); - postal.channel(channel || target.channel || "/").publish(topic, value); + msgChannel.publish(topic, value); }; }; } @@ -439,29 +507,37 @@ export default function publish(topic, channel) { 它的用法如下。 ```javascript -import publish from "path/to/decorators/publish"; +// index.js +import publish from './publish'; class FooComponent { - @publish("foo.some.message", "component") + @publish('foo.some.message', 'component') someMethod() { - return { - my: "data" - }; + return { my: 'data' }; } - @publish("foo.some.other") + @publish('foo.some.other') anotherMethod() { // ... } } + +let foo = new FooComponent(); + +foo.someMethod(); +foo.anotherMethod(); ``` 以后,只要调用`someMethod`或者`anotherMethod`,就会自动发出一个事件。 -```javascript -let foo = new FooComponent(); +```bash +$ bash-node index.js +频道: component +事件: foo.some.message +数据: { my: 'data' } -foo.someMethod() // 在"component"频道发布"foo.some.message"事件,附带的数据是{ my: "data" } -foo.anotherMethod() // 在"/"频道发布"foo.some.other"事件,不附带数据 +频道: / +事件: foo.some.other +数据: undefined ``` ## Mixin @@ -485,7 +561,7 @@ obj.foo() // 'foo' 上面代码之中,对象`Foo`有一个`foo`方法,通过`Object.assign`方法,可以将`foo`方法“混入”`MyClass`类,导致`MyClass`的实例`obj`对象都具有`foo`方法。这就是“混入”模式的一个简单实现。 -下面,我们部署一个通用脚本`mixins.js`,将mixin写成一个修饰器。 +下面,我们部署一个通用脚本`mixins.js`,将 Mixin 写成一个修饰器。 ```javascript export function mixins(...list) { @@ -511,9 +587,9 @@ let obj = new MyClass(); obj.foo() // "foo" ``` -通过mixins这个修饰器,实现了在MyClass类上面“混入”Foo对象的`foo`方法。 +通过`mixins`这个修饰器,实现了在`MyClass`类上面“混入”`Foo`对象的`foo`方法。 -不过,上面的方法会改写`MyClass`类的`prototype`对象,如果不喜欢这一点,也可以通过类的继承实现mixin。 +不过,上面的方法会改写`MyClass`类的`prototype`对象,如果不喜欢这一点,也可以通过类的继承实现 Mixin。 ```javascript class MyClass extends MyBaseClass { @@ -595,9 +671,9 @@ new C().foo() ## Trait -Trait也是一种修饰器,效果与Mixin类似,但是提供更多功能,比如防止同名方法的冲突、排除混入某些方法、为混入的方法起别名等等。 +Trait 也是一种修饰器,效果与 Mixin 类似,但是提供更多功能,比如防止同名方法的冲突、排除混入某些方法、为混入的方法起别名等等。 -下面采用[traits-decorator](https://github.com/CocktailJS/traits-decorator)这个第三方模块作为例子。这个模块提供的traits修饰器,不仅可以接受对象,还可以接受ES6类作为参数。 +下面采用[traits-decorator](https://github.com/CocktailJS/traits-decorator)这个第三方模块作为例子。这个模块提供的`traits`修饰器,不仅可以接受对象,还可以接受 ES6 类作为参数。 ```javascript import { traits } from 'traits-decorator'; @@ -618,9 +694,9 @@ obj.foo() // foo obj.bar() // bar ``` -上面代码中,通过traits修饰器,在`MyClass`类上面“混入”了`TFoo`类的`foo`方法和`TBar`对象的`bar`方法。 +上面代码中,通过`traits`修饰器,在`MyClass`类上面“混入”了`TFoo`类的`foo`方法和`TBar`对象的`bar`方法。 -Trait不允许“混入”同名方法。 +Trait 不允许“混入”同名方法。 ```javascript import { traits } from 'traits-decorator'; @@ -642,9 +718,9 @@ class MyClass { } // Error: Method named: foo is defined twice. ``` -上面代码中,TFoo和TBar都有foo方法,结果traits修饰器报错。 +上面代码中,`TFoo`和`TBar`都有`foo`方法,结果`traits`修饰器报错。 -一种解决方法是排除TBar的foo方法。 +一种解决方法是排除`TBar`的`foo`方法。 ```javascript import { traits, excludes } from 'traits-decorator'; @@ -666,9 +742,9 @@ obj.foo() // foo obj.bar() // bar ``` -上面代码使用绑定运算符(::)在TBar上排除foo方法,混入时就不会报错了。 +上面代码使用绑定运算符(::)在`TBar`上排除`foo`方法,混入时就不会报错了。 -另一种方法是为TBar的foo方法起一个别名。 +另一种方法是为`TBar`的`foo`方法起一个别名。 ```javascript import { traits, alias } from 'traits-decorator'; @@ -691,32 +767,32 @@ obj.aliasFoo() // foo obj.bar() // bar ``` -上面代码为TBar的foo方法起了别名aliasFoo,于是MyClass也可以混入TBar的foo方法了。 +上面代码为`TBar`的`foo`方法起了别名`aliasFoo`,于是`MyClass`也可以混入`TBar`的`foo`方法了。 -alias和excludes方法,可以结合起来使用。 +`alias`和`excludes`方法,可以结合起来使用。 ```javascript @traits(TExample::excludes('foo','bar')::alias({baz:'exampleBaz'})) class MyClass {} ``` -上面代码排除了TExample的foo方法和bar方法,为baz方法起了别名exampleBaz。 +上面代码排除了`TExample`的`foo`方法和`bar`方法,为`baz`方法起了别名`exampleBaz`。 -as方法则为上面的代码提供了另一种写法。 +`as`方法则为上面的代码提供了另一种写法。 ```javascript @traits(TExample::as({excludes:['foo', 'bar'], alias: {baz: 'exampleBaz'}})) class MyClass {} ``` -## Babel转码器的支持 +## Babel 转码器的支持 -目前,Babel转码器已经支持Decorator。 +目前,Babel 转码器已经支持 Decorator。 -首先,安装`babel-core`和`babel-plugin-transform-decorators`。由于后者包括在`babel-preset-stage-0`之中,所以改为安装`babel-preset-stage-0`亦可。 +首先,安装`@babel/core`和`@babel/plugin-transform-decorators`。由于后者包括在`@babel/preset-stage-0`之中,所以改为安装`@babel/preset-stage-0`亦可。 ```bash -$ npm install babel-core babel-plugin-transform-decorators +$ npm install @babel/core @babel/plugin-transform-decorators ``` 然后,设置配置文件`.babelrc`。 @@ -727,7 +803,7 @@ $ npm install babel-core babel-plugin-transform-decorators } ``` -这时,Babel就可以对Decorator转码了。 +这时,Babel 就可以对 Decorator 转码了。 脚本中打开的命令如下。 @@ -735,4 +811,4 @@ $ npm install babel-core babel-plugin-transform-decorators babel.transform("code", {plugins: ["transform-decorators"]}) ``` -Babel的官方网站提供一个[在线转码器](https://babeljs.io/repl/),只要勾选Experimental,就能支持Decorator的在线转码。 +Babel 的官方网站提供一个[在线转码器](https://babeljs.io/repl/),只要勾选 Experimental,就能支持 Decorator 的在线转码。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/destructuring.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/destructuring.md" old mode 100644 new mode 100755 similarity index 82% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/destructuring.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/destructuring.md" index bf0bd4db3..fcb5e1437 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/destructuring.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/destructuring.md" @@ -14,7 +14,7 @@ let b = 2; let c = 3; ``` -ES6允许写成下面这样。 +ES6 允许写成下面这样。 ```javascript let [a, b, c] = [1, 2, 3]; @@ -122,7 +122,7 @@ let [x, y = 'b'] = ['a']; // x='a', y='b' let [x, y = 'b'] = ['a', undefined]; // x='a', y='b' ``` -注意,ES6 内部使用严格相等运算符(`===`),判断一个位置是否有值。所以,如果一个数组成员不严格等于`undefined`,默认值是不会生效的。 +注意,ES6 内部使用严格相等运算符(`===`),判断一个位置是否有值。所以,只有当一个数组成员严格等于`undefined`,默认值才会生效。 ```javascript let [x = 1] = [undefined]; @@ -161,10 +161,10 @@ if ([1][0] === undefined) { let [x = 1, y = x] = []; // x=1; y=1 let [x = 1, y = x] = [2]; // x=2; y=2 let [x = 1, y = x] = [1, 2]; // x=1; y=2 -let [x = y, y = 1] = []; // ReferenceError +let [x = y, y = 1] = []; // ReferenceError: y is not defined ``` -上面最后一个表达式之所以会报错,是因为`x`用到默认值`y`时,`y`还没有声明。 +上面最后一个表达式之所以会报错,是因为`x`用`y`做默认值时,`y`还没有声明。 ## 对象的解构赋值 @@ -192,7 +192,7 @@ baz // undefined 如果变量名与属性名不一致,必须写成下面这样。 ```javascript -var { foo: baz } = { foo: 'aaa', bar: 'bbb' }; +let { foo: baz } = { foo: 'aaa', bar: 'bbb' }; baz // "aaa" let obj = { first: 'hello', last: 'world' }; @@ -217,29 +217,22 @@ foo // error: foo is not defined 上面代码中,`foo`是匹配的模式,`baz`才是变量。真正被赋值的是变量`baz`,而不是模式`foo`。 -注意,采用这种写法时,变量的声明和赋值是一体的。对于`let`和`const`来说,变量不能重新声明,所以一旦赋值的变量以前声明过,就会报错。 +与数组一样,解构也可以用于嵌套结构的对象。 ```javascript -let foo; -let {foo} = {foo: 1}; // SyntaxError: Duplicate declaration "foo" - -let baz; -let {bar: baz} = {bar: 1}; // SyntaxError: Duplicate declaration "baz" -``` - -上面代码中,解构赋值的变量都会重新声明,所以报错了。不过,因为`var`命令允许重新声明,所以这个错误只会在使用`let`和`const`命令时出现。如果没有第二个`let`命令,上面的代码就不会报错。 - -```javascript -let foo; -({foo} = {foo: 1}); // 成功 +let obj = { + p: [ + 'Hello', + { y: 'World' } + ] +}; -let baz; -({bar: baz} = {bar: 1}); // 成功 +let { p: [x, { y }] } = obj; +x // "Hello" +y // "World" ``` -上面代码中,`let`命令下面一行的圆括号是必须的,否则会报错。因为解析器会将起首的大括号,理解成一个代码块,而不是赋值语句。 - -和数组一样,解构也可以用于嵌套结构的对象。 +注意,这时`p`是模式,不是变量,因此不会被赋值。如果`p`也要作为变量赋值,可以写成下面这样。 ```javascript let obj = { @@ -249,15 +242,16 @@ let obj = { ] }; -let { p: [x, { y }] } = obj; +let { p, p: [x, { y }] } = obj; x // "Hello" y // "World" +p // ["Hello", {y: "World"}] ``` -注意,这时`p`是模式,不是变量,因此不会被赋值。 +下面是另一个例子。 ```javascript -var node = { +const node = { loc: { start: { line: 1, @@ -266,13 +260,13 @@ var node = { } }; -var { loc: { start: { line }} } = node; +let { loc, loc: { start }, loc: { start: { line }} } = node; line // 1 -loc // error: loc is undefined -start // error: start is undefined +loc // Object {start: Object} +start // Object {line: 1, column: 5} ``` -上面代码中,只有`line`是变量,`loc`和`start`都是模式,不会被赋值。 +上面代码有三次解构赋值,分别是对`loc`、`start`、`line`三个属性的解构赋值。注意,最后一次对`line`属性的解构赋值之中,只有`line`是变量,`loc`和`start`都是模式,不是变量。 下面是嵌套赋值的例子。 @@ -296,10 +290,10 @@ var {x, y = 5} = {x: 1}; x // 1 y // 5 -var {x:y = 3} = {}; +var {x: y = 3} = {}; y // 3 -var {x:y = 3} = {x: 5}; +var {x: y = 3} = {x: 5}; y // 5 var { message: msg = 'Something went wrong' } = {}; @@ -316,7 +310,7 @@ var {x = 3} = {x: null}; x // null ``` -上面代码中,如果`x`属性等于`null`,就不严格相等于`undefined`,导致默认值不会生效。 +上面代码中,属性`x`等于`null`,因为`null`与`undefined`不严格相等,所以是个有效的赋值,导致默认值`3`不会生效。 如果解构失败,变量的值等于`undefined`。 @@ -348,16 +342,17 @@ let x; // SyntaxError: syntax error ``` -上面代码的写法会报错,因为JavaScript引擎会将`{x}`理解成一个代码块,从而发生语法错误。只有不将大括号写在行首,避免JavaScript将其解释为代码块,才能解决这个问题。 +上面代码的写法会报错,因为 JavaScript 引擎会将`{x}`理解成一个代码块,从而发生语法错误。只有不将大括号写在行首,避免 JavaScript 将其解释为代码块,才能解决这个问题。 ```javascript // 正确的写法 +let x; ({x} = {x: 1}); ``` 上面代码将整个解构赋值语句,放在一个圆括号里面,就可以正确执行。关于圆括号与解构赋值的关系,参见下文。 -解构赋值允许,等号左边的模式之中,不放置任何变量名。因此,可以写出非常古怪的赋值表达式。 +解构赋值允许等号左边的模式之中,不放置任何变量名。因此,可以写出非常古怪的赋值表达式。 ```javascript ({} = [true, false]); @@ -384,7 +379,7 @@ first // 1 last // 3 ``` -上面代码对数组进行对象解构。数组`arr`的`0`键对应的值是`1`,`[arr.length - 1]`就是`2`键,对应的值是`3`。方括号这种写法,属于“属性名表达式”,参见《对象的扩展》一章。 +上面代码对数组进行对象解构。数组`arr`的`0`键对应的值是`1`,`[arr.length - 1]`就是`2`键,对应的值是`3`。方括号这种写法,属于“属性名表达式”(参见《对象的扩展》一章)。 ## 字符串的解构赋值 @@ -489,7 +484,7 @@ move(); // [0, 0] 解构赋值虽然很方便,但是解析起来并不容易。对于编译器来说,一个式子到底是模式,还是表达式,没有办法从一开始就知道,必须解析到(或解析不到)等号才能知道。 -由此带来的问题是,如果模式中出现圆括号怎么处理。ES6的规则是,只要有可能导致解构的歧义,就不得使用圆括号。 +由此带来的问题是,如果模式中出现圆括号怎么处理。ES6 的规则是,只要有可能导致解构的歧义,就不得使用圆括号。 但是,这条规则实际上不那么容易辨别,处理起来相当麻烦。因此,建议只要有可能,就不要在模式中放置圆括号。 @@ -497,7 +492,7 @@ move(); // [0, 0] 以下三种解构赋值不得使用圆括号。 -(1)变量声明语句中,不能带有圆括号。 +(1)变量声明语句 ```javascript // 全部报错 @@ -511,18 +506,20 @@ let {(x): c} = {}; let { o: ({ p: p }) } = { o: { p: 2 } }; ``` -上面三个语句都会报错,因为它们都是变量声明语句,模式不能使用圆括号。 +上面 6 个语句都会报错,因为它们都是变量声明语句,模式不能使用圆括号。 -(2)函数参数中,模式不能带有圆括号。 +(2)函数参数 函数参数也属于变量声明,因此不能带有圆括号。 ```javascript // 报错 function f([(z)]) { return z; } +// 报错 +function f([z,(x)]) { return x; } ``` -(3)赋值语句中,不能将整个模式,或嵌套模式中的一层,放在圆括号之中。 +(3)赋值语句的模式 ```javascript // 全部报错 @@ -537,7 +534,7 @@ function f([(z)]) { return z; } [({ p: a }), { x: c }] = [{}, {}]; ``` -上面代码将嵌套模式的一层,放在圆括号之中,导致报错。 +上面代码将一部分模式放在圆括号之中,导致报错。 ### 可以使用圆括号的情况 @@ -549,7 +546,7 @@ function f([(z)]) { return z; } [(parseInt.prop)] = [3]; // 正确 ``` -上面三行语句都可以正确执行,因为首先它们都是赋值语句,而不是声明语句;其次它们的圆括号都不属于模式的一部分。第一行语句中,模式是取数组的第一个成员,跟圆括号无关;第二行语句中,模式是p,而不是d;第三行语句与第一行语句的性质一致。 +上面三行语句都可以正确执行,因为首先它们都是赋值语句,而不是声明语句;其次它们的圆括号都不属于模式的一部分。第一行语句中,模式是取数组的第一个成员,跟圆括号无关;第二行语句中,模式是`p`,而不是`d`;第三行语句与第一行语句的性质一致。 ## 用途 @@ -603,9 +600,9 @@ function f({x, y, z}) { ... } f({z: 3, y: 2, x: 1}); ``` -**(4)提取JSON数据** +**(4)提取 JSON 数据** -解构赋值对提取JSON对象中的数据,尤其有用。 +解构赋值对提取 JSON 对象中的数据,尤其有用。 ```javascript let jsonData = { @@ -633,19 +630,19 @@ jQuery.ajax = function (url, { crossDomain = false, global = true, // ... more config -}) { +} = {}) { // ... do stuff }; ``` 指定参数的默认值,就避免了在函数体内部再写`var foo = config.foo || 'default foo';`这样的语句。 -**(6)遍历Map结构** +**(6)遍历 Map 结构** -任何部署了Iterator接口的对象,都可以用`for...of`循环遍历。Map结构原生支持Iterator接口,配合变量的解构赋值,获取键名和键值就非常方便。 +任何部署了 Iterator 接口的对象,都可以用`for...of`循环遍历。Map 结构原生支持 Iterator 接口,配合变量的解构赋值,获取键名和键值就非常方便。 ```javascript -var map = new Map(); +const map = new Map(); map.set('first', 'hello'); map.set('second', 'world'); diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/fp.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/fp.md" old mode 100644 new mode 100755 similarity index 83% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/fp.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/fp.md" index 580ceac38..e33d5e251 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/fp.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/fp.md" @@ -1,8 +1,8 @@ # 函数式编程 -JavaScript语言从一诞生,就具有函数式编程的烙印。它将函数作为一种独立的数据类型,与其他数据类型处于完全平等的地位。在JavaScript语言中,你可以采用面向对象编程,也可以采用函数式编程。有人甚至说,JavaScript是有史以来第一种被大规模采用的函数式编程语言。 +JavaScript 语言从一诞生,就具有函数式编程的烙印。它将函数作为一种独立的数据类型,与其他数据类型处于完全平等的地位。在 JavaScript 语言中,你可以采用面向对象编程,也可以采用函数式编程。有人甚至说,JavaScript 是有史以来第一种被大规模采用的函数式编程语言。 -ES6的种种新增功能,使得函数式编程变得更方便、更强大。本章介绍ES6如何进行函数式编程。 +ES6 的种种新增功能,使得函数式编程变得更方便、更强大。本章介绍 ES6 如何进行函数式编程。 ## 柯里化 @@ -66,7 +66,7 @@ var flip = f.flip(three); flip(1, 2, 3); // => [2, 1, 3] ``` -上面代码中,如果按照正常的参数顺序,10除以5等于2。但是,参数倒置以后得到的新函数,结果就是5除以10,结果得到0.5。如果原函数有3个参数,则只颠倒前两个参数的位置。 +上面代码中,如果按照正常的参数顺序,10 除以 5 等于 2。但是,参数倒置以后得到的新函数,结果就是 5 除以 10,结果得到 0.5。如果原函数有 3 个参数,则只颠倒前两个参数的位置。 参数倒置的代码非常简单。 @@ -94,7 +94,7 @@ until = f.until(condition, inc); until(3) // 5 ``` -上面代码中,第一段的条件是执行到`x`大于100为止,所以`x`初值为0时,会一直执行到101。第二段的条件是执行到等于5为止,所以`x`最后的值是5。 +上面代码中,第一段的条件是执行到`x`大于 100 为止,所以`x`初值为 0 时,会一直执行到 101。第二段的条件是执行到等于 5 为止,所以`x`最后的值是 5。 执行边界的实现如下。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/function.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/function.md" old mode 100644 new mode 100755 similarity index 68% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/function.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/function.md" index 3f3c61acf..d83ad6ac0 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/function.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/function.md" @@ -4,7 +4,7 @@ ### 基本用法 -在ES6之前,不能直接为函数的参数指定默认值,只能采用变通的方法。 +ES6 之前,不能直接为函数的参数指定默认值,只能采用变通的方法。 ```javascript function log(x, y) { @@ -47,7 +47,7 @@ function Point(x = 0, y = 0) { this.y = y; } -var p = new Point(); +const p = new Point(); p // { x: 0, y: 0 } ``` @@ -67,13 +67,19 @@ function foo(x = 5) { 使用参数默认值时,函数不能有同名参数。 ```javascript +// 不报错 +function foo(x, x, y) { + // ... +} + +// 报错 function foo(x, x, y = 1) { // ... } // SyntaxError: Duplicate parameter name not allowed in this context ``` -另外,一个容易忽略的地方是,如果参数默认值是变量,那么参数就不是传值的,而是每次都重新计算默认值表达式的值。也就是说,参数默认值是惰性求值的。 +另外,一个容易忽略的地方是,参数默认值不是传值的,而是每次都重新计算默认值表达式的值。也就是说,参数默认值是惰性求值的。 ```javascript let x = 99; @@ -98,15 +104,25 @@ function foo({x, y = 5}) { console.log(x, y); } -foo({}) // undefined, 5 -foo({x: 1}) // 1, 5 -foo({x: 1, y: 2}) // 1, 2 +foo({}) // undefined 5 +foo({x: 1}) // 1 5 +foo({x: 1, y: 2}) // 1 2 foo() // TypeError: Cannot read property 'x' of undefined ``` -上面代码使用了对象的解构赋值默认值,而没有使用函数参数的默认值。只有当函数`foo`的参数是一个对象时,变量`x`和`y`才会通过解构赋值而生成。如果函数`foo`调用时参数不是对象,变量`x`和`y`就不会生成,从而报错。如果参数对象没有`y`属性,`y`的默认值5才会生效。 +上面代码只使用了对象的解构赋值默认值,没有使用函数参数的默认值。只有当函数`foo`的参数是一个对象时,变量`x`和`y`才会通过解构赋值生成。如果函数`foo`调用时没提供参数,变量`x`和`y`就不会生成,从而报错。通过提供函数参数的默认值,就可以避免这种情况。 -下面是另一个对象的解构赋值默认值的例子。 +```javascript +function foo({x, y = 5} = {}) { + console.log(x, y); +} + +foo() // undefined 5 +``` + +上面代码指定,如果没有提供参数,函数`foo`的参数默认为一个空对象。 + +下面是另一个解构赋值默认值的例子。 ```javascript function fetch(url, { body = '', method = 'GET', headers = {} }) { @@ -120,12 +136,10 @@ fetch('http://example.com') // 报错 ``` -上面代码中,如果函数`fetch`的第二个参数是一个对象,就可以为它的三个属性设置默认值。 - -上面的写法不能省略第二个参数,如果结合函数参数的默认值,就可以省略第二个参数。这时,就出现了双重默认值。 +上面代码中,如果函数`fetch`的第二个参数是一个对象,就可以为它的三个属性设置默认值。这种写法不能省略第二个参数,如果结合函数参数的默认值,就可以省略第二个参数。这时,就出现了双重默认值。 ```javascript -function fetch(url, { method = 'GET' } = {}) { +function fetch(url, { body = '', method = 'GET', headers = {} } = {}) { console.log(method); } @@ -135,7 +149,7 @@ fetch('http://example.com') 上面代码中,函数`fetch`没有第二个参数时,函数参数的默认值就会生效,然后才是解构赋值的默认值生效,变量`method`才会取到默认值`GET`。 -再请问下面两种写法有什么差别? +作为练习,请问下面两种写法有什么差别? ```javascript // 写法一 @@ -156,15 +170,15 @@ function m2({x, y} = { x: 0, y: 0 }) { m1() // [0, 0] m2() // [0, 0] -// x和y都有值的情况 +// x 和 y 都有值的情况 m1({x: 3, y: 8}) // [3, 8] m2({x: 3, y: 8}) // [3, 8] -// x有值,y无值的情况 +// x 有值,y 无值的情况 m1({x: 3}) // [3, 0] m2({x: 3}) // [3, undefined] -// x和y都无值的情况 +// x 和 y 都无值的情况 m1({}) // [0, 0]; m2({}) // [undefined, undefined] @@ -223,9 +237,9 @@ foo(undefined, null) (function (a, b, c = 5) {}).length // 2 ``` -上面代码中,`length`属性的返回值,等于函数的参数个数减去指定了默认值的参数个数。比如,上面最后一个函数,定义了3个参数,其中有一个参数`c`指定了默认值,因此`length`属性等于`3`减去`1`,最后得到`2`。 +上面代码中,`length`属性的返回值,等于函数的参数个数减去指定了默认值的参数个数。比如,上面最后一个函数,定义了 3 个参数,其中有一个参数`c`指定了默认值,因此`length`属性等于`3`减去`1`,最后得到`2`。 -这是因为`length`属性的含义是,该函数预期传入的参数个数。某个参数指定默认值以后,预期传入的参数个数就不包括这个参数了。同理,rest参数也不会计入`length`属性。 +这是因为`length`属性的含义是,该函数预期传入的参数个数。某个参数指定默认值以后,预期传入的参数个数就不包括这个参数了。同理,后文的 rest 参数也不会计入`length`属性。 ```javascript (function(...args) {}).length // 0 @@ -299,12 +313,12 @@ foo() // ReferenceError: x is not defined ```javascript let foo = 'outer'; -function bar(func = x => foo) { +function bar(func = () => foo) { let foo = 'inner'; - console.log(func()); // outer + console.log(func()); } -bar(); +bar(); // outer ``` 上面代码中,函数`bar`的参数`func`的默认值是一个匿名函数,返回值为变量`foo`。函数参数形成的单独作用域里面,并没有定义变量`foo`,所以`foo`指向外层的全局变量`foo`,因此输出`outer`。 @@ -371,7 +385,7 @@ foo() 上面代码的`foo`函数,如果调用的时候没有参数,就会调用默认值`throwIfMissing`函数,从而抛出一个错误。 -从上面代码还可以看到,参数`mustBeProvided`的默认值等于`throwIfMissing`函数的运行结果(即函数名之后有一对圆括号),这表明参数的默认值不是在定义时执行,而是在运行时执行(即如果参数已经赋值,默认值中的函数就不会运行),这与 Python 语言不一样。 +从上面代码还可以看到,参数`mustBeProvided`的默认值等于`throwIfMissing`函数的运行结果(注意函数名`throwIfMissing`之后有一对圆括号),这表明参数的默认值不是在定义时执行,而是在运行时执行。如果参数已经赋值,默认值中的函数就不会运行。 另外,可以将参数默认值设为`undefined`,表明这个参数是可以省略的。 @@ -379,9 +393,9 @@ foo() function foo(optional = undefined) { ··· } ``` -## rest参数 +## rest 参数 -ES6 引入 rest 参数(形式为“...变量名”),用于获取函数的多余参数,这样就不需要使用`arguments`对象了。rest 参数搭配的变量是一个数组,该变量将多余的参数放入数组中。 +ES6 引入 rest 参数(形式为`...变量名`),用于获取函数的多余参数,这样就不需要使用`arguments`对象了。rest 参数搭配的变量是一个数组,该变量将多余的参数放入数组中。 ```javascript function add(...values) { @@ -413,7 +427,7 @@ const sortNumbers = (...numbers) => numbers.sort(); 上面代码的两种写法,比较后可以发现,rest 参数的写法更自然也更简洁。 -rest 参数中的变量代表一个数组,所以数组特有的方法都可以用于这个变量。下面是一个利用 rest 参数改写数组`push`方法的例子。 +`arguments`对象不是数组,而是一个类似数组的对象。所以为了使用数组的方法,必须使用`Array.prototype.slice.call`先将其转为数组。rest 参数就不存在这个问题,它就是一个真正的数组,数组特有的方法都可以使用。下面是一个利用 rest 参数改写数组`push`方法的例子。 ```javascript function push(array, ...items) { @@ -444,286 +458,9 @@ function f(a, ...b, c) { (function(a, ...b) {}).length // 1 ``` -## 扩展运算符 - -### 含义 - -扩展运算符(spread)是三个点(`...`)。它好比 rest 参数的逆运算,将一个数组转为用逗号分隔的参数序列。 - -```javascript -console.log(...[1, 2, 3]) -// 1 2 3 - -console.log(1, ...[2, 3, 4], 5) -// 1 2 3 4 5 - -[...document.querySelectorAll('div')] -// [
,
,
] -``` - -该运算符主要用于函数调用。 - -```javascript -function push(array, ...items) { - array.push(...items); -} - -function add(x, y) { - return x + y; -} - -var numbers = [4, 38]; -add(...numbers) // 42 -``` - -上面代码中,`array.push(...items)`和`add(...numbers)`这两行,都是函数的调用,它们的都使用了扩展运算符。该运算符将一个数组,变为参数序列。 - -扩展运算符与正常的函数参数可以结合使用,非常灵活。 - -```javascript -function f(v, w, x, y, z) { } -var args = [0, 1]; -f(-1, ...args, 2, ...[3]); -``` - -### 替代数组的apply方法 - -由于扩展运算符可以展开数组,所以不再需要`apply`方法,将数组转为函数的参数了。 - -```javascript -// ES5的写法 -function f(x, y, z) { - // ... -} -var args = [0, 1, 2]; -f.apply(null, args); - -// ES6的写法 -function f(x, y, z) { - // ... -} -var args = [0, 1, 2]; -f(...args); -``` - -下面是扩展运算符取代`apply`方法的一个实际的例子,应用`Math.max`方法,简化求出一个数组最大元素的写法。 - -```javascript -// ES5的写法 -Math.max.apply(null, [14, 3, 77]) - -// ES6的写法 -Math.max(...[14, 3, 77]) - -// 等同于 -Math.max(14, 3, 77); -``` - -上面代码表示,由于JavaScript不提供求数组最大元素的函数,所以只能套用`Math.max`函数,将数组转为一个参数序列,然后求最大值。有了扩展运算符以后,就可以直接用`Math.max`了。 - -另一个例子是通过`push`函数,将一个数组添加到另一个数组的尾部。 - -```javascript -// ES5的写法 -var arr1 = [0, 1, 2]; -var arr2 = [3, 4, 5]; -Array.prototype.push.apply(arr1, arr2); - -// ES6的写法 -var arr1 = [0, 1, 2]; -var arr2 = [3, 4, 5]; -arr1.push(...arr2); -``` - -上面代码的ES5写法中,`push`方法的参数不能是数组,所以只好通过`apply`方法变通使用`push`方法。有了扩展运算符,就可以直接将数组传入`push`方法。 - -下面是另外一个例子。 - -```javascript -// ES5 -new (Date.bind.apply(Date, [null, 2015, 1, 1])) -// ES6 -new Date(...[2015, 1, 1]); -``` - -### 扩展运算符的应用 - -**(1)合并数组** - -扩展运算符提供了数组合并的新写法。 - -```javascript -// ES5 -[1, 2].concat(more) -// ES6 -[1, 2, ...more] - -var arr1 = ['a', 'b']; -var arr2 = ['c']; -var arr3 = ['d', 'e']; - -// ES5的合并数组 -arr1.concat(arr2, arr3); -// [ 'a', 'b', 'c', 'd', 'e' ] - -// ES6的合并数组 -[...arr1, ...arr2, ...arr3] -// [ 'a', 'b', 'c', 'd', 'e' ] -``` - -**(2)与解构赋值结合** - -扩展运算符可以与解构赋值结合起来,用于生成数组。 - -```javascript -// ES5 -a = list[0], rest = list.slice(1) -// ES6 -[a, ...rest] = list -``` - -下面是另外一些例子。 - -```javascript -const [first, ...rest] = [1, 2, 3, 4, 5]; -first // 1 -rest // [2, 3, 4, 5] - -const [first, ...rest] = []; -first // undefined -rest // []: - -const [first, ...rest] = ["foo"]; -first // "foo" -rest // [] -``` - -如果将扩展运算符用于数组赋值,只能放在参数的最后一位,否则会报错。 - -```javascript -const [...butLast, last] = [1, 2, 3, 4, 5]; -// 报错 - -const [first, ...middle, last] = [1, 2, 3, 4, 5]; -// 报错 -``` - -**(3)函数的返回值** - -JavaScript的函数只能返回一个值,如果需要返回多个值,只能返回数组或对象。扩展运算符提供了解决这个问题的一种变通方法。 - -```javascript -var dateFields = readDateFields(database); -var d = new Date(...dateFields); -``` - -上面代码从数据库取出一行数据,通过扩展运算符,直接将其传入构造函数`Date`。 - -**(4)字符串** - -扩展运算符还可以将字符串转为真正的数组。 - -```javascript -[...'hello'] -// [ "h", "e", "l", "l", "o" ] -``` - -上面的写法,有一个重要的好处,那就是能够正确识别32位的Unicode字符。 - -```javascript -'x\uD83D\uDE80y'.length // 4 -[...'x\uD83D\uDE80y'].length // 3 -``` - -上面代码的第一种写法,JavaScript会将32位Unicode字符,识别为2个字符,采用扩展运算符就没有这个问题。因此,正确返回字符串长度的函数,可以像下面这样写。 - -```javascript -function length(str) { - return [...str].length; -} - -length('x\uD83D\uDE80y') // 3 -``` - -凡是涉及到操作32位Unicode字符的函数,都有这个问题。因此,最好都用扩展运算符改写。 - -```javascript -let str = 'x\uD83D\uDE80y'; - -str.split('').reverse().join('') -// 'y\uDE80\uD83Dx' - -[...str].reverse().join('') -// 'y\uD83D\uDE80x' -``` - -上面代码中,如果不用扩展运算符,字符串的`reverse`操作就不正确。 - -**(5)实现了Iterator接口的对象** - -任何Iterator接口的对象,都可以用扩展运算符转为真正的数组。 - -```javascript -var nodeList = document.querySelectorAll('div'); -var array = [...nodeList]; -``` - -上面代码中,`querySelectorAll`方法返回的是一个`nodeList`对象。它不是数组,而是一个类似数组的对象。这时,扩展运算符可以将其转为真正的数组,原因就在于`NodeList`对象实现了Iterator接口。 - -对于那些没有部署Iterator接口的类似数组的对象,扩展运算符就无法将其转为真正的数组。 - -```javascript -let arrayLike = { - '0': 'a', - '1': 'b', - '2': 'c', - length: 3 -}; - -// TypeError: Cannot spread non-iterable object. -let arr = [...arrayLike]; -``` - -上面代码中,`arrayLike`是一个类似数组的对象,但是没有部署Iterator接口,扩展运算符就会报错。这时,可以改为使用`Array.from`方法将`arrayLike`转为真正的数组。 - -**(6)Map和Set结构,Generator函数** - -扩展运算符内部调用的是数据结构的Iterator接口,因此只要具有Iterator接口的对象,都可以使用扩展运算符,比如Map结构。 - -```javascript -let map = new Map([ - [1, 'one'], - [2, 'two'], - [3, 'three'], -]); - -let arr = [...map.keys()]; // [1, 2, 3] -``` - -Generator函数运行后,返回一个遍历器对象,因此也可以使用扩展运算符。 - -```javascript -var go = function*(){ - yield 1; - yield 2; - yield 3; -}; - -[...go()] // [1, 2, 3] -``` - -上面代码中,变量`go`是一个Generator函数,执行后返回的是一个遍历器对象,对这个遍历器对象执行扩展运算符,就会将内部遍历得到的值,转为一个数组。 - -如果对没有`iterator`接口的对象,使用扩展运算符,将会报错。 - -```javascript -var obj = {a: 1, b: 2}; -let arr = [...obj]; // TypeError: Cannot spread non-iterable object -``` - ## 严格模式 -从ES5开始,函数内部可以设定为严格模式。 +从 ES5 开始,函数内部可以设定为严格模式。 ```javascript function doSomething(a, b) { @@ -732,7 +469,7 @@ function doSomething(a, b) { } ``` -《ECMAScript 2016标准》做了一点修改,规定只要函数参数使用了默认值、解构赋值、或者扩展运算符,那么函数内部就不能显式设定为严格模式,否则会报错。 +ES2016 做了一点修改,规定只要函数参数使用了默认值、解构赋值、或者扩展运算符,那么函数内部就不能显式设定为严格模式,否则会报错。 ```javascript // 报错 @@ -762,7 +499,7 @@ const obj = { }; ``` -这样规定的原因是,函数内部的严格模式,同时适用于函数体代码和函数参数代码。但是,函数执行的时候,先执行函数参数代码,然后再执行函数体代码。这样就有一个不合理的地方,只有从函数体代码之中,才能知道参数代码是否应该以严格模式执行,但是参数代码却应该先于函数体代码执行。 +这样规定的原因是,函数内部的严格模式,同时适用于函数体和函数参数。但是,函数执行的时候,先执行函数参数,然后再执行函数体。这样就有一个不合理的地方,只有从函数体之中,才能知道参数是否应该以严格模式执行,但是参数却应该先于函数体执行。 ```javascript // 报错 @@ -772,7 +509,7 @@ function doSomething(value = 070) { } ``` -上面代码中,参数`value`的默认值是八进制数`070`,但是严格模式下不能用前缀`0`表示八进制,所以应该报错。但是实际上,JavaScript引擎会先成功执行`value = 070`,然后进入函数体内部,发现需要用严格模式执行,这时才会报错。 +上面代码中,参数`value`的默认值是八进制数`070`,但是严格模式下不能用前缀`0`表示八进制,所以应该报错。但是实际上,JavaScript 引擎会先成功执行`value = 070`,然后进入函数体内部,发现需要用严格模式执行,这时才会报错。 虽然可以先解析函数体代码,再执行参数代码,但是这样无疑就增加了复杂性。因此,标准索性禁止了这种用法,只要参数使用了默认值、解构赋值、或者扩展运算符,就不能显式指定严格模式。 @@ -840,7 +577,7 @@ bar.name // "baz" (new Function).name // "anonymous" ``` -`bind`返回的函数,`name`属性值会加上`bound `前缀。 +`bind`返回的函数,`name`属性值会加上`bound`前缀。 ```javascript function foo() {}; @@ -853,16 +590,13 @@ foo.bind({}).name // "bound foo" ### 基本用法 -ES6允许使用“箭头”(`=>`)定义函数。 +ES6 允许使用“箭头”(`=>`)定义函数。 ```javascript var f = v => v; -``` -上面的箭头函数等同于: - -```javascript -var f = function(v) { +// 等同于 +var f = function (v) { return v; }; ``` @@ -887,10 +621,29 @@ var sum = function(num1, num2) { var sum = (num1, num2) => { return num1 + num2; } ``` -由于大括号被解释为代码块,所以如果箭头函数直接返回一个对象,必须在对象外面加上括号。 +由于大括号被解释为代码块,所以如果箭头函数直接返回一个对象,必须在对象外面加上括号,否则会报错。 + +```javascript +// 报错 +let getTempItem = id => { id: id, name: "Temp" }; + +// 不报错 +let getTempItem = id => ({ id: id, name: "Temp" }); +``` + +下面是一种特殊情况,虽然可以运行,但会得到错误的结果。 + +```javascript +let foo = () => { a: 1 }; +foo() // undefined +``` + +上面代码中,原始意图是返回一个对象`{ a: 1 }`,但是由于引擎认为大括号是代码块,所以执行了一行语句`a: 1`。这时,`a`可以被解释为语句的标签,因此实际执行的语句是`1;`,然后函数就结束了,没有返回值。 + +如果箭头函数只有一行语句,且不需要返回值,可以采用下面的写法,就不用写大括号了。 ```javascript -var getTempItem = id => ({ id: id, name: "Temp" }); +let fn = () => void doesNotReturn(); ``` 箭头函数可以与变量解构结合使用。 @@ -907,7 +660,7 @@ function full(person) { 箭头函数使得表达更加简洁。 ```javascript -const isEven = n => n % 2 == 0; +const isEven = n => n % 2 === 0; const square = n => n * n; ``` @@ -937,7 +690,7 @@ var result = values.sort(function (a, b) { var result = values.sort((a, b) => a - b); ``` -下面是rest参数与箭头函数结合的例子。 +下面是 rest 参数与箭头函数结合的例子。 ```javascript const numbers = (...nums) => nums; @@ -959,9 +712,9 @@ headAndTail(1, 2, 3, 4, 5) (2)不可以当作构造函数,也就是说,不可以使用`new`命令,否则会抛出一个错误。 -(3)不可以使用`arguments`对象,该对象在函数体内不存在。如果要用,可以用Rest参数代替。 +(3)不可以使用`arguments`对象,该对象在函数体内不存在。如果要用,可以用 rest 参数代替。 -(4)不可以使用`yield`命令,因此箭头函数不能用作Generator函数。 +(4)不可以使用`yield`命令,因此箭头函数不能用作 Generator 函数。 上面四点中,第一点尤其值得注意。`this`对象的指向是可变的,但是在箭头函数中,它是固定的。 @@ -978,7 +731,7 @@ foo.call({ id: 42 }); // id: 42 ``` -上面代码中,`setTimeout`的参数是一个箭头函数,这个箭头函数的定义生效是在`foo`函数生成时,而它的真正执行要等到100毫秒后。如果是普通函数,执行时`this`应该指向全局对象`window`,这时应该输出`21`。但是,箭头函数导致`this`总是指向函数定义生效时所在的对象(本例是`{id: 42}`),所以输出的是`42`。 +上面代码中,`setTimeout`的参数是一个箭头函数,这个箭头函数的定义生效是在`foo`函数生成时,而它的真正执行要等到 100 毫秒后。如果是普通函数,执行时`this`应该指向全局对象`window`,这时应该输出`21`。但是,箭头函数导致`this`总是指向函数定义生效时所在的对象(本例是`{id: 42}`),所以输出的是`42`。 箭头函数可以让`setTimeout`里面的`this`,绑定定义时所在的作用域,而不是指向运行时所在的作用域。下面是另一个例子。 @@ -1002,9 +755,9 @@ setTimeout(() => console.log('s2: ', timer.s2), 3100); // s2: 0 ``` -上面代码中,`Timer`函数内部设置了两个定时器,分别使用了箭头函数和普通函数。前者的`this`绑定定义时所在的作用域(即`Timer`函数),后者的`this`指向运行时所在的作用域(即全局对象)。所以,3100毫秒之后,`timer.s1`被更新了3次,而`timer.s2`一次都没更新。 +上面代码中,`Timer`函数内部设置了两个定时器,分别使用了箭头函数和普通函数。前者的`this`绑定定义时所在的作用域(即`Timer`函数),后者的`this`指向运行时所在的作用域(即全局对象)。所以,3100 毫秒之后,`timer.s1`被更新了 3 次,而`timer.s2`一次都没更新。 -箭头函数可以让`this`指向固定化,这种特性很有利于封装回调函数。下面是一个例子,DOM事件的回调函数封装在一个对象里面。 +箭头函数可以让`this`指向固定化,这种特性很有利于封装回调函数。下面是一个例子,DOM 事件的回调函数封装在一个对象里面。 ```javascript var handler = { @@ -1025,7 +778,7 @@ var handler = { `this`指向的固定化,并不是因为箭头函数内部有绑定`this`的机制,实际原因是箭头函数根本没有自己的`this`,导致内部的`this`就是外层代码块的`this`。正是因为它没有`this`,所以也就不能用作构造函数。 -所以,箭头函数转成ES5的代码如下。 +所以,箭头函数转成 ES5 的代码如下。 ```javascript // ES6 @@ -1045,7 +798,7 @@ function foo() { } ``` -上面代码中,转换后的ES5版本清楚地说明了,箭头函数里面根本没有自己的`this`,而是引用外层的`this`。 +上面代码中,转换后的 ES5 版本清楚地说明了,箭头函数里面根本没有自己的`this`,而是引用外层的`this`。 请问下面的代码之中有几个`this`? @@ -1097,11 +850,41 @@ foo(2, 4, 6, 8) 上面代码中,箭头函数没有自己的`this`,所以`bind`方法无效,内部的`this`指向外部的`this`。 -长期以来,JavaScript语言的`this`对象一直是一个令人头痛的问题,在对象方法中使用`this`,必须非常小心。箭头函数”绑定”`this`,很大程度上解决了这个困扰。 +长期以来,JavaScript 语言的`this`对象一直是一个令人头痛的问题,在对象方法中使用`this`,必须非常小心。箭头函数”绑定”`this`,很大程度上解决了这个困扰。 + +### 不适用场合 + +由于箭头函数使得`this`从“动态”变成“静态”,下面两个场合不应该使用箭头函数。 + +第一个场合是定义函数的方法,且该方法内部包括`this`。 + +```javascript +const cat = { + lives: 9, + jumps: () => { + this.lives--; + } +} +``` + +上面代码中,`cat.jumps()`方法是一个箭头函数,这是错误的。调用`cat.jumps()`时,如果是普通函数,该方法内部的`this`指向`cat`;如果写成上面那样的箭头函数,使得`this`指向全局对象,因此不会得到预期结果。 + +第二个场合是需要动态`this`的时候,也不应使用箭头函数。 + +```javascript +var button = document.getElementById('press'); +button.addEventListener('click', () => { + this.classList.toggle('on'); +}); +``` + +上面代码运行时,点击按钮会报错,因为`button`的监听函数是一个箭头函数,导致里面的`this`就是全局对象。如果改成普通函数,`this`就会动态指向被点击的按钮对象。 + +另外,如果函数体很复杂,有许多行,或者函数内部有大量的读写操作,不单纯是为了计算值,这时也不应该使用箭头函数,而是要使用普通函数,这样可以提高代码可读性。 ### 嵌套的箭头函数 -箭头函数内部,还可以再使用箭头函数。下面是一个ES5语法的多重嵌套函数。 +箭头函数内部,还可以再使用箭头函数。下面是一个 ES5 语法的多重嵌套函数。 ```javascript function insert(value) { @@ -1151,7 +934,7 @@ mult2(plus1(5)) // 12 ``` -箭头函数还有一个功能,就是可以很方便地改写λ演算。 +箭头函数还有一个功能,就是可以很方便地改写 λ 演算。 ```javascript // λ演算的写法 @@ -1162,13 +945,13 @@ var fix = f => (x => f(v => x(x)(v))) (x => f(v => x(x)(v))); ``` -上面两种写法,几乎是一一对应的。由于λ演算对于计算机科学非常重要,这使得我们可以用ES6作为替代工具,探索计算机科学。 +上面两种写法,几乎是一一对应的。由于 λ 演算对于计算机科学非常重要,这使得我们可以用 ES6 作为替代工具,探索计算机科学。 -## 绑定 this +## 双冒号运算符 -箭头函数可以绑定`this`对象,大大减少了显式绑定`this`对象的写法(`call`、`apply`、`bind`)。但是,箭头函数并不适用于所有场合,所以ES7提出了“函数绑定”(function bind)运算符,用来取代`call`、`apply`、`bind`调用。虽然该语法还是ES7的一个[提案](https://github.com/zenparsing/es-function-bind),但是Babel转码器已经支持。 +箭头函数可以绑定`this`对象,大大减少了显式绑定`this`对象的写法(`call`、`apply`、`bind`)。但是,箭头函数并不适用于所有场合,所以现在有一个[提案](https://github.com/zenparsing/es-function-bind),提出了“函数绑定”(function bind)运算符,用来取代`call`、`apply`、`bind`调用。 -函数绑定运算符是并排的两个双冒号(::),双冒号左边是一个对象,右边是一个函数。该运算符会自动将左边的对象,作为上下文环境(即this对象),绑定到右边的函数上面。 +函数绑定运算符是并排的两个冒号(`::`),双冒号左边是一个对象,右边是一个函数。该运算符会自动将左边的对象,作为上下文环境(即`this`对象),绑定到右边的函数上面。 ```javascript foo::bar; @@ -1197,23 +980,15 @@ let log = ::console.log; var log = console.log.bind(console); ``` -由于双冒号运算符返回的还是原对象,因此可以采用链式写法。 +如果双冒号运算符的运算结果,还是一个对象,就可以采用链式写法。 ```javascript -// 例一 import { map, takeWhile, forEach } from "iterlib"; getPlayers() ::map(x => x.character()) ::takeWhile(x => x.strength > 100) ::forEach(x => console.log(x)); - -// 例二 -let { find, html } = jake; - -document.querySelectorAll("div.myClass") -::find("p") -::html("hahaha"); ``` ## 尾调用优化 @@ -1228,7 +1003,7 @@ function f(x){ } ``` -上面代码中,函数f的最后一步是调用函数g,这就叫尾调用。 +上面代码中,函数`f`的最后一步是调用函数`g`,这就叫尾调用。 以下三种情况,都不属于尾调用。 @@ -1250,7 +1025,7 @@ function f(x){ } ``` -上面代码中,情况一是调用函数g之后,还有赋值操作,所以不属于尾调用,即使语义完全一样。情况二也属于调用后还有操作,即使写在一行内。情况三等同于下面的代码。 +上面代码中,情况一是调用函数`g`之后,还有赋值操作,所以不属于尾调用,即使语义完全一样。情况二也属于调用后还有操作,即使写在一行内。情况三等同于下面的代码。 ```javascript function f(x){ @@ -1270,13 +1045,13 @@ function f(x) { } ``` -上面代码中,函数m和n都属于尾调用,因为它们都是函数f的最后一步操作。 +上面代码中,函数`m`和`n`都属于尾调用,因为它们都是函数`f`的最后一步操作。 ### 尾调用优化 尾调用之所以与其他调用不同,就在于它的特殊的调用位置。 -我们知道,函数调用会在内存形成一个“调用记录”,又称“调用帧”(call frame),保存调用位置和内部变量等信息。如果在函数A的内部调用函数B,那么在A的调用帧上方,还会形成一个B的调用帧。等到B运行结束,将结果返回到A,B的调用帧才会消失。如果函数B内部还调用函数C,那就还有一个C的调用帧,以此类推。所有的调用帧,就形成一个“调用栈”(call stack)。 +我们知道,函数调用会在内存形成一个“调用记录”,又称“调用帧”(call frame),保存调用位置和内部变量等信息。如果在函数`A`的内部调用函数`B`,那么在`A`的调用帧上方,还会形成一个`B`的调用帧。等到`B`运行结束,将结果返回到`A`,`B`的调用帧才会消失。如果函数`B`内部还调用函数`C`,那就还有一个`C`的调用帧,以此类推。所有的调用帧,就形成一个“调用栈”(call stack)。 尾调用由于是函数的最后一步操作,所以不需要保留外层函数的调用帧,因为调用位置、内部变量等信息都不会再用到了,只要直接用内层函数的调用帧,取代外层函数的调用帧就可以了。 @@ -1298,7 +1073,7 @@ f(); g(3); ``` -上面代码中,如果函数g不是尾调用,函数f就需要保存内部变量m和n的值、g的调用位置等信息。但由于调用g之后,函数f就结束了,所以执行到最后一步,完全可以删除 f(x) 的调用帧,只保留 g(3) 的调用帧。 +上面代码中,如果函数`g`不是尾调用,函数`f`就需要保存内部变量`m`和`n`的值、`g`的调用位置等信息。但由于调用`g`之后,函数`f`就结束了,所以执行到最后一步,完全可以删除`f(x)`的调用帧,只保留`g(3)`的调用帧。 这就叫做“尾调用优化”(Tail call optimization),即只保留内层函数的调用帧。如果所有函数都是尾调用,那么完全可以做到每次执行时,调用帧只有一项,这将大大节省内存。这就是“尾调用优化”的意义。 @@ -1331,7 +1106,7 @@ function factorial(n) { factorial(5) // 120 ``` -上面代码是一个阶乘函数,计算n的阶乘,最多需要保存n个调用记录,复杂度 O(n) 。 +上面代码是一个阶乘函数,计算`n`的阶乘,最多需要保存`n`个调用记录,复杂度 O(n) 。 如果改写成尾递归,只保留一个调用记录,复杂度 O(1) 。 @@ -1344,9 +1119,9 @@ function factorial(n, total) { factorial(5, 1) // 120 ``` -还有一个比较著名的例子,就是计算fibonacci 数列,也能充分说明尾递归优化的重要性 +还有一个比较著名的例子,就是计算 Fibonacci 数列,也能充分说明尾递归优化的重要性。 -如果是非尾递归的fibonacci 递归方法 +非尾递归的 Fibonacci 数列实现如下。 ```javascript function Fibonacci (n) { @@ -1355,13 +1130,12 @@ function Fibonacci (n) { return Fibonacci(n - 1) + Fibonacci(n - 2); } -Fibonacci(10); // 89 -// Fibonacci(100) -// Fibonacci(500) -// 堆栈溢出了 +Fibonacci(10) // 89 +Fibonacci(100) // 堆栈溢出 +Fibonacci(500) // 堆栈溢出 ``` -如果我们使用尾递归优化过的fibonacci 递归算法 +尾递归优化过的 Fibonacci 数列实现如下。 ```javascript function Fibonacci2 (n , ac1 = 1 , ac2 = 1) { @@ -1375,11 +1149,11 @@ Fibonacci2(1000) // 7.0330367711422765e+208 Fibonacci2(10000) // Infinity ``` -由此可见,“尾调用优化”对递归操作意义重大,所以一些函数式编程语言将其写入了语言规格。ES6也是如此,第一次明确规定,所有ECMAScript的实现,都必须部署“尾调用优化”。这就是说,在ES6中,只要使用尾递归,就不会发生栈溢出,相对节省内存。 +由此可见,“尾调用优化”对递归操作意义重大,所以一些函数式编程语言将其写入了语言规格。ES6 亦是如此,第一次明确规定,所有 ECMAScript 的实现,都必须部署“尾调用优化”。这就是说,ES6 中只要使用尾递归,就不会发生栈溢出,相对节省内存。 ### 递归函数的改写 -尾递归的实现,往往需要改写递归函数,确保最后一步只调用自身。做到这一点的方法,就是把所有用到的内部变量改写成函数的参数。比如上面的例子,阶乘函数 factorial 需要用到一个中间变量 total ,那就把这个中间变量改写成函数的参数。这样做的缺点就是不太直观,第一眼很难看出来,为什么计算5的阶乘,需要传入两个参数5和1? +尾递归的实现,往往需要改写递归函数,确保最后一步只调用自身。做到这一点的方法,就是把所有用到的内部变量改写成函数的参数。比如上面的例子,阶乘函数 factorial 需要用到一个中间变量`total`,那就把这个中间变量改写成函数的参数。这样做的缺点就是不太直观,第一眼很难看出来,为什么计算`5`的阶乘,需要传入两个参数`5`和`1`? 两个方法可以解决这个问题。方法一是在尾递归函数之外,再提供一个正常形式的函数。 @@ -1396,7 +1170,7 @@ function factorial(n) { factorial(5) // 120 ``` -上面代码通过一个正常形式的阶乘函数 factorial ,调用尾递归函数 tailFactorial ,看起来就正常多了。 +上面代码通过一个正常形式的阶乘函数`factorial`,调用尾递归函数`tailFactorial`,看起来就正常多了。 函数式编程有一个概念,叫做柯里化(currying),意思是将多参数的函数转换成单参数的形式。这里也可以使用柯里化。 @@ -1417,9 +1191,9 @@ const factorial = currying(tailFactorial, 1); factorial(5) // 120 ``` -上面代码通过柯里化,将尾递归函数 tailFactorial 变为只接受1个参数的 factorial 。 +上面代码通过柯里化,将尾递归函数`tailFactorial`变为只接受一个参数的`factorial`。 -第二种方法就简单多了,就是采用ES6的函数默认值。 +第二种方法就简单多了,就是采用 ES6 的函数默认值。 ```javascript function factorial(n, total = 1) { @@ -1430,13 +1204,13 @@ function factorial(n, total = 1) { factorial(5) // 120 ``` -上面代码中,参数 total 有默认值1,所以调用时不用提供这个值。 +上面代码中,参数`total`有默认值`1`,所以调用时不用提供这个值。 -总结一下,递归本质上是一种循环操作。纯粹的函数式编程语言没有循环操作命令,所有的循环都用递归实现,这就是为什么尾递归对这些语言极其重要。对于其他支持“尾调用优化”的语言(比如Lua,ES6),只需要知道循环可以用递归代替,而一旦使用递归,就最好使用尾递归。 +总结一下,递归本质上是一种循环操作。纯粹的函数式编程语言没有循环操作命令,所有的循环都用递归实现,这就是为什么尾递归对这些语言极其重要。对于其他支持“尾调用优化”的语言(比如 Lua,ES6),只需要知道循环可以用递归代替,而一旦使用递归,就最好使用尾递归。 ### 严格模式 -ES6的尾调用优化只在严格模式下开启,正常模式是无效的。 +ES6 的尾调用优化只在严格模式下开启,正常模式是无效的。 这是因为在正常模式下,函数内部有两个变量,可以跟踪函数的调用栈。 @@ -1447,7 +1221,7 @@ ES6的尾调用优化只在严格模式下开启,正常模式是无效的。 ```javascript function restricted() { - "use strict"; + 'use strict'; restricted.caller; // 报错 restricted.arguments; // 报错 } @@ -1475,7 +1249,7 @@ sum(1, 100000) // Uncaught RangeError: Maximum call stack size exceeded(…) ``` -上面代码中,`sum`是一个递归函数,参数`x`是需要累加的值,参数`y`控制递归次数。一旦指定`sum`递归100000次,就会报错,提示超出调用栈的最大次数。 +上面代码中,`sum`是一个递归函数,参数`x`是需要累加的值,参数`y`控制递归次数。一旦指定`sum`递归 100000 次,就会报错,提示超出调用栈的最大次数。 蹦床函数(trampoline)可以将递归执行转为循环执行。 @@ -1582,4 +1356,3 @@ clownsEverywhere( ``` 这样的规定也使得,函数参数与数组和对象的尾逗号规则,保持一致了。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/generator-async.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/generator-async.md" old mode 100644 new mode 100755 similarity index 88% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/generator-async.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/generator-async.md" index 79939971c..0c96df89b --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/generator-async.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/generator-async.md" @@ -1,6 +1,6 @@ # Generator 函数的异步应用 -异步编程对 JavaScript 语言太重要。Javascript 语言的执行环境是“单线程”的,如果没有异步编程,根本没法用,非卡死不可。本章主要介绍 Generator 函数如何完成异步操作。 +异步编程对 JavaScript 语言太重要。JavaScript 语言的执行环境是“单线程”的,如果没有异步编程,根本没法用,非卡死不可。本章主要介绍 Generator 函数如何完成异步操作。 ## 传统方法 @@ -102,7 +102,7 @@ Promise 的最大问题是代码冗余,原来的任务被 Promise 包装了一 举例来说,读取文件的协程写法如下。 ```javascript -function *asyncJob() { +function* asyncJob() { // ...其他代码 var f = yield readFile(fileA); // ...其他代码 @@ -138,7 +138,7 @@ g.next() // { value: undefined, done: true } Generator 函数可以暂停执行和恢复执行,这是它能封装异步任务的根本原因。除此之外,它还有两个特性,使它可以作为异步编程的完整解决方案:函数体内外的数据交换和错误处理机制。 -`next`法返回值的value属性,是 Generator 函数向外输出数据;`next`方法还可以接受参数,向 Generator 函数体内输入数据。 +`next`返回值的 value 属性,是 Generator 函数向外输出数据;`next`方法还可以接受参数,向 Generator 函数体内输入数据。 ```javascript function* gen(x){ @@ -151,7 +151,7 @@ g.next() // { value: 3, done: false } g.next(2) // { value: 2, done: true } ``` -上面代码中,第一`next`方法的`value`属性,返回表达式`x + 2`的值`3`。第二个`next`方法带有参数`2`,这个参数可以传入 Generator 函数,作为上个阶段异步任务的返回结果,被函数体内的变量`y`接收。因此,这一步的`value`属性,返回的就是`2`(变量`y`的值)。 +上面代码中,第一个`next`方法的`value`属性,返回表达式`x + 2`的值`3`。第二个`next`方法带有参数`2`,这个参数可以传入 Generator 函数,作为上个阶段异步任务的返回结果,被函数体内的变量`y`接收。因此,这一步的`value`属性,返回的就是`2`(变量`y`的值)。 Generator 函数内部还可以部署错误处理代码,捕获函数体外抛出的错误。 @@ -212,14 +212,14 @@ Thunk 函数是自动执行 Generator 函数的一种方法。 ### 参数的求值策略 -Thunk 函数早在上个世纪60年代就诞生了。 +Thunk 函数早在上个世纪 60 年代就诞生了。 那时,编程语言刚刚起步,计算机学家还在研究,编译器怎么写比较好。一个争论的焦点是"求值策略",即函数的参数到底应该何时求值。 ```javascript var x = 1; -function f(m){ +function f(m) { return m * 2; } @@ -228,7 +228,7 @@ f(x + 5) 上面代码先定义函数`f`,然后向它传入表达式`x + 5`。请问,这个表达式应该何时求值? -一种意见是"传值调用"(call by value),即在进入函数体之前,就计算`x + 5`的值(等于6),再将这个值传入函数`f`。C语言就采用这种策略。 +一种意见是"传值调用"(call by value),即在进入函数体之前,就计算`x + 5`的值(等于 6),再将这个值传入函数`f`。C 语言就采用这种策略。 ```javascript f(x + 5) @@ -280,7 +280,7 @@ function f(thunk) { } ``` -上面代码中,函数f的参数`x + 5`被一个函数替换了。凡是用到原参数的地方,对`Thunk`函数求值即可。 +上面代码中,函数 f 的参数`x + 5`被一个函数替换了。凡是用到原参数的地方,对`Thunk`函数求值即可。 这就是 Thunk 函数的定义,它是“传名调用”的一种实现策略,用来替换某个表达式。 @@ -320,7 +320,7 @@ var Thunk = function(fn){ }; // ES6版本 -var Thunk = function(fn) { +const Thunk = function(fn) { return function (...args) { return function (callback) { return fn.call(this, ...args, callback); @@ -342,10 +342,9 @@ readFileThunk(fileA)(callback); function f(a, cb) { cb(a); } -let ft = Thunk(f); +const ft = Thunk(f); -let log = console.log.bind(console); -ft(1)(log) // 1 +ft(1)(console.log) // 1 ``` ### Thunkify 模块 @@ -507,10 +506,10 @@ run(g); ```javascript var g = function* (){ - var f1 = yield readFile('fileA'); - var f2 = yield readFile('fileB'); + var f1 = yield readFileThunk('fileA'); + var f2 = yield readFileThunk('fileB'); // ... - var fn = yield readFile('fileN'); + var fn = yield readFileThunk('fileN'); }; run(g); @@ -524,7 +523,7 @@ Thunk 函数并不是 Generator 函数自动执行的唯一方案。因为自动 ### 基本用法 -[co 模块](https://github.com/tj/co)是著名程序员 TJ Holowaychuk 于2013年6月发布的一个小工具,用于 Generator 函数的自动执行。 +[co 模块](https://github.com/tj/co)是著名程序员 TJ Holowaychuk 于 2013 年 6 月发布的一个小工具,用于 Generator 函数的自动执行。 下面是一个 Generator 函数,用于依次读取两个文件。 @@ -544,9 +543,9 @@ var co = require('co'); co(gen); ``` -上面代码中,Generator函数只要传入`co`函数,就会自动执行。 +上面代码中,Generator 函数只要传入`co`函数,就会自动执行。 -`co`函数返回一个Promise对象,因此可以用`then`方法添加回调函数。 +`co`函数返回一个`Promise`对象,因此可以用`then`方法添加回调函数。 ```javascript co(gen).then(function (){ @@ -568,7 +567,7 @@ co(gen).then(function (){ (2)Promise 对象。将异步操作包装成 Promise 对象,用`then`方法交回执行权。 -co 模块其实就是将两种自动执行器(Thunk 函数和 Promise 对象),包装成一个模块。使用 co 的前提条件是,Generator 函数的`yield`命令后面,只能是 Thunk 函数或 Promise 对象。如果数组或对象的成员,全部都是 Promise 对象,也是可以的,详见后文的例子。(4.0 版以后,`yield`命令后面只能是 Promise 对象。) +co 模块其实就是将两种自动执行器(Thunk 函数和 Promise 对象),包装成一个模块。使用 co 的前提条件是,Generator 函数的`yield`命令后面,只能是 Thunk 函数或 Promise 对象。如果数组或对象的成员,全部都是 Promise 对象,也可以使用 co,详见后文的例子。 上一节已经介绍了基于 Thunk 函数的自动执行器。下面来看,基于 Promise 对象的自动执行器。这是理解 co 模块必须的。 @@ -752,3 +751,40 @@ function* somethingAsync(x) { 上面的代码允许并发三个`somethingAsync`异步操作,等到它们全部完成,才会进行下一步。 +### 实例:处理 Stream + +Node 提供 Stream 模式读写数据,特点是一次只处理数据的一部分,数据分成一块块依次处理,就好像“数据流”一样。这对于处理大规模数据非常有利。Stream 模式使用 EventEmitter API,会释放三个事件。 + +- `data`事件:下一块数据块已经准备好了。 +- `end`事件:整个“数据流”处理完了。 +- `error`事件:发生错误。 + +使用`Promise.race()`函数,可以判断这三个事件之中哪一个最先发生,只有当`data`事件最先发生时,才进入下一个数据块的处理。从而,我们可以通过一个`while`循环,完成所有数据的读取。 + +```javascript +const co = require('co'); +const fs = require('fs'); + +const stream = fs.createReadStream('./les_miserables.txt'); +let valjeanCount = 0; + +co(function*() { + while(true) { + const res = yield Promise.race([ + new Promise(resolve => stream.once('data', resolve)), + new Promise(resolve => stream.once('end', resolve)), + new Promise((resolve, reject) => stream.once('error', reject)) + ]); + if (!res) { + break; + } + stream.removeAllListeners('data'); + stream.removeAllListeners('end'); + stream.removeAllListeners('error'); + valjeanCount += (res.toString().match(/valjean/ig) || []).length; + } + console.log('count:', valjeanCount); // count: 1120 +}); +``` + +上面代码采用 Stream 模式读取《悲惨世界》的文本文件,对于每个数据块都使用`stream.once`方法,在`data`、`end`、`error`三个事件上添加一次性回调函数。变量`res`只有在`data`事件发生时才有值,然后累加每个数据块之中`valjean`这个词出现的次数。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/generator.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/generator.md" old mode 100644 new mode 100755 similarity index 53% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/generator.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/generator.md" index b2b388aaf..7b659d97d --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/generator.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/generator.md" @@ -4,13 +4,13 @@ ### 基本概念 -Generator 函数是 ES6 提供的一种异步编程解决方案,语法行为与传统函数完全不同。本章详细介绍Generator 函数的语法和 API,它的异步编程应用请看《Generator 函数的异步应用》一章。 +Generator 函数是 ES6 提供的一种异步编程解决方案,语法行为与传统函数完全不同。本章详细介绍 Generator 函数的语法和 API,它的异步编程应用请看《Generator 函数的异步应用》一章。 -Generator 函数有多种理解角度。从语法上,首先可以把它理解成,Generator 函数是一个状态机,封装了多个内部状态。 +Generator 函数有多种理解角度。语法上,首先可以把它理解成,Generator 函数是一个状态机,封装了多个内部状态。 执行 Generator 函数会返回一个遍历器对象,也就是说,Generator 函数除了状态机,还是一个遍历器对象生成函数。返回的遍历器对象,可以依次遍历 Generator 函数内部的每一个状态。 -形式上,Generator 函数是一个普通函数,但是有两个特征。一是,`function`关键字与函数名之间有一个星号;二是,函数体内部使用`yield`语句,定义不同的内部状态(`yield`在英语里的意思就是“产出”)。 +形式上,Generator 函数是一个普通函数,但是有两个特征。一是,`function`关键字与函数名之间有一个星号;二是,函数体内部使用`yield`表达式,定义不同的内部状态(`yield`在英语里的意思就是“产出”)。 ```javascript function* helloWorldGenerator() { @@ -22,11 +22,11 @@ function* helloWorldGenerator() { var hw = helloWorldGenerator(); ``` -上面代码定义了一个Generator函数`helloWorldGenerator`,它内部有两个`yield`语句“hello”和“world”,即该函数有三个状态:hello,world和return语句(结束执行)。 +上面代码定义了一个 Generator 函数`helloWorldGenerator`,它内部有两个`yield`表达式(`hello`和`world`),即该函数有三个状态:hello,world 和 return 语句(结束执行)。 -然后,Generator函数的调用方法与普通函数一样,也是在函数名后面加上一对圆括号。不同的是,调用Generator函数后,该函数并不执行,返回的也不是函数运行结果,而是一个指向内部状态的指针对象,也就是上一章介绍的遍历器对象(Iterator Object)。 +然后,Generator 函数的调用方法与普通函数一样,也是在函数名后面加上一对圆括号。不同的是,调用 Generator 函数后,该函数并不执行,返回的也不是函数运行结果,而是一个指向内部状态的指针对象,也就是上一章介绍的遍历器对象(Iterator Object)。 -下一步,必须调用遍历器对象的next方法,使得指针移向下一个状态。也就是说,每次调用`next`方法,内部指针就从函数头部或上一次停下来的地方开始执行,直到遇到下一个`yield`语句(或`return`语句)为止。换言之,Generator函数是分段执行的,`yield`语句是暂停执行的标记,而`next`方法可以恢复执行。 +下一步,必须调用遍历器对象的`next`方法,使得指针移向下一个状态。也就是说,每次调用`next`方法,内部指针就从函数头部或上一次停下来的地方开始执行,直到遇到下一个`yield`表达式(或`return`语句)为止。换言之,Generator 函数是分段执行的,`yield`表达式是暂停执行的标记,而`next`方法可以恢复执行。 ```javascript hw.next() @@ -44,45 +44,42 @@ hw.next() 上面代码一共调用了四次`next`方法。 -第一次调用,Generator函数开始执行,直到遇到第一个`yield`语句为止。`next`方法返回一个对象,它的`value`属性就是当前`yield`语句的值hello,`done`属性的值false,表示遍历还没有结束。 +第一次调用,Generator 函数开始执行,直到遇到第一个`yield`表达式为止。`next`方法返回一个对象,它的`value`属性就是当前`yield`表达式的值`hello`,`done`属性的值`false`,表示遍历还没有结束。 -第二次调用,Generator函数从上次`yield`语句停下的地方,一直执行到下一个`yield`语句。`next`方法返回的对象的`value`属性就是当前`yield`语句的值world,`done`属性的值false,表示遍历还没有结束。 +第二次调用,Generator 函数从上次`yield`表达式停下的地方,一直执行到下一个`yield`表达式。`next`方法返回的对象的`value`属性就是当前`yield`表达式的值`world`,`done`属性的值`false`,表示遍历还没有结束。 -第三次调用,Generator函数从上次`yield`语句停下的地方,一直执行到`return`语句(如果没有return语句,就执行到函数结束)。`next`方法返回的对象的`value`属性,就是紧跟在`return`语句后面的表达式的值(如果没有`return`语句,则`value`属性的值为undefined),`done`属性的值true,表示遍历已经结束。 +第三次调用,Generator 函数从上次`yield`表达式停下的地方,一直执行到`return`语句(如果没有`return`语句,就执行到函数结束)。`next`方法返回的对象的`value`属性,就是紧跟在`return`语句后面的表达式的值(如果没有`return`语句,则`value`属性的值为`undefined`),`done`属性的值`true`,表示遍历已经结束。 -第四次调用,此时Generator函数已经运行完毕,`next`方法返回对象的`value`属性为undefined,`done`属性为true。以后再调用`next`方法,返回的都是这个值。 +第四次调用,此时 Generator 函数已经运行完毕,`next`方法返回对象的`value`属性为`undefined`,`done`属性为`true`。以后再调用`next`方法,返回的都是这个值。 -总结一下,调用Generator函数,返回一个遍历器对象,代表Generator函数的内部指针。以后,每次调用遍历器对象的`next`方法,就会返回一个有着`value`和`done`两个属性的对象。`value`属性表示当前的内部状态的值,是`yield`语句后面那个表达式的值;`done`属性是一个布尔值,表示是否遍历结束。 +总结一下,调用 Generator 函数,返回一个遍历器对象,代表 Generator 函数的内部指针。以后,每次调用遍历器对象的`next`方法,就会返回一个有着`value`和`done`两个属性的对象。`value`属性表示当前的内部状态的值,是`yield`表达式后面那个表达式的值;`done`属性是一个布尔值,表示是否遍历结束。 -ES6没有规定,`function`关键字与函数名之间的星号,写在哪个位置。这导致下面的写法都能通过。 +ES6 没有规定,`function`关键字与函数名之间的星号,写在哪个位置。这导致下面的写法都能通过。 ```javascript function * foo(x, y) { ··· } - function *foo(x, y) { ··· } - function* foo(x, y) { ··· } - function*foo(x, y) { ··· } ``` -由于Generator函数仍然是普通函数,所以一般的写法是上面的第三种,即星号紧跟在`function`关键字后面。本书也采用这种写法。 +由于 Generator 函数仍然是普通函数,所以一般的写法是上面的第三种,即星号紧跟在`function`关键字后面。本书也采用这种写法。 -### yield语句 +### yield 表达式 -由于Generator函数返回的遍历器对象,只有调用`next`方法才会遍历下一个内部状态,所以其实提供了一种可以暂停执行的函数。`yield`语句就是暂停标志。 +由于 Generator 函数返回的遍历器对象,只有调用`next`方法才会遍历下一个内部状态,所以其实提供了一种可以暂停执行的函数。`yield`表达式就是暂停标志。 遍历器对象的`next`方法的运行逻辑如下。 -(1)遇到`yield`语句,就暂停执行后面的操作,并将紧跟在`yield`后面的那个表达式的值,作为返回的对象的`value`属性值。 +(1)遇到`yield`表达式,就暂停执行后面的操作,并将紧跟在`yield`后面的那个表达式的值,作为返回的对象的`value`属性值。 -(2)下一次调用`next`方法时,再继续往下执行,直到遇到下一个`yield`语句。 +(2)下一次调用`next`方法时,再继续往下执行,直到遇到下一个`yield`表达式。 -(3)如果没有再遇到新的`yield`语句,就一直运行到函数结束,直到`return`语句为止,并将`return`语句后面的表达式的值,作为返回的对象的`value`属性值。 +(3)如果没有再遇到新的`yield`表达式,就一直运行到函数结束,直到`return`语句为止,并将`return`语句后面的表达式的值,作为返回的对象的`value`属性值。 (4)如果该函数没有`return`语句,则返回的对象的`value`属性值为`undefined`。 -需要注意的是,`yield`语句后面的表达式,只有当调用`next`方法、内部指针指向该语句时才会执行,因此等于为JavaScript提供了手动的“惰性求值”(Lazy Evaluation)的语法功能。 +需要注意的是,`yield`表达式后面的表达式,只有当调用`next`方法、内部指针指向该语句时才会执行,因此等于为 JavaScript 提供了手动的“惰性求值”(Lazy Evaluation)的语法功能。 ```javascript function* gen() { @@ -90,11 +87,11 @@ function* gen() { } ``` -上面代码中,yield后面的表达式`123 + 456`,不会立即求值,只会在`next`方法将指针移到这一句时,才会求值。 +上面代码中,`yield`后面的表达式`123 + 456`,不会立即求值,只会在`next`方法将指针移到这一句时,才会求值。 -`yield`语句与`return`语句既有相似之处,也有区别。相似之处在于,都能返回紧跟在语句后面的那个表达式的值。区别在于每次遇到`yield`,函数暂停执行,下一次再从该位置继续向后执行,而`return`语句不具备位置记忆的功能。一个函数里面,只能执行一次(或者说一个)`return`语句,但是可以执行多次(或者说多个)`yield`语句。正常函数只能返回一个值,因为只能执行一次`return`;Generator函数可以返回一系列的值,因为可以有任意多个`yield`。从另一个角度看,也可以说Generator生成了一系列的值,这也就是它的名称的来历(在英语中,generator这个词是“生成器”的意思)。 +`yield`表达式与`return`语句既有相似之处,也有区别。相似之处在于,都能返回紧跟在语句后面的那个表达式的值。区别在于每次遇到`yield`,函数暂停执行,下一次再从该位置继续向后执行,而`return`语句不具备位置记忆的功能。一个函数里面,只能执行一次(或者说一个)`return`语句,但是可以执行多次(或者说多个)`yield`表达式。正常函数只能返回一个值,因为只能执行一次`return`;Generator 函数可以返回一系列的值,因为可以有任意多个`yield`。从另一个角度看,也可以说 Generator 生成了一系列的值,这也就是它的名称的来历(英语中,generator 这个词是“生成器”的意思)。 -Generator函数可以不用`yield`语句,这时就变成了一个单纯的暂缓执行函数。 +Generator 函数可以不用`yield`表达式,这时就变成了一个单纯的暂缓执行函数。 ```javascript function* f() { @@ -110,7 +107,7 @@ setTimeout(function () { 上面代码中,函数`f`如果是普通函数,在为变量`generator`赋值时就会执行。但是,函数`f`是一个 Generator 函数,就变成只有调用`next`方法时,函数`f`才会执行。 -另外需要注意,`yield`语句只能用在 Generator 函数里面,用在其他地方都会报错。 +另外需要注意,`yield`表达式只能用在 Generator 函数里面,用在其他地方都会报错。 ```javascript (function (){ @@ -119,7 +116,7 @@ setTimeout(function () { // SyntaxError: Unexpected number ``` -上面代码在一个普通函数中使用`yield`语句,结果产生一个句法错误。 +上面代码在一个普通函数中使用`yield`表达式,结果产生一个句法错误。 下面是另外一个例子。 @@ -133,7 +130,7 @@ var flat = function* (a) { } else { yield item; } - } + }); }; for (var f of flat(arr)){ @@ -141,7 +138,7 @@ for (var f of flat(arr)){ } ``` -上面代码也会产生句法错误,因为`forEach`方法的参数是一个普通函数,但是在里面使用了`yield`语句(这个函数里面还使用了`yield*`语句,详细介绍见后文)。一种修改方法是改用`for`循环。 +上面代码也会产生句法错误,因为`forEach`方法的参数是一个普通函数,但是在里面使用了`yield`表达式(这个函数里面还使用了`yield*`表达式,详细介绍见后文)。一种修改方法是改用`for`循环。 ```javascript var arr = [1, [[2, 3], 4], [5, 6]]; @@ -164,7 +161,7 @@ for (var f of flat(arr)) { // 1, 2, 3, 4, 5, 6 ``` -另外,`yield`语句如果用在一个表达式之中,必须放在圆括号里面。 +另外,`yield`表达式如果用在另一个表达式之中,必须放在圆括号里面。 ```javascript function* demo() { @@ -176,7 +173,7 @@ function* demo() { } ``` -`yield`语句用作函数参数或放在赋值表达式的右边,可以不加括号。 +`yield`表达式用作函数参数或放在赋值表达式的右边,可以不加括号。 ```javascript function* demo() { @@ -189,7 +186,7 @@ function* demo() { 上一章说过,任意一个对象的`Symbol.iterator`方法,等于该对象的遍历器生成函数,调用该函数会返回该对象的一个遍历器对象。 -由于Generator函数就是遍历器生成函数,因此可以把Generator赋值给对象的`Symbol.iterator`属性,从而使得该对象具有Iterator接口。 +由于 Generator 函数就是遍历器生成函数,因此可以把 Generator 赋值给对象的`Symbol.iterator`属性,从而使得该对象具有 Iterator 接口。 ```javascript var myIterable = {}; @@ -202,9 +199,9 @@ myIterable[Symbol.iterator] = function* () { [...myIterable] // [1, 2, 3] ``` -上面代码中,Generator函数赋值给`Symbol.iterator`属性,从而使得`myIterable`对象具有了Iterator接口,可以被`...`运算符遍历了。 +上面代码中,Generator 函数赋值给`Symbol.iterator`属性,从而使得`myIterable`对象具有了 Iterator 接口,可以被`...`运算符遍历了。 -Generator函数执行后,返回一个遍历器对象。该对象本身也具有`Symbol.iterator`属性,执行后返回自身。 +Generator 函数执行后,返回一个遍历器对象。该对象本身也具有`Symbol.iterator`属性,执行后返回自身。 ```javascript function* gen(){ @@ -217,11 +214,11 @@ g[Symbol.iterator]() === g // true ``` -上面代码中,`gen`是一个Generator函数,调用它会生成一个遍历器对象`g`。它的`Symbol.iterator`属性,也是一个遍历器对象生成函数,执行后返回它自己。 +上面代码中,`gen`是一个 Generator 函数,调用它会生成一个遍历器对象`g`。它的`Symbol.iterator`属性,也是一个遍历器对象生成函数,执行后返回它自己。 -## next方法的参数 +## next 方法的参数 -`yield`句本身没有返回值,或者说总是返回`undefined`。`next`方法可以带一个参数,该参数就会被当作上一个`yield`语句的返回值。 +`yield`表达式本身没有返回值,或者说总是返回`undefined`。`next`方法可以带一个参数,该参数就会被当作上一个`yield`表达式的返回值。 ```javascript function* f() { @@ -238,7 +235,7 @@ g.next() // { value: 1, done: false } g.next(true) // { value: 0, done: false } ``` -上面代码先定义了一个可以无限运行的 Generator 函数`f`,如果`next`方法没有参数,每次运行到`yield`语句,变量`reset`的值总是`undefined`。当`next`方法带一个参数`true`时,变量`reset`就被重置为这个参数(即`true`),因此`i`会等于`-1`,下一轮循环就会从`-1`开始递增。 +上面代码先定义了一个可以无限运行的 Generator 函数`f`,如果`next`方法没有参数,每次运行到`yield`表达式,变量`reset`的值总是`undefined`。当`next`方法带一个参数`true`时,变量`reset`就被重置为这个参数(即`true`),因此`i`会等于`-1`,下一轮循环就会从`-1`开始递增。 这个功能有很重要的语法意义。Generator 函数从暂停状态到恢复运行,它的上下文状态(context)是不变的。通过`next`方法的参数,就有办法在 Generator 函数开始运行之后,继续向函数体内部注入值。也就是说,可以在 Generator 函数运行的不同阶段,从外部向内部注入不同的值,从而调整函数行为。 @@ -262,13 +259,34 @@ b.next(12) // { value:8, done:false } b.next(13) // { value:42, done:true } ``` -上面代码中,第二次运行`next`方法的时候不带参数,导致y的值等于`2 * undefined`(即`NaN`),除以3以后还是`NaN`,因此返回对象的`value`属性也等于`NaN`。第三次运行`Next`方法的时候不带参数,所以`z`等于`undefined`,返回对象的`value`属性等于`5 + NaN + undefined`,即`NaN`。 +上面代码中,第二次运行`next`方法的时候不带参数,导致 y 的值等于`2 * undefined`(即`NaN`),除以 3 以后还是`NaN`,因此返回对象的`value`属性也等于`NaN`。第三次运行`Next`方法的时候不带参数,所以`z`等于`undefined`,返回对象的`value`属性等于`5 + NaN + undefined`,即`NaN`。 -如果向`next`方法提供参数,返回结果就完全不一样了。上面代码第一次调用`b`的`next`方法时,返回`x+1`的值6;第二次调用`next`方法,将上一次`yield`语句的值设为12,因此`y`等于24,返回`y / 3`的值8;第三次调用`next`方法,将上一次`yield`语句的值设为13,因此`z`等于13,这时`x`等于5,`y`等于24,所以`return`语句的值等于42。 +如果向`next`方法提供参数,返回结果就完全不一样了。上面代码第一次调用`b`的`next`方法时,返回`x+1`的值`6`;第二次调用`next`方法,将上一次`yield`表达式的值设为`12`,因此`y`等于`24`,返回`y / 3`的值`8`;第三次调用`next`方法,将上一次`yield`表达式的值设为`13`,因此`z`等于`13`,这时`x`等于`5`,`y`等于`24`,所以`return`语句的值等于`42`。 -注意,由于`next`方法的参数表示上一个`yield`语句的返回值,所以第一次使用`next`方法时,不能带有参数。V8引擎直接忽略第一次使用`next`方法时的参数,只有从第二次使用`next`方法开始,参数才是有效的。从语义上讲,第一个`next`方法用来启动遍历器对象,所以不用带有参数。 +注意,由于`next`方法的参数表示上一个`yield`表达式的返回值,所以在第一次使用`next`方法时,传递参数是无效的。V8 引擎直接忽略第一次使用`next`方法时的参数,只有从第二次使用`next`方法开始,参数才是有效的。从语义上讲,第一个`next`方法用来启动遍历器对象,所以不用带有参数。 -如果想要第一次调用`next`方法时,就能够输入值,可以在Generator函数外面再包一层。 +再看一个通过`next`方法的参数,向 Generator 函数内部输入值的例子。 + +```javascript +function* dataConsumer() { + console.log('Started'); + console.log(`1. ${yield}`); + console.log(`2. ${yield}`); + return 'result'; +} + +let genObj = dataConsumer(); +genObj.next(); +// Started +genObj.next('a') +// 1. a +genObj.next('b') +// 2. b +``` + +上面代码是一个很直观的例子,每次通过`next`方法向 Generator 函数输入值,然后打印出来。 + +如果想要第一次调用`next`方法时,就能够输入值,可以在 Generator 函数外面再包一层。 ```javascript function wrapper(generatorFunction) { @@ -288,35 +306,14 @@ wrapped().next('hello!') // First input: hello! ``` -上面代码中,Generator函数如果不用`wrapper`先包一层,是无法第一次调用`next`方法,就输入参数的。 +上面代码中,Generator 函数如果不用`wrapper`先包一层,是无法第一次调用`next`方法,就输入参数的。 -再看一个通过`next`方法的参数,向Generator函数内部输入值的例子。 +## for...of 循环 -```javascript -function* dataConsumer() { - console.log('Started'); - console.log(`1. ${yield}`); - console.log(`2. ${yield}`); - return 'result'; -} - -let genObj = dataConsumer(); -genObj.next(); -// Started -genObj.next('a') -// 1. a -genObj.next('b') -// 2. b -``` - -上面代码是一个很直观的例子,每次通过`next`方法向Generator函数输入值,然后打印出来。 - -## for...of循环 - -`for...of`循环可以自动遍历Generator函数时生成的`Iterator`对象,且此时不再需要调用`next`方法。 +`for...of`循环可以自动遍历 Generator 函数运行时生成的`Iterator`对象,且此时不再需要调用`next`方法。 ```javascript -function *foo() { +function* foo() { yield 1; yield 2; yield 3; @@ -331,16 +328,16 @@ for (let v of foo()) { // 1 2 3 4 5 ``` -上面代码使用`for...of`循环,依次显示5个`yield`语句的值。这里需要注意,一旦`next`方法的返回对象的`done`属性为`true`,`for...of`循环就会中止,且不包含该返回对象,所以上面代码的`return`语句返回的6,不包括在`for...of`循环之中。 +上面代码使用`for...of`循环,依次显示 5 个`yield`表达式的值。这里需要注意,一旦`next`方法的返回对象的`done`属性为`true`,`for...of`循环就会中止,且不包含该返回对象,所以上面代码的`return`语句返回的`6`,不包括在`for...of`循环之中。 -下面是一个利用Generator函数和`for...of`循环,实现斐波那契数列的例子。 +下面是一个利用 Generator 函数和`for...of`循环,实现斐波那契数列的例子。 ```javascript function* fibonacci() { let [prev, curr] = [0, 1]; for (;;) { - [prev, curr] = [curr, prev + curr]; yield curr; + [prev, curr] = [curr, prev + curr]; } } @@ -352,7 +349,7 @@ for (let n of fibonacci()) { 从上面代码可见,使用`for...of`语句时不需要使用`next`方法。 -利用`for...of`循环,可以写出遍历任意对象(object)的方法。原生的JavaScript对象没有遍历接口,无法使用`for...of`循环,通过Generator函数为它加上这个接口,就可以用了。 +利用`for...of`循环,可以写出遍历任意对象(object)的方法。原生的 JavaScript 对象没有遍历接口,无法使用`for...of`循环,通过 Generator 函数为它加上这个接口,就可以用了。 ```javascript function* objectEntries(obj) { @@ -372,7 +369,7 @@ for (let [key, value] of objectEntries(jane)) { // last: Doe ``` -上面代码中,对象`jane`原生不具备Iterator接口,无法用`for...of`遍历。这时,我们通过Generator函数`objectEntries`为它加上遍历器接口,就可以用`for...of`遍历了。加上遍历器接口的另一种写法是,将Generator函数加到对象的`Symbol.iterator`属性上面。 +上面代码中,对象`jane`原生不具备 Iterator 接口,无法用`for...of`遍历。这时,我们通过 Generator 函数`objectEntries`为它加上遍历器接口,就可以用`for...of`遍历了。加上遍历器接口的另一种写法是,将 Generator 函数加到对象的`Symbol.iterator`属性上面。 ```javascript function* objectEntries() { @@ -394,7 +391,7 @@ for (let [key, value] of jane) { // last: Doe ``` -除了`for...of`循环以外,扩展运算符(`...`)、解构赋值和`Array.from`方法内部调用的,都是遍历器接口。这意味着,它们都可以将Generator函数返回的Iterator对象,作为参数。 +除了`for...of`循环以外,扩展运算符(`...`)、解构赋值和`Array.from`方法内部调用的,都是遍历器接口。这意味着,它们都可以将 Generator 函数返回的 Iterator 对象,作为参数。 ```javascript function* numbers () { @@ -425,7 +422,7 @@ for (let n of numbers()) { ## Generator.prototype.throw() -Generator函数返回的遍历器对象,都有一个`throw`方法,可以在函数体外抛出错误,然后在Generator函数体内捕获。 +Generator 函数返回的遍历器对象,都有一个`throw`方法,可以在函数体外抛出错误,然后在 Generator 函数体内捕获。 ```javascript var g = function* () { @@ -449,7 +446,7 @@ try { // 外部捕获 b ``` -上面代码中,遍历器对象`i`连续抛出两个错误。第一个错误被Generator函数体内的`catch`语句捕获。`i`第二次抛出错误,由于Generator函数内部的`catch`语句已经执行过了,不会再捕捉到这个错误了,所以这个错误就被抛出了Generator函数体,被函数体外的`catch`语句捕获。 +上面代码中,遍历器对象`i`连续抛出两个错误。第一个错误被 Generator 函数体内的`catch`语句捕获。`i`第二次抛出错误,由于 Generator 函数内部的`catch`语句已经执行过了,不会再捕捉到这个错误了,所以这个错误就被抛出了 Generator 函数体,被函数体外的`catch`语句捕获。 `throw`方法可以接受一个参数,该参数会被`catch`语句接收,建议抛出`Error`对象的实例。 @@ -496,7 +493,7 @@ try { 上面代码之所以只捕获了`a`,是因为函数体外的`catch`语句块,捕获了抛出的`a`错误以后,就不会再继续`try`代码块里面剩余的语句了。 -如果Generator函数内部没有部署`try...catch`代码块,那么`throw`方法抛出的错误,将被外部`try...catch`代码块捕获。 +如果 Generator 函数内部没有部署`try...catch`代码块,那么`throw`方法抛出的错误,将被外部`try...catch`代码块捕获。 ```javascript var g = function* () { @@ -518,9 +515,9 @@ try { // 外部捕获 a ``` -上面代码中,Generator函数`g`内部没有部署`try...catch`代码块,所以抛出的错误直接被外部`catch`代码块捕获。 +上面代码中,Generator 函数`g`内部没有部署`try...catch`代码块,所以抛出的错误直接被外部`catch`代码块捕获。 -如果Generator函数内部和外部,都没有部署`try...catch`代码块,那么程序将报错,直接中断执行。 +如果 Generator 函数内部和外部,都没有部署`try...catch`代码块,那么程序将报错,直接中断执行。 ```javascript var gen = function* gen(){ @@ -537,7 +534,25 @@ g.throw(); 上面代码中,`g.throw`抛出错误以后,没有任何`try...catch`代码块可以捕获这个错误,导致程序报错,中断执行。 -`throw`方法被捕获以后,会附带执行下一条`yield`语句。也就是说,会附带执行一次`next`方法。 +`throw`方法抛出的错误要被内部捕获,前提是必须至少执行过一次`next`方法。 + +```javascript +function* gen() { + try { + yield 1; + } catch (e) { + console.log('内部捕获'); + } +} + +var g = gen(); +g.throw(1); +// Uncaught 1 +``` + +上面代码中,`g.throw(1)`执行时,`next`方法一次都没有执行过。这时,抛出的错误不会被内部捕获,而是直接在外部抛出,导致程序出错。这种行为其实很好理解,因为第一次执行`next`方法,等同于启动执行 Generator 函数的内部代码,否则 Generator 函数还没有开始执行,这时`throw`方法抛错只可能抛出在函数外部。 + +`throw`方法被捕获以后,会附带执行下一条`yield`表达式。也就是说,会附带执行一次`next`方法。 ```javascript var gen = function* gen(){ @@ -556,7 +571,7 @@ g.throw() // b g.next() // c ``` -上面代码中,`g.throw`方法被捕获以后,自动执行了一次`next`方法,所以会打印`b`。另外,也可以看到,只要Generator函数内部部署了`try...catch`代码块,那么遍历器的`throw`方法抛出的错误,不影响下一次遍历。 +上面代码中,`g.throw`方法被捕获以后,自动执行了一次`next`方法,所以会打印`b`。另外,也可以看到,只要 Generator 函数内部部署了`try...catch`代码块,那么遍历器的`throw`方法抛出的错误,不影响下一次遍历。 另外,`throw`命令与`g.throw`方法是无关的,两者互不影响。 @@ -580,12 +595,12 @@ try { 上面代码中,`throw`命令抛出的错误不会影响到遍历器的状态,所以两次执行`next`方法,都进行了正确的操作。 -这种函数体内捕获错误的机制,大大方便了对错误的处理。多个`yield`语句,可以只用一个`try...catch`代码块来捕获错误。如果使用回调函数的写法,想要捕获多个错误,就不得不为每个函数内部写一个错误处理语句,现在只在Generator函数内部写一次`catch`语句就可以了。 +这种函数体内捕获错误的机制,大大方便了对错误的处理。多个`yield`表达式,可以只用一个`try...catch`代码块来捕获错误。如果使用回调函数的写法,想要捕获多个错误,就不得不为每个函数内部写一个错误处理语句,现在只在 Generator 函数内部写一次`catch`语句就可以了。 -Generator函数体外抛出的错误,可以在函数体内捕获;反过来,Generator函数体内抛出的错误,也可以被函数体外的`catch`捕获。 +Generator 函数体外抛出的错误,可以在函数体内捕获;反过来,Generator 函数体内抛出的错误,也可以被函数体外的`catch`捕获。 ```javascript -function *foo() { +function* foo() { var x = yield 3; var y = x.toUpperCase(); yield y; @@ -602,9 +617,9 @@ try { } ``` -上面代码中,第二个`next`方法向函数体内传入一个参数42,数值是没有`toUpperCase`方法的,所以会抛出一个TypeError错误,被函数体外的`catch`捕获。 +上面代码中,第二个`next`方法向函数体内传入一个参数 42,数值是没有`toUpperCase`方法的,所以会抛出一个 TypeError 错误,被函数体外的`catch`捕获。 -一旦Generator执行过程中抛出错误,且没有被内部捕获,就不会再执行下去了。如果此后还调用`next`方法,将返回一个`value`属性等于`undefined`、`done`属性等于`true`的对象,即JavaScript引擎认为这个Generator已经运行结束了。 +一旦 Generator 执行过程中抛出错误,且没有被内部捕获,就不会再执行下去了。如果此后还调用`next`方法,将返回一个`value`属性等于`undefined`、`done`属性等于`true`的对象,即 JavaScript 引擎认为这个 Generator 已经运行结束了。 ```javascript function* g() { @@ -648,11 +663,11 @@ log(g()); // caller done ``` -上面代码一共三次运行`next`方法,第二次运行的时候会抛出错误,然后第三次运行的时候,Generator函数就已经结束了,不再执行下去了。 +上面代码一共三次运行`next`方法,第二次运行的时候会抛出错误,然后第三次运行的时候,Generator 函数就已经结束了,不再执行下去了。 ## Generator.prototype.return() -Generator函数返回的遍历器对象,还有一个`return`方法,可以返回给定的值,并且终结遍历Generator函数。 +Generator 函数返回的遍历器对象,还有一个`return`方法,可以返回给定的值,并且终结遍历 Generator 函数。 ```javascript function* gen() { @@ -668,7 +683,7 @@ g.return('foo') // { value: "foo", done: true } g.next() // { value: undefined, done: true } ``` -上面代码中,遍历器对象`g`调用`return`方法后,返回值的`value`属性就是`return`方法的参数`foo`。并且,Generator函数的遍历就终止了,返回值的`done`属性为`true`,以后再调用`next`方法,`done`属性总是返回`true`。 +上面代码中,遍历器对象`g`调用`return`方法后,返回值的`value`属性就是`return`方法的参数`foo`。并且,Generator 函数的遍历就终止了,返回值的`done`属性为`true`,以后再调用`next`方法,`done`属性总是返回`true`。 如果`return`方法调用时,不提供参数,则返回值的`value`属性为`undefined`。 @@ -685,7 +700,7 @@ g.next() // { value: 1, done: false } g.return() // { value: undefined, done: true } ``` -如果Generator函数内部有`try...finally`代码块,那么`return`方法会推迟到`finally`代码块执行完再执行。 +如果 Generator 函数内部有`try...finally`代码块,且正在执行`try`代码块,那么`return`方法会推迟到`finally`代码块执行完再执行。 ```javascript function* numbers () { @@ -699,17 +714,55 @@ function* numbers () { } yield 6; } -var g = numbers() -g.next() // { done: false, value: 1 } -g.next() // { done: false, value: 2 } -g.return(7) // { done: false, value: 4 } -g.next() // { done: false, value: 5 } -g.next() // { done: true, value: 7 } +var g = numbers(); +g.next() // { value: 1, done: false } +g.next() // { value: 2, done: false } +g.return(7) // { value: 4, done: false } +g.next() // { value: 5, done: false } +g.next() // { value: 7, done: true } ``` 上面代码中,调用`return`方法后,就开始执行`finally`代码块,然后等到`finally`代码块执行完,再执行`return`方法。 -## yield* 语句 +## next()、throw()、return() 的共同点 + +`next()`、`throw()`、`return()`这三个方法本质上是同一件事,可以放在一起理解。它们的作用都是让 Generator 函数恢复执行,并且使用不同的语句替换`yield`表达式。 + +`next()`是将`yield`表达式替换成一个值。 + +```javascript +const g = function* (x, y) { + let result = yield x + y; + return result; +}; + +const gen = g(1, 2); +gen.next(); // Object {value: 3, done: false} + +gen.next(1); // Object {value: 1, done: true} +// 相当于将 let result = yield x + y +// 替换成 let result = 1; +``` + +上面代码中,第二个`next(1)`方法就相当于将`yield`表达式替换成一个值`1`。如果`next`方法没有参数,就相当于替换成`undefined`。 + +`throw()`是将`yield`表达式替换成一个`throw`语句。 + +```javascript +gen.throw(new Error('出错了')); // Uncaught Error: 出错了 +// 相当于将 let result = yield x + y +// 替换成 let result = throw(new Error('出错了')); +``` + +`return()`是将`yield`表达式替换成一个`return`语句。 + +```javascript +gen.return(2); // Object {value: 2, done: true} +// 相当于将 let result = yield x + y +// 替换成 let result = return 2; +``` + +## yield\* 表达式 如果在 Generator 函数内部,调用另一个 Generator 函数,默认情况下是没有效果的。 @@ -734,7 +787,7 @@ for (let v of bar()){ 上面代码中,`foo`和`bar`都是 Generator 函数,在`bar`里面调用`foo`,是不会有效果的。 -这个就需要用到`yield*`语句,用来在一个 Generator 函数里面执行另一个 Generator 函数。 +这个就需要用到`yield*`表达式,用来在一个 Generator 函数里面执行另一个 Generator 函数。 ```javascript function* bar() { @@ -801,7 +854,7 @@ gen.next().value // "close" 上面例子中,`outer2`使用了`yield*`,`outer1`没使用。结果就是,`outer1`返回一个遍历器对象,`outer2`返回该遍历器对象的内部值。 -从语法角度看,如果`yield`命令后面跟的是一个遍历器对象,需要在`yield`命令后面加上星号,表明它返回的是一个遍历器对象。这被称为`yield*`语句。 +从语法角度看,如果`yield`表达式后面跟的是一个遍历器对象,需要在`yield`表达式后面加上星号,表明它返回的是一个遍历器对象。这被称为`yield*`表达式。 ```javascript let delegatedIterator = (function* () { @@ -824,9 +877,9 @@ for(let value of delegatingIterator) { // "Ok, bye." ``` -上面代码中,`delegatingIterator`是代理者,`delegatedIterator`是被代理者。由于`yield* delegatedIterator`语句得到的值,是一个遍历器,所以要用星号表示。运行结果就是使用一个遍历器,遍历了多个Generator函数,有递归的效果。 +上面代码中,`delegatingIterator`是代理者,`delegatedIterator`是被代理者。由于`yield* delegatedIterator`语句得到的值,是一个遍历器,所以要用星号表示。运行结果就是使用一个遍历器,遍历了多个 Generator 函数,有递归的效果。 -`yield*`后面的Generator函数(没有`return`语句时),等同于在Generator函数内部,部署一个`for...of`循环。 +`yield*`后面的 Generator 函数(没有`return`语句时),等同于在 Generator 函数内部,部署一个`for...of`循环。 ```javascript function* concat(iter1, iter2) { @@ -846,7 +899,7 @@ function* concat(iter1, iter2) { } ``` -上面代码说明,`yield*`后面的Generator函数(没有`return`语句时),不过是`for...of`的一种简写形式,完全可以用后者替代前者。反之,则需要用`var value = yield* iterator`的形式获取`return`语句的值。 +上面代码说明,`yield*`后面的 Generator 函数(没有`return`语句时),不过是`for...of`的一种简写形式,完全可以用后者替代前者。反之,在有`return`语句时,则需要用`var value = yield* iterator`的形式获取`return`语句的值。 如果`yield*`后面跟着一个数组,由于数组原生支持遍历器,因此就会遍历数组成员。 @@ -860,7 +913,7 @@ gen().next() // { value:"a", done:false } 上面代码中,`yield`命令后面如果不加星号,返回的是整个数组,加了星号就表示返回的是数组的遍历器对象。 -实际上,任何数据结构只要有Iterator接口,就可以被`yield*`遍历。 +实际上,任何数据结构只要有 Iterator 接口,就可以被`yield*`遍历。 ```javascript let read = (function* () { @@ -872,21 +925,21 @@ read.next().value // "hello" read.next().value // "h" ``` -上面代码中,`yield`语句返回整个字符串,`yield*`语句返回单个字符。因为字符串具有Iterator接口,所以被`yield*`遍历。 +上面代码中,`yield`表达式返回整个字符串,`yield*`语句返回单个字符。因为字符串具有 Iterator 接口,所以被`yield*`遍历。 -如果被代理的Generator函数有`return`语句,那么就可以向代理它的Generator函数返回数据。 +如果被代理的 Generator 函数有`return`语句,那么就可以向代理它的 Generator 函数返回数据。 ```javascript -function *foo() { +function* foo() { yield 2; yield 3; return "foo"; } -function *bar() { +function* bar() { yield 1; - var v = yield *foo(); - console.log( "v: " + v ); + var v = yield* foo(); + console.log("v: " + v); yield 4; } @@ -952,6 +1005,12 @@ for(let x of iterTree(tree)) { // e ``` +由于扩展运算符`...`默认调用 Iterator 接口,所以上面这个函数也可以用于嵌套数组的平铺。 + +```javascript +[...iterTree(tree)] // ["a", "b", "c", "d", "e"] +``` + 下面是一个稍微复杂的例子,使用`yield*`语句遍历完全二叉树。 ```javascript @@ -992,9 +1051,9 @@ result // ['a', 'b', 'c', 'd', 'e', 'f', 'g'] ``` -## 作为对象属性的Generator函数 +## 作为对象属性的 Generator 函数 -如果一个对象的属性是Generator函数,可以简写成下面的形式。 +如果一个对象的属性是 Generator 函数,可以简写成下面的形式。 ```javascript let obj = { @@ -1004,7 +1063,7 @@ let obj = { }; ``` -上面代码中,`myGeneratorMethod`属性前面有一个星号,表示这个属性是一个Generator函数。 +上面代码中,`myGeneratorMethod`属性前面有一个星号,表示这个属性是一个 Generator 函数。 它的完整形式如下,与上面的写法是等价的。 @@ -1016,9 +1075,9 @@ let obj = { }; ``` -## Generator函数的`this` +## Generator 函数的`this` -Generator函数总是返回一个遍历器,ES6规定这个遍历器是Generator函数的实例,也继承了Generator函数的`prototype`对象上的方法。 +Generator 函数总是返回一个遍历器,ES6 规定这个遍历器是 Generator 函数的实例,也继承了 Generator 函数的`prototype`对象上的方法。 ```javascript function* g() {} @@ -1033,7 +1092,7 @@ obj instanceof g // true obj.hello() // 'hi!' ``` -上面代码表明,Generator函数`g`返回的遍历器`obj`,是`g`的实例,而且继承了`g.prototype`。但是,如果把`g`当作普通的构造函数,并不会生效,因为`g`返回的总是遍历器对象,而不是`this`对象。 +上面代码表明,Generator 函数`g`返回的遍历器`obj`,是`g`的实例,而且继承了`g.prototype`。但是,如果把`g`当作普通的构造函数,并不会生效,因为`g`返回的总是遍历器对象,而不是`this`对象。 ```javascript function* g() { @@ -1041,12 +1100,13 @@ function* g() { } let obj = g(); +obj.next(); obj.a // undefined ``` -上面代码中,Generator函数`g`在`this`对象上面添加了一个属性`a`,但是`obj`对象拿不到这个属性。 +上面代码中,Generator 函数`g`在`this`对象上面添加了一个属性`a`,但是`obj`对象拿不到这个属性。 -Generator函数也不能跟`new`命令一起用,会报错。 +Generator 函数也不能跟`new`命令一起用,会报错。 ```javascript function* F() { @@ -1060,9 +1120,9 @@ new F() 上面代码中,`new`命令跟构造函数`F`一起使用,结果报错,因为`F`不是构造函数。 -那么,有没有办法让Generator函数返回一个正常的对象实例,既可以用`next`方法,又可以获得正常的`this`? +那么,有没有办法让 Generator 函数返回一个正常的对象实例,既可以用`next`方法,又可以获得正常的`this`? -下面是一个变通方法。首先,生成一个空对象,使用`call`方法绑定Generator函数内部的`this`。这样,构造函数调用以后,这个空对象就是Generator函数的实例对象了。 +下面是一个变通方法。首先,生成一个空对象,使用`call`方法绑定 Generator 函数内部的`this`。这样,构造函数调用以后,这个空对象就是 Generator 函数的实例对象了。 ```javascript function* F() { @@ -1082,7 +1142,7 @@ obj.b // 2 obj.c // 3 ``` -上面代码中,首先是`F`内部的`this`对象绑定`obj`对象,然后调用它,返回一个Iterator对象。这个对象执行三次`next`方法(因为`F`内部有两个`yield`语句),完成F内部所有代码的运行。这时,所有内部属性都绑定在`obj`对象上了,因此`obj`对象也就成了`F`的实例。 +上面代码中,首先是`F`内部的`this`对象绑定`obj`对象,然后调用它,返回一个 Iterator 对象。这个对象执行三次`next`方法(因为`F`内部有两个`yield`表达式),完成 F 内部所有代码的运行。这时,所有内部属性都绑定在`obj`对象上了,因此`obj`对象也就成了`F`的实例。 上面代码中,执行的是遍历器对象`f`,但是生成的对象实例是`obj`,有没有办法将这两个对象统一呢? @@ -1131,9 +1191,9 @@ f.c // 3 ## 含义 -### Generator与状态机 +### Generator 与状态机 -Generator是实现状态机的最佳结构。比如,下面的clock函数就是一个状态机。 +Generator 是实现状态机的最佳结构。比如,下面的`clock`函数就是一个状态机。 ```javascript var ticking = true; @@ -1146,10 +1206,10 @@ var clock = function() { } ``` -上面代码的clock函数一共有两种状态(Tick和Tock),每运行一次,就改变一次状态。这个函数如果用Generator实现,就是下面这样。 +上面代码的`clock`函数一共有两种状态(`Tick`和`Tock`),每运行一次,就改变一次状态。这个函数如果用 Generator 实现,就是下面这样。 ```javascript -var clock = function*() { +var clock = function* () { while (true) { console.log('Tick!'); yield; @@ -1159,9 +1219,9 @@ var clock = function*() { }; ``` -上面的Generator实现与ES5实现对比,可以看到少了用来保存状态的外部变量`ticking`,这样就更简洁,更安全(状态不会被非法篡改)、更符合函数式编程的思想,在写法上也更优雅。Generator之所以可以不用外部变量保存状态,是因为它本身就包含了一个状态信息,即目前是否处于暂停态。 +上面的 Generator 实现与 ES5 实现对比,可以看到少了用来保存状态的外部变量`ticking`,这样就更简洁,更安全(状态不会被非法篡改)、更符合函数式编程的思想,在写法上也更优雅。Generator 之所以可以不用外部变量保存状态,是因为它本身就包含了一个状态信息,即目前是否处于暂停态。 -### Generator与协程 +### Generator 与协程 协程(coroutine)是一种程序运行的方式,可以理解成“协作的线程”或“协作的函数”。协程既可以用单线程实现,也可以用多线程实现。前者是一种特殊的子例程,后者是一种特殊的线程。 @@ -1175,19 +1235,43 @@ var clock = function*() { 不难看出,协程适合用于多任务运行的环境。在这个意义上,它与普通的线程很相似,都有自己的执行上下文、可以分享全局变量。它们的不同之处在于,同一时间可以有多个线程处于运行状态,但是运行的协程只能有一个,其他协程都处于暂停状态。此外,普通的线程是抢先式的,到底哪个线程优先得到资源,必须由运行环境决定,但是协程是合作式的,执行权由协程自己分配。 -由于ECMAScript是单线程语言,只能保持一个调用栈。引入协程以后,每个任务可以保持自己的调用栈。这样做的最大好处,就是抛出错误的时候,可以找到原始的调用栈。不至于像异步操作的回调函数那样,一旦出错,原始的调用栈早就结束。 +由于 JavaScript 是单线程语言,只能保持一个调用栈。引入协程以后,每个任务可以保持自己的调用栈。这样做的最大好处,就是抛出错误的时候,可以找到原始的调用栈。不至于像异步操作的回调函数那样,一旦出错,原始的调用栈早就结束。 + +Generator 函数是 ES6 对协程的实现,但属于不完全实现。Generator 函数被称为“半协程”(semi-coroutine),意思是只有 Generator 函数的调用者,才能将程序的执行权还给 Generator 函数。如果是完全执行的协程,任何函数都可以让暂停的协程继续执行。 + +如果将 Generator 函数当作协程,完全可以将多个需要互相协作的任务写成 Generator 函数,它们之间使用`yield`表达式交换控制权。 -Generator函数是ECMAScript 6对协程的实现,但属于不完全实现。Generator函数被称为“半协程”(semi-coroutine),意思是只有Generator函数的调用者,才能将程序的执行权还给Generator函数。如果是完全执行的协程,任何函数都可以让暂停的协程继续执行。 +### Generator 与上下文 -如果将Generator函数当作协程,完全可以将多个需要互相协作的任务写成Generator函数,它们之间使用yield语句交换控制权。 +JavaScript 代码运行时,会产生一个全局的上下文环境(context,又称运行环境),包含了当前所有的变量和对象。然后,执行函数(或块级代码)的时候,又会在当前上下文环境的上层,产生一个函数运行的上下文,变成当前(active)的上下文,由此形成一个上下文环境的堆栈(context stack)。 + +这个堆栈是“后进先出”的数据结构,最后产生的上下文环境首先执行完成,退出堆栈,然后再执行完成它下层的上下文,直至所有代码执行完成,堆栈清空。 + +Generator 函数不是这样,它执行产生的上下文环境,一旦遇到`yield`命令,就会暂时退出堆栈,但是并不消失,里面的所有变量和对象会冻结在当前状态。等到对它执行`next`命令时,这个上下文环境又会重新加入调用栈,冻结的变量和对象恢复执行。 + +```javascript +function* gen() { + yield 1; + return 2; +} + +let g = gen(); + +console.log( + g.next().value, + g.next().value, +); +``` + +上面代码中,第一次执行`g.next()`时,Generator 函数`gen`的上下文会加入堆栈,即开始运行`gen`内部的代码。等遇到`yield 1`时,`gen`上下文退出堆栈,内部状态冻结。第二次执行`g.next()`时,`gen`上下文重新加入堆栈,变成当前的上下文,重新恢复执行。 ## 应用 -Generator可以暂停函数执行,返回任意表达式的值。这种特点使得Generator有多种应用场景。 +Generator 可以暂停函数执行,返回任意表达式的值。这种特点使得 Generator 有多种应用场景。 ### (1)异步操作的同步化表达 -Generator函数的暂停执行的效果,意味着可以把异步操作写在yield语句里面,等到调用next方法时再往后执行。这实际上等同于不需要写回调函数了,因为异步操作的后续操作可以放在yield语句下面,反正要等到调用next方法时再执行。所以,Generator函数的一个重要实际意义就是用来处理异步操作,改写回调函数。 +Generator 函数的暂停执行的效果,意味着可以把异步操作写在`yield`表达式里面,等到调用`next`方法时再往后执行。这实际上等同于不需要写回调函数了,因为异步操作的后续操作可以放在`yield`表达式下面,反正要等到调用`next`方法时再执行。所以,Generator 函数的一个重要实际意义就是用来处理异步操作,改写回调函数。 ```javascript function* loadUI() { @@ -1203,9 +1287,9 @@ loader.next() loader.next() ``` -上面代码表示,第一次调用loadUI函数时,该函数不会执行,仅返回一个遍历器。下一次对该遍历器调用next方法,则会显示Loading界面,并且异步加载数据。等到数据加载完成,再一次使用next方法,则会隐藏Loading界面。可以看到,这种写法的好处是所有Loading界面的逻辑,都被封装在一个函数,按部就班非常清晰。 +上面代码中,第一次调用`loadUI`函数时,该函数不会执行,仅返回一个遍历器。下一次对该遍历器调用`next`方法,则会显示`Loading`界面(`showLoadingScreen`),并且异步加载数据(`loadUIDataAsynchronously`)。等到数据加载完成,再一次使用`next`方法,则会隐藏`Loading`界面。可以看到,这种写法的好处是所有`Loading`界面的逻辑,都被封装在一个函数,按部就班非常清晰。 -Ajax是典型的异步操作,通过Generator函数部署Ajax操作,可以用同步的方式表达。 +Ajax 是典型的异步操作,通过 Generator 函数部署 Ajax 操作,可以用同步的方式表达。 ```javascript function* main() { @@ -1224,9 +1308,9 @@ var it = main(); it.next(); ``` -上面代码的main函数,就是通过Ajax操作获取数据。可以看到,除了多了一个yield,它几乎与同步操作的写法完全一样。注意,makeAjaxCall函数中的next方法,必须加上response参数,因为yield语句构成的表达式,本身是没有值的,总是等于undefined。 +上面代码的`main`函数,就是通过 Ajax 操作获取数据。可以看到,除了多了一个`yield`,它几乎与同步操作的写法完全一样。注意,`makeAjaxCall`函数中的`next`方法,必须加上`response`参数,因为`yield`表达式,本身是没有值的,总是等于`undefined`。 -下面是另一个例子,通过Generator函数逐行读取文本文件。 +下面是另一个例子,通过 Generator 函数逐行读取文本文件。 ```javascript function* numbers() { @@ -1241,7 +1325,7 @@ function* numbers() { } ``` -上面代码打开文本文件,使用yield语句可以手动逐行读取文件。 +上面代码打开文本文件,使用`yield`表达式可以手动逐行读取文件。 ### (2)控制流管理 @@ -1259,7 +1343,7 @@ step1(function (value1) { }); ``` -采用Promise改写上面的代码。 +采用 Promise 改写上面的代码。 ```javascript Promise.resolve(step1) @@ -1274,7 +1358,7 @@ Promise.resolve(step1) .done(); ``` -上面代码已经把回调函数,改成了直线执行的形式,但是加入了大量Promise的语法。Generator函数可以进一步改善代码运行流程。 +上面代码已经把回调函数,改成了直线执行的形式,但是加入了大量 Promise 的语法。Generator 函数可以进一步改善代码运行流程。 ```javascript function* longRunningTask(value1) { @@ -1312,7 +1396,7 @@ function scheduler(task) { ```javascript let steps = [step1Func, step2Func, step3Func]; -function *iterateSteps(steps){ +function* iterateSteps(steps){ for (var i=0; i< steps.length; i++){ var step = steps[i]; yield step(); @@ -1320,22 +1404,22 @@ function *iterateSteps(steps){ } ``` -上面代码中,数组`steps`封装了一个任务的多个步骤,Generator函数`iterateSteps`则是依次为这些步骤加上`yield`命令。 +上面代码中,数组`steps`封装了一个任务的多个步骤,Generator 函数`iterateSteps`则是依次为这些步骤加上`yield`命令。 将任务分解成步骤之后,还可以将项目分解成多个依次执行的任务。 ```javascript let jobs = [job1, job2, job3]; -function *iterateJobs(jobs){ +function* iterateJobs(jobs){ for (var i=0; i< jobs.length; i++){ var job = jobs[i]; - yield *iterateSteps(job.steps); + yield* iterateSteps(job.steps); } } ``` -上面代码中,数组`jobs`封装了一个项目的多个任务,Generator函数`iterateJobs`则是依次为这些任务加上`yield *`命令。 +上面代码中,数组`jobs`封装了一个项目的多个任务,Generator 函数`iterateJobs`则是依次为这些任务加上`yield*`命令。 最后,就可以用`for...of`循环一次性依次执行所有任务的所有步骤。 @@ -1360,9 +1444,9 @@ while (!res.done){ } ``` -### (3)部署Iterator接口 +### (3)部署 Iterator 接口 -利用Generator函数,可以在任意对象上部署Iterator接口。 +利用 Generator 函数,可以在任意对象上部署 Iterator 接口。 ```javascript function* iterEntries(obj) { @@ -1383,9 +1467,9 @@ for (let [key, value] of iterEntries(myObj)) { // bar 7 ``` -上述代码中,`myObj`是一个普通对象,通过`iterEntries`函数,就有了Iterator接口。也就是说,可以在任意对象上部署`next`方法。 +上述代码中,`myObj`是一个普通对象,通过`iterEntries`函数,就有了 Iterator 接口。也就是说,可以在任意对象上部署`next`方法。 -下面是一个对数组部署Iterator接口的例子,尽管数组原生具有这个接口。 +下面是一个对数组部署 Iterator 接口的例子,尽管数组原生具有这个接口。 ```javascript function* makeSimpleGenerator(array){ @@ -1405,17 +1489,17 @@ gen.next().done // true ### (4)作为数据结构 -Generator可以看作是数据结构,更确切地说,可以看作是一个数组结构,因为Generator函数可以返回一系列的值,这意味着它可以对任意表达式,提供类似数组的接口。 +Generator 可以看作是数据结构,更确切地说,可以看作是一个数组结构,因为 Generator 函数可以返回一系列的值,这意味着它可以对任意表达式,提供类似数组的接口。 ```javascript -function *doStuff() { +function* doStuff() { yield fs.readFile.bind(null, 'hello.txt'); yield fs.readFile.bind(null, 'world.txt'); yield fs.readFile.bind(null, 'and-such.txt'); } ``` -上面代码就是依次返回三个函数,但是由于使用了Generator函数,导致可以像处理数组那样,处理这三个返回的函数。 +上面代码就是依次返回三个函数,但是由于使用了 Generator 函数,导致可以像处理数组那样,处理这三个返回的函数。 ```javascript for (task of doStuff()) { @@ -1423,7 +1507,7 @@ for (task of doStuff()) { } ``` -实际上,如果用ES5表达,完全可以用数组模拟Generator的这种用法。 +实际上,如果用 ES5 表达,完全可以用数组模拟 Generator 的这种用法。 ```javascript function doStuff() { @@ -1435,5 +1519,4 @@ function doStuff() { } ``` -上面的函数,可以用一模一样的for...of循环处理!两相一比较,就不难看出Generator使得数据或者操作,具备了类似数组的接口。 - +上面的函数,可以用一模一样的`for...of`循环处理!两相一比较,就不难看出 Generator 使得数据或者操作,具备了类似数组的接口。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/intro.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/intro.md" new file mode 100755 index 000000000..59f418747 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/intro.md" @@ -0,0 +1,477 @@ +# ECMAScript 6 简介 + +ECMAScript 6.0(以下简称 ES6)是 JavaScript 语言的下一代标准,已经在 2015 年 6 月正式发布了。它的目标,是使得 JavaScript 语言可以用来编写复杂的大型应用程序,成为企业级开发语言。 + +## ECMAScript 和 JavaScript 的关系 + +一个常见的问题是,ECMAScript 和 JavaScript 到底是什么关系? + +要讲清楚这个问题,需要回顾历史。1996 年 11 月,JavaScript 的创造者 Netscape 公司,决定将 JavaScript 提交给标准化组织 ECMA,希望这种语言能够成为国际标准。次年,ECMA 发布 262 号标准文件(ECMA-262)的第一版,规定了浏览器脚本语言的标准,并将这种语言称为 ECMAScript,这个版本就是 1.0 版。 + +该标准从一开始就是针对 JavaScript 语言制定的,但是之所以不叫 JavaScript,有两个原因。一是商标,Java 是 Sun 公司的商标,根据授权协议,只有 Netscape 公司可以合法地使用 JavaScript 这个名字,且 JavaScript 本身也已经被 Netscape 公司注册为商标。二是想体现这门语言的制定者是 ECMA,不是 Netscape,这样有利于保证这门语言的开放性和中立性。 + +因此,ECMAScript 和 JavaScript 的关系是,前者是后者的规格,后者是前者的一种实现(另外的 ECMAScript 方言还有 JScript 和 ActionScript)。日常场合,这两个词是可以互换的。 + +## ES6 与 ECMAScript 2015 的关系 + +ECMAScript 2015(简称 ES2015)这个词,也是经常可以看到的。它与 ES6 是什么关系呢? + +2011 年,ECMAScript 5.1 版发布后,就开始制定 6.0 版了。因此,ES6 这个词的原意,就是指 JavaScript 语言的下一个版本。 + +但是,因为这个版本引入的语法功能太多,而且制定过程当中,还有很多组织和个人不断提交新功能。事情很快就变得清楚了,不可能在一个版本里面包括所有将要引入的功能。常规的做法是先发布 6.0 版,过一段时间再发 6.1 版,然后是 6.2 版、6.3 版等等。 + +但是,标准的制定者不想这样做。他们想让标准的升级成为常规流程:任何人在任何时候,都可以向标准委员会提交新语法的提案,然后标准委员会每个月开一次会,评估这些提案是否可以接受,需要哪些改进。如果经过多次会议以后,一个提案足够成熟了,就可以正式进入标准了。这就是说,标准的版本升级成为了一个不断滚动的流程,每个月都会有变动。 + +标准委员会最终决定,标准在每年的 6 月份正式发布一次,作为当年的正式版本。接下来的时间,就在这个版本的基础上做改动,直到下一年的 6 月份,草案就自然变成了新一年的版本。这样一来,就不需要以前的版本号了,只要用年份标记就可以了。 + +ES6 的第一个版本,就这样在 2015 年 6 月发布了,正式名称就是《ECMAScript 2015 标准》(简称 ES2015)。2016 年 6 月,小幅修订的《ECMAScript 2016 标准》(简称 ES2016)如期发布,这个版本可以看作是 ES6.1 版,因为两者的差异非常小(只新增了数组实例的`includes`方法和指数运算符),基本上是同一个标准。根据计划,2017 年 6 月发布 ES2017 标准。 + +因此,ES6 既是一个历史名词,也是一个泛指,含义是 5.1 版以后的 JavaScript 的下一代标准,涵盖了 ES2015、ES2016、ES2017 等等,而 ES2015 则是正式名称,特指该年发布的正式版本的语言标准。本书中提到 ES6 的地方,一般是指 ES2015 标准,但有时也是泛指“下一代 JavaScript 语言”。 + +## 语法提案的批准流程 + +任何人都可以向标准委员会(又称 TC39 委员会)提案,要求修改语言标准。 + +一种新的语法从提案到变成正式标准,需要经历五个阶段。每个阶段的变动都需要由 TC39 委员会批准。 + +- Stage 0 - Strawman(展示阶段) +- Stage 1 - Proposal(征求意见阶段) +- Stage 2 - Draft(草案阶段) +- Stage 3 - Candidate(候选人阶段) +- Stage 4 - Finished(定案阶段) + +一个提案只要能进入 Stage 2,就差不多肯定会包括在以后的正式标准里面。ECMAScript 当前的所有提案,可以在 TC39 的官方网站[GitHub.com/tc39/ecma262](https://github.com/tc39/ecma262)查看。 + +本书的写作目标之一,是跟踪 ECMAScript 语言的最新进展,介绍 5.1 版本以后所有的新语法。对于那些明确或很有希望,将要列入标准的新语法,都将予以介绍。 + +## ECMAScript 的历史 + +ES6 从开始制定到最后发布,整整用了 15 年。 + +前面提到,ECMAScript 1.0 是 1997 年发布的,接下来的两年,连续发布了 ECMAScript 2.0(1998 年 6 月)和 ECMAScript 3.0(1999 年 12 月)。3.0 版是一个巨大的成功,在业界得到广泛支持,成为通行标准,奠定了 JavaScript 语言的基本语法,以后的版本完全继承。直到今天,初学者一开始学习 JavaScript,其实就是在学 3.0 版的语法。 + +2000 年,ECMAScript 4.0 开始酝酿。这个版本最后没有通过,但是它的大部分内容被 ES6 继承了。因此,ES6 制定的起点其实是 2000 年。 + +为什么 ES4 没有通过呢?因为这个版本太激进了,对 ES3 做了彻底升级,导致标准委员会的一些成员不愿意接受。ECMA 的第 39 号技术专家委员会(Technical Committee 39,简称 TC39)负责制订 ECMAScript 标准,成员包括 Microsoft、Mozilla、Google 等大公司。 + +2007 年 10 月,ECMAScript 4.0 版草案发布,本来预计次年 8 月发布正式版本。但是,各方对于是否通过这个标准,发生了严重分歧。以 Yahoo、Microsoft、Google 为首的大公司,反对 JavaScript 的大幅升级,主张小幅改动;以 JavaScript 创造者 Brendan Eich 为首的 Mozilla 公司,则坚持当前的草案。 + +2008 年 7 月,由于对于下一个版本应该包括哪些功能,各方分歧太大,争论过于激烈,ECMA 开会决定,中止 ECMAScript 4.0 的开发,将其中涉及现有功能改善的一小部分,发布为 ECMAScript 3.1,而将其他激进的设想扩大范围,放入以后的版本,由于会议的气氛,该版本的项目代号起名为 Harmony(和谐)。会后不久,ECMAScript 3.1 就改名为 ECMAScript 5。 + +2009 年 12 月,ECMAScript 5.0 版正式发布。Harmony 项目则一分为二,一些较为可行的设想定名为 JavaScript.next 继续开发,后来演变成 ECMAScript 6;一些不是很成熟的设想,则被视为 JavaScript.next.next,在更远的将来再考虑推出。TC39 委员会的总体考虑是,ES5 与 ES3 基本保持兼容,较大的语法修正和新功能加入,将由 JavaScript.next 完成。当时,JavaScript.next 指的是 ES6,第六版发布以后,就指 ES7。TC39 的判断是,ES5 会在 2013 年的年中成为 JavaScript 开发的主流标准,并在此后五年中一直保持这个位置。 + +2011 年 6 月,ECMAScript 5.1 版发布,并且成为 ISO 国际标准(ISO/IEC 16262:2011)。 + +2013 年 3 月,ECMAScript 6 草案冻结,不再添加新功能。新的功能设想将被放到 ECMAScript 7。 + +2013 年 12 月,ECMAScript 6 草案发布。然后是 12 个月的讨论期,听取各方反馈。 + +2015 年 6 月,ECMAScript 6 正式通过,成为国际标准。从 2000 年算起,这时已经过去了 15 年。 + +## 部署进度 + +各大浏览器的最新版本,对 ES6 的支持可以查看[kangax.github.io/compat-table/es6/](https://kangax.github.io/compat-table/es6/)。随着时间的推移,支持度已经越来越高了,超过 90%的 ES6 语法特性都实现了。 + +Node 是 JavaScript 的服务器运行环境(runtime)。它对 ES6 的支持度更高。除了那些默认打开的功能,还有一些语法功能已经实现了,但是默认没有打开。使用下面的命令,可以查看 Node 已经实现的 ES6 特性。 + +```bash +// Linux & Mac +$ node --v8-options | grep harmony + +// Windows +$ node --v8-options | findstr harmony +``` + +我写了一个工具 [ES-Checker](https://github.com/ruanyf/es-checker),用来检查各种运行环境对 ES6 的支持情况。访问[ruanyf.github.io/es-checker](http://ruanyf.github.io/es-checker),可以看到您的浏览器支持 ES6 的程度。运行下面的命令,可以查看你正在使用的 Node 环境对 ES6 的支持程度。 + +```bash +$ npm install -g es-checker +$ es-checker + +========================================= +Passes 24 feature Detections +Your runtime supports 57% of ECMAScript 6 +========================================= +``` + +## Babel 转码器 + +[Babel](https://babeljs.io/) 是一个广泛使用的 ES6 转码器,可以将 ES6 代码转为 ES5 代码,从而在现有环境执行。这意味着,你可以用 ES6 的方式编写程序,又不用担心现有环境是否支持。下面是一个例子。 + +```javascript +// 转码前 +input.map(item => item + 1); + +// 转码后 +input.map(function (item) { + return item + 1; +}); +``` + +上面的原始代码用了箭头函数,Babel 将其转为普通函数,就能在不支持箭头函数的 JavaScript 环境执行了。 + +下面的命令在项目目录中,安装 Babel。 + +```bash +$ npm install --save-dev @babel/core +``` + +### 配置文件`.babelrc` + +Babel 的配置文件是`.babelrc`,存放在项目的根目录下。使用 Babel 的第一步,就是配置这个文件。 + +该文件用来设置转码规则和插件,基本格式如下。 + +```javascript +{ + "presets": [], + "plugins": [] +} +``` + +`presets`字段设定转码规则,官方提供以下的规则集,你可以根据需要安装。 + +```bash +# 最新转码规则 +$ npm install --save-dev @babel/preset-env + +# react 转码规则 +$ npm install --save-dev @babel/preset-react +``` + +然后,将这些规则加入`.babelrc`。 + +```javascript + { + "presets": [ + "@babel/env", + "@babel/preset-react" + ], + "plugins": [] + } +``` + +注意,以下所有 Babel 工具和模块的使用,都必须先写好`.babelrc`。 + +### 命令行转码 + +Babel 提供命令行工具`@babel/cli`,用于命令行转码。 + +它的安装命令如下。 + +```bash +$ npm install --save-dev @babel/cli +``` + +基本用法如下。 + +```bash +# 转码结果输出到标准输出 +$ npx babel example.js + +# 转码结果写入一个文件 +# --out-file 或 -o 参数指定输出文件 +$ npx babel example.js --out-file compiled.js +# 或者 +$ npx babel example.js -o compiled.js + +# 整个目录转码 +# --out-dir 或 -d 参数指定输出目录 +$ npx babel src --out-dir lib +# 或者 +$ npx babel src -d lib + +# -s 参数生成source map文件 +$ npx babel src -d lib -s +``` + +### babel-node + +`@babel/node`模块的`babel-node`命令,提供一个支持 ES6 的 REPL 环境。它支持 Node 的 REPL 环境的所有功能,而且可以直接运行 ES6 代码。 + +首先,安装这个模块。 + +```bash +$ npm install --save-dev @babel/node +``` + +然后,执行`babel-node`就进入 REPL 环境。 + +```bash +$ npx babel-node +> (x => x * 2)(1) +2 +``` + +`babel-node`命令可以直接运行 ES6 脚本。将上面的代码放入脚本文件`es6.js`,然后直接运行。 + +```bash +# es6.js 的代码 +# console.log((x => x * 2)(1)); +$ npx babel-node es6.js +2 +``` + +### @babel/register 模块 + +`@babel/register`模块改写`require`命令,为它加上一个钩子。此后,每当使用`require`加载`.js`、`.jsx`、`.es`和`.es6`后缀名的文件,就会先用 Babel 进行转码。 + +```bash +$ npm install --save-dev @babel/register +``` + +使用时,必须首先加载`@babel/register`。 + +```bash +// index.js +require('@babel/register'); +require('./es6.js'); +``` + +然后,就不需要手动对`index.js`转码了。 + +```bash +$ node index.js +2 +``` + +需要注意的是,`@babel/register`只会对`require`命令加载的文件转码,而不会对当前文件转码。另外,由于它是实时转码,所以只适合在开发环境使用。 + +### babel API + +如果某些代码需要调用 Babel 的 API 进行转码,就要使用`@babel/core`模块。 + +```javascript +var babel = require('@babel/core'); + +// 字符串转码 +babel.transform('code();', options); +// => { code, map, ast } + +// 文件转码(异步) +babel.transformFile('filename.js', options, function(err, result) { + result; // => { code, map, ast } +}); + +// 文件转码(同步) +babel.transformFileSync('filename.js', options); +// => { code, map, ast } + +// Babel AST转码 +babel.transformFromAst(ast, code, options); +// => { code, map, ast } +``` + +配置对象`options`,可以参看官方文档[http://babeljs.io/docs/usage/options/](http://babeljs.io/docs/usage/options/)。 + +下面是一个例子。 + +```javascript +var es6Code = 'let x = n => n + 1'; +var es5Code = require('@babel/core') + .transform(es6Code, { + presets: ['@babel/env'] + }) + .code; + +console.log(es5Code); +// '"use strict";\n\nvar x = function x(n) {\n return n + 1;\n};' +``` + +上面代码中,`transform`方法的第一个参数是一个字符串,表示需要被转换的 ES6 代码,第二个参数是转换的配置对象。 + +### @babel/polyfill + +Babel 默认只转换新的 JavaScript 句法(syntax),而不转换新的 API,比如`Iterator`、`Generator`、`Set`、`Map`、`Proxy`、`Reflect`、`Symbol`、`Promise`等全局对象,以及一些定义在全局对象上的方法(比如`Object.assign`)都不会转码。 + +举例来说,ES6 在`Array`对象上新增了`Array.from`方法。Babel 就不会转码这个方法。如果想让这个方法运行,必须使用`babel-polyfill`,为当前环境提供一个垫片。 + +安装命令如下。 + +```bash +$ npm install --save-dev @babel/polyfill +``` + +然后,在脚本头部,加入如下一行代码。 + +```javascript +import '@babel/polyfill'; +// 或者 +require('@babel/polyfill'); +``` + +Babel 默认不转码的 API 非常多,详细清单可以查看`babel-plugin-transform-runtime`模块的[definitions.js](https://github.com/babel/babel/blob/master/packages/babel-plugin-transform-runtime/src/definitions.js)文件。 + +### 浏览器环境 + +Babel 也可以用于浏览器环境,使用[@babel/standalone](https://babeljs.io/docs/en/next/babel-standalone.html)模块提供的浏览器版本,将其插入网页。 + +```html + + +``` + +注意,网页实时将 ES6 代码转为 ES5,对性能会有影响。生产环境需要加载已经转码完成的脚本。 + +Babel 提供一个[REPL 在线编译器](https://babeljs.io/repl/),可以在线将 ES6 代码转为 ES5 代码。转换后的代码,可以直接作为 ES5 代码插入网页运行。 + +## Traceur 转码器 + +Google 公司的[Traceur](https://github.com/google/traceur-compiler)转码器,也可以将 ES6 代码转为 ES5 代码。 + +### 直接插入网页 + +Traceur 允许将 ES6 代码直接插入网页。首先,必须在网页头部加载 Traceur 库文件。 + +```html + + + + +``` + +上面代码中,一共有 4 个`script`标签。第一个是加载 Traceur 的库文件,第二个和第三个是将这个库文件用于浏览器环境,第四个则是加载用户脚本,这个脚本里面可以使用 ES6 代码。 + +注意,第四个`script`标签的`type`属性的值是`module`,而不是`text/javascript`。这是 Traceur 编译器识别 ES6 代码的标志,编译器会自动将所有`type=module`的代码编译为 ES5,然后再交给浏览器执行。 + +除了引用外部 ES6 脚本,也可以直接在网页中放置 ES6 代码。 + +```javascript + +``` + +正常情况下,上面代码会在控制台打印出`9`。 + +如果想对 Traceur 的行为有精确控制,可以采用下面参数配置的写法。 + +```javascript + +``` + +上面代码中,首先生成 Traceur 的全局对象`window.System`,然后`System.import`方法可以用来加载 ES6。加载的时候,需要传入一个配置对象`metadata`,该对象的`traceurOptions`属性可以配置支持 ES6 功能。如果设为`experimental: true`,就表示除了 ES6 以外,还支持一些实验性的新功能。 + +### 在线转换 + +Traceur 也提供一个[在线编译器](http://google.github.io/traceur-compiler/demo/repl.html),可以在线将 ES6 代码转为 ES5 代码。转换后的代码,可以直接作为 ES5 代码插入网页运行。 + +上面的例子转为 ES5 代码运行,就是下面这个样子。 + +```javascript + + + + +``` + +### 命令行转换 + +作为命令行工具使用时,Traceur 是一个 Node 的模块,首先需要用 npm 安装。 + +```bash +$ npm install -g traceur +``` + +安装成功后,就可以在命令行下使用 Traceur 了。 + +Traceur 直接运行 ES6 脚本文件,会在标准输出显示运行结果,以前面的`calc.js`为例。 + +```bash +$ traceur calc.js +Calc constructor +9 +``` + +如果要将 ES6 脚本转为 ES5 保存,要采用下面的写法。 + +```bash +$ traceur --script calc.es6.js --out calc.es5.js +``` + +上面代码的`--script`选项表示指定输入文件,`--out`选项表示指定输出文件。 + +为了防止有些特性编译不成功,最好加上`--experimental`选项。 + +```bash +$ traceur --script calc.es6.js --out calc.es5.js --experimental +``` + +命令行下转换生成的文件,就可以直接放到浏览器中运行。 + +### Node 环境的用法 + +Traceur 的 Node 用法如下(假定已安装`traceur`模块)。 + +```javascript +var traceur = require('traceur'); +var fs = require('fs'); + +// 将 ES6 脚本转为字符串 +var contents = fs.readFileSync('es6-file.js').toString(); + +var result = traceur.compile(contents, { + filename: 'es6-file.js', + sourceMap: true, + // 其他设置 + modules: 'commonjs' +}); + +if (result.error) + throw result.error; + +// result 对象的 js 属性就是转换后的 ES5 代码 +fs.writeFileSync('out.js', result.js); +// sourceMap 属性对应 map 文件 +fs.writeFileSync('out.js.map', result.sourceMap); +``` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/iterator.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/iterator.md" old mode 100644 new mode 100755 similarity index 68% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/iterator.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/iterator.md" index 62c388f2c..a39352c4a --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/iterator.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/iterator.md" @@ -1,14 +1,14 @@ -# Iterator和for...of循环 +# Iterator 和 for...of 循环 ## Iterator(遍历器)的概念 -JavaScript原有的表示“集合”的数据结构,主要是数组(Array)和对象(Object),ES6又添加了Map和Set。这样就有了四种数据集合,用户还可以组合使用它们,定义自己的数据结构,比如数组的成员是Map,Map的成员是对象。这样就需要一种统一的接口机制,来处理所有不同的数据结构。 +JavaScript 原有的表示“集合”的数据结构,主要是数组(`Array`)和对象(`Object`),ES6 又添加了`Map`和`Set`。这样就有了四种数据集合,用户还可以组合使用它们,定义自己的数据结构,比如数组的成员是`Map`,`Map`的成员是对象。这样就需要一种统一的接口机制,来处理所有不同的数据结构。 -遍历器(Iterator)就是这样一种机制。它是一种接口,为各种不同的数据结构提供统一的访问机制。任何数据结构只要部署Iterator接口,就可以完成遍历操作(即依次处理该数据结构的所有成员)。 +遍历器(Iterator)就是这样一种机制。它是一种接口,为各种不同的数据结构提供统一的访问机制。任何数据结构只要部署 Iterator 接口,就可以完成遍历操作(即依次处理该数据结构的所有成员)。 -Iterator的作用有三个:一是为各种数据结构,提供一个统一的、简便的访问接口;二是使得数据结构的成员能够按某种次序排列;三是ES6创造了一种新的遍历命令`for...of`循环,Iterator接口主要供`for...of`消费。 +Iterator 的作用有三个:一是为各种数据结构,提供一个统一的、简便的访问接口;二是使得数据结构的成员能够按某种次序排列;三是 ES6 创造了一种新的遍历命令`for...of`循环,Iterator 接口主要供`for...of`消费。 -Iterator的遍历过程是这样的。 +Iterator 的遍历过程是这样的。 (1)创建一个指针对象,指向当前数据结构的起始位置。也就是说,遍历器对象本质上,就是一个指针对象。 @@ -64,14 +64,14 @@ function makeIterator(array) { } ``` -由于Iterator只是把接口规格加到数据结构之上,所以,遍历器与它所遍历的那个数据结构,实际上是分开的,完全可以写出没有对应数据结构的遍历器对象,或者说用遍历器对象模拟出数据结构。下面是一个无限运行的遍历器对象的例子。 +由于 Iterator 只是把接口规格加到数据结构之上,所以,遍历器与它所遍历的那个数据结构,实际上是分开的,完全可以写出没有对应数据结构的遍历器对象,或者说用遍历器对象模拟出数据结构。下面是一个无限运行的遍历器对象的例子。 ```javascript var it = idMaker(); -it.next().value // '0' -it.next().value // '1' -it.next().value // '2' +it.next().value // 0 +it.next().value // 1 +it.next().value // 2 // ... function idMaker() { @@ -87,9 +87,7 @@ function idMaker() { 上面的例子中,遍历器生成函数`idMaker`,返回一个遍历器对象(即指针对象)。但是并没有对应的数据结构,或者说,遍历器对象自己描述了一个数据结构出来。 -在ES6中,有些数据结构原生具备Iterator接口(比如数组),即不用任何处理,就可以被`for...of`循环遍历,有些就不行(比如对象)。原因在于,这些数据结构原生部署了`Symbol.iterator`属性(详见下文),另外一些数据结构没有。凡是部署了`Symbol.iterator`属性的数据结构,就称为部署了遍历器接口。调用这个接口,就会返回一个遍历器对象。 - -如果使用TypeScript的写法,遍历器接口(Iterable)、指针对象(Iterator)和next方法返回值的规格可以描述如下。 +如果使用 TypeScript 的写法,遍历器接口(Iterable)、指针对象(Iterator)和`next`方法返回值的规格可以描述如下。 ```javascript interface Iterable { @@ -106,13 +104,13 @@ interface IterationResult { } ``` -## 数据结构的默认Iterator接口 +## 默认 Iterator 接口 -Iterator接口的目的,就是为所有数据结构,提供了一种统一的访问机制,即`for...of`循环(详见下文)。当使用`for...of`循环遍历某种数据结构时,该循环会自动去寻找Iterator接口。 +Iterator 接口的目的,就是为所有数据结构,提供了一种统一的访问机制,即`for...of`循环(详见下文)。当使用`for...of`循环遍历某种数据结构时,该循环会自动去寻找 Iterator 接口。 -一种数据结构只要部署了Iterator接口,我们就称这种数据结构是”可遍历的“(iterable)。 +一种数据结构只要部署了 Iterator 接口,我们就称这种数据结构是“可遍历的”(iterable)。 -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》一章)。 ```javascript const obj = { @@ -131,7 +129,19 @@ const obj = { 上面代码中,对象`obj`是可遍历的(iterable),因为具有`Symbol.iterator`属性。执行这个属性,会返回一个遍历器对象。该对象的根本特征就是具有`next`方法。每次调用`next`方法,都会返回一个代表当前成员的信息对象,具有`value`和`done`两个属性。 -在ES6中,有三类数据结构原生具备Iterator接口:数组、某些类似数组的对象、Set和Map结构。 +ES6 的有些数据结构原生具备 Iterator 接口(比如数组),即不用任何处理,就可以被`for...of`循环遍历。原因在于,这些数据结构原生部署了`Symbol.iterator`属性(详见下文),另外一些数据结构没有(比如对象)。凡是部署了`Symbol.iterator`属性的数据结构,就称为部署了遍历器接口。调用这个接口,就会返回一个遍历器对象。 + +原生具备 Iterator 接口的数据结构如下。 + +- Array +- Map +- Set +- String +- TypedArray +- 函数的 arguments 对象 +- NodeList 对象 + +下面的例子是数组的`Symbol.iterator`属性。 ```javascript let arr = ['a', 'b', 'c']; @@ -145,11 +155,11 @@ iter.next() // { value: undefined, done: true } 上面代码中,变量`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 class RangeIterator { @@ -175,11 +185,11 @@ function range(start, stop) { } for (var value of range(0, 3)) { - console.log(value); + console.log(value); // 0, 1, 2 } ``` -上面代码是一个类部署Iterator接口的写法。`Symbol.iterator`属性对应一个函数,执行后返回当前对象的遍历器对象。 +上面代码是一个类部署 Iterator 接口的写法。`Symbol.iterator`属性对应一个函数,执行后返回当前对象的遍历器对象。 下面是通过遍历器实现指针结构的例子。 @@ -190,9 +200,7 @@ function Obj(value) { } Obj.prototype[Symbol.iterator] = function() { - var iterator = { - next: next - }; + var iterator = { next: next }; var current = this; @@ -200,14 +208,9 @@ Obj.prototype[Symbol.iterator] = function() { if (current) { var value = current.value; current = current.next; - return { - done: false, - value: value - }; + return { done: false, value: value }; } else { - return { - done: true - }; + return { done: true }; } } return iterator; @@ -221,16 +224,13 @@ one.next = two; two.next = three; for (var i of one){ - console.log(i); + console.log(i); // 1, 2, 3 } -// 1 -// 2 -// 3 ``` 上面代码首先在构造函数的原型链上部署`Symbol.iterator`方法,调用该方法会返回遍历器对象`iterator`,调用该对象的`next`方法,在返回一个值的同时,自动将内部指针移到下一个实例。 -下面是另一个为对象添加Iterator接口的例子。 +下面是另一个为对象添加 Iterator 接口的例子。 ```javascript let obj = { @@ -254,7 +254,7 @@ let obj = { }; ``` -对于类似数组的对象(存在数值键名和length属性),部署Iterator接口,有一个简便方法,就是`Symbol.iterator`方法直接引用数组的Iterator接口。 +对于类似数组的对象(存在数值键名和`length`属性),部署 Iterator 接口,有一个简便方法,就是`Symbol.iterator`方法直接引用数组的 Iterator 接口。 ```javascript NodeList.prototype[Symbol.iterator] = Array.prototype[Symbol.iterator]; @@ -264,7 +264,9 @@ NodeList.prototype[Symbol.iterator] = [][Symbol.iterator]; [...document.querySelectorAll('div')] // 可以执行了 ``` -下面是类似数组的对象调用数组的`Symbol.iterator`方法的例子。 +NodeList 对象是类似数组的对象,本来就具有遍历接口,可以直接遍历。上面代码中,我们将它的遍历接口改成数组的`Symbol.iterator`属性,可以看到没有任何影响。 + +下面是另一个类似数组的对象调用数组的`Symbol.iterator`方法的例子。 ```javascript let iterable = { @@ -304,7 +306,7 @@ obj[Symbol.iterator] = () => 1; [...obj] // TypeError: [] is not a function ``` -上面代码中,变量obj的Symbol.iterator方法对应的不是遍历器生成函数,因此报错。 +上面代码中,变量`obj`的`Symbol.iterator`方法对应的不是遍历器生成函数,因此报错。 有了遍历器接口,数据结构就可以用`for...of`循环遍历(详见下文),也可以使用`while`循环遍历。 @@ -320,13 +322,13 @@ while (!$result.done) { 上面代码中,`ITERABLE`代表某种可遍历的数据结构,`$iterator`是它的遍历器对象。遍历器对象每次移动指针(`next`方法),都检查一下返回值的`done`属性,如果遍历还没结束,就移动遍历器对象的指针到下一步(`next`方法),不断循环。 -## 调用Iterator接口的场合 +## 调用 Iterator 接口的场合 -有一些场合会默认调用Iterator接口(即`Symbol.iterator`方法),除了下文会介绍的`for...of`循环,还有几个别的场合。 +有一些场合会默认调用 Iterator 接口(即`Symbol.iterator`方法),除了下文会介绍的`for...of`循环,还有几个别的场合。 **(1)解构赋值** -对数组和Set结构进行解构赋值时,会默认调用`Symbol.iterator`方法。 +对数组和 Set 结构进行解构赋值时,会默认调用`Symbol.iterator`方法。 ```javascript let set = new Set().add('a').add('b').add('c'); @@ -340,7 +342,7 @@ let [first, ...rest] = set; **(2)扩展运算符** -扩展运算符(...)也会调用默认的iterator接口。 +扩展运算符(...)也会调用默认的 Iterator 接口。 ```javascript // 例一 @@ -353,17 +355,17 @@ let arr = ['b', 'c']; // ['a', 'b', 'c', 'd'] ``` -上面代码的扩展运算符内部就调用Iterator接口。 +上面代码的扩展运算符内部就调用 Iterator 接口。 -实际上,这提供了一种简便机制,可以将任何部署了Iterator接口的数据结构,转为数组。也就是说,只要某个数据结构部署了Iterator接口,就可以对它使用扩展运算符,将其转为数组。 +实际上,这提供了一种简便机制,可以将任何部署了 Iterator 接口的数据结构,转为数组。也就是说,只要某个数据结构部署了 Iterator 接口,就可以对它使用扩展运算符,将其转为数组。 ```javascript let arr = [...iterable]; ``` -**(3)yield* ** +**(3)yield\*** -yield*后面跟的是一个可遍历的结构,它会调用该结构的遍历器接口。 +`yield*`后面跟的是一个可遍历的结构,它会调用该结构的遍历器接口。 ```javascript let generator = function* () { @@ -392,9 +394,9 @@ iterator.next() // { value: undefined, done: true } - Promise.all() - Promise.race() -## 字符串的Iterator接口 +## 字符串的 Iterator 接口 -字符串是一个类似数组的对象,也原生具有Iterator接口。 +字符串是一个类似数组的对象,也原生具有 Iterator 接口。 ```javascript var someString = "hi"; @@ -408,7 +410,7 @@ iterator.next() // { value: "i", done: false } iterator.next() // { value: undefined, done: true } ``` -上面代码中,调用`Symbol.iterator`方法返回一个遍历器对象,在这个遍历器上可以调用next方法,实现对于字符串的遍历。 +上面代码中,调用`Symbol.iterator`方法返回一个遍历器对象,在这个遍历器上可以调用 next 方法,实现对于字符串的遍历。 可以覆盖原生的`Symbol.iterator`方法,达到修改遍历器行为的目的。 @@ -435,20 +437,20 @@ str[Symbol.iterator] = function() { str // "hi" ``` -上面代码中,字符串str的`Symbol.iterator`方法被修改了,所以扩展运算符(`...`)返回的值变成了`bye`,而字符串本身还是`hi`。 +上面代码中,字符串 str 的`Symbol.iterator`方法被修改了,所以扩展运算符(`...`)返回的值变成了`bye`,而字符串本身还是`hi`。 -## Iterator接口与Generator函数 +## Iterator 接口与 Generator 函数 -`Symbol.iterator`方法的最简单实现,还是使用下一章要介绍的Generator函数。 +`Symbol.iterator`方法的最简单实现,还是使用下一章要介绍的 Generator 函数。 ```javascript -var myIterable = {}; - -myIterable[Symbol.iterator] = function* () { - yield 1; - yield 2; - yield 3; -}; +let myIterable = { + [Symbol.iterator]: function* () { + yield 1; + yield 2; + yield 3; + } +} [...myIterable] // [1, 2, 3] // 或者采用下面的简洁写法 @@ -463,53 +465,63 @@ let obj = { for (let x of obj) { console.log(x); } -// hello -// world +// "hello" +// "world" ``` -上面代码中,`Symbol.iterator`方法几乎不用部署任何代码,只要用yield命令给出每一步的返回值即可。 +上面代码中,`Symbol.iterator`方法几乎不用部署任何代码,只要用 yield 命令给出每一步的返回值即可。 -## 遍历器对象的return(),throw() +## 遍历器对象的 return(),throw() 遍历器对象除了具有`next`方法,还可以具有`return`方法和`throw`方法。如果你自己写遍历器对象生成函数,那么`next`方法是必须部署的,`return`方法和`throw`方法是否部署是可选的。 -`return`方法的使用场合是,如果`for...of`循环提前退出(通常是因为出错,或者有`break`语句或`continue`语句),就会调用`return`方法。如果一个对象在完成遍历前,需要清理或释放资源,就可以部署`return`方法。 +`return`方法的使用场合是,如果`for...of`循环提前退出(通常是因为出错,或者有`break`语句),就会调用`return`方法。如果一个对象在完成遍历前,需要清理或释放资源,就可以部署`return`方法。 ```javascript function readLinesSync(file) { return { - next() { - if (file.isAtEndOfFile()) { - file.close(); - return { done: true }; - } - }, - return() { - file.close(); - return { done: true }; + [Symbol.iterator]() { + return { + next() { + return { done: false }; + }, + return() { + file.close(); + return { done: true }; + } + }; }, }; } ``` -上面代码中,函数`readLinesSync`接受一个文件对象作为参数,返回一个遍历器对象,其中除了`next`方法,还部署了`return`方法。下面,我们让文件的遍历提前返回,这样就会触发执行`return`方法。 +上面代码中,函数`readLinesSync`接受一个文件对象作为参数,返回一个遍历器对象,其中除了`next`方法,还部署了`return`方法。下面的两种情况,都会触发执行`return`方法。 ```javascript +// 情况一 for (let line of readLinesSync(fileName)) { console.log(line); break; } + +// 情况二 +for (let line of readLinesSync(fileName)) { + console.log(line); + throw new Error(); +} ``` -注意,`return`方法必须返回一个对象,这是Generator规格决定的。 +上面代码中,情况一输出文件的第一行以后,就会执行`return`方法,关闭这个文件;情况二会在执行`return`方法关闭文件之后,再抛出错误。 + +注意,`return`方法必须返回一个对象,这是 Generator 规格决定的。 -`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`方法。 +一个数据结构只要部署了`Symbol.iterator`属性,就被视为具有 iterator 接口,就可以用`for...of`循环遍历它的成员。也就是说,`for...of`循环内部调用的是数据结构的`Symbol.iterator`方法。 `for...of`循环可以使用的范围包括数组、Set 和 Map 结构、某些类似数组的对象(比如`arguments`对象、DOM NodeList 对象)、后文的 Generator 对象,以及字符串。 @@ -545,7 +557,7 @@ arr.forEach(function (element, index) { }); ``` -JavaScript原有的`for...in`循环,只能获得对象的键名,不能直接获取键值。ES6提供`for...of`循环,允许遍历获得键值。 +JavaScript 原有的`for...in`循环,只能获得对象的键名,不能直接获取键值。ES6 提供`for...of`循环,允许遍历获得键值。 ```javascript var arr = ['a', 'b', 'c', 'd']; @@ -559,7 +571,7 @@ for (let a of arr) { } ``` -上面代码表明,`for...in`循环读取键名,`for...of`循环读取键值。如果要通过`for...of`循环,获取数组的索引,可以借助数组实例的`entries`方法和`keys`方法,参见《数组的扩展》章节。 +上面代码表明,`for...in`循环读取键名,`for...of`循环读取键值。如果要通过`for...of`循环,获取数组的索引,可以借助数组实例的`entries`方法和`keys`方法(参见《数组的扩展》一章)。 `for...of`循环调用遍历器接口,数组的遍历器接口只返回具有数字索引的属性。这一点跟`for...in`循环也不一样。 @@ -578,7 +590,7 @@ for (let i of arr) { 上面代码中,`for...of`循环不会返回数组`arr`的`foo`属性。 -### Set和Map结构 +### Set 和 Map 结构 Set 和 Map 结构也原生具有 Iterator 接口,可以直接使用`for...of`循环。 @@ -622,7 +634,7 @@ for (let [key, value] of map) { ### 计算生成的数据结构 -有些数据结构是在现有数据结构的基础上,计算生成的。比如,ES6的数组、Set、Map 都部署了以下三个方法,调用后都返回遍历器对象。 +有些数据结构是在现有数据结构的基础上,计算生成的。比如,ES6 的数组、Set、Map 都部署了以下三个方法,调用后都返回遍历器对象。 - `entries()` 返回一个遍历器对象,用来遍历`[键名, 键值]`组成的数组。对于数组,键名就是索引值;对于 Set,键名与键值相同。Map 结构的 Iterator 接口,默认就是调用`entries`方法。 - `keys()` 返回一个遍历器对象,用来遍历所有的键名。 @@ -670,7 +682,7 @@ printArgs('a', 'b'); // 'b' ``` -对于字符串来说,`for...of`循环还有一个特点,就是会正确识别32位 UTF-16 字符。 +对于字符串来说,`for...of`循环还有一个特点,就是会正确识别 32 位 UTF-16 字符。 ```javascript for (let x of 'a\uD83D\uDC0A') { @@ -717,7 +729,7 @@ for (let e in es6) { for (let e of es6) { console.log(e); } -// TypeError: es6 is not iterable +// TypeError: es6[Symbol.iterator] is not a function ``` 上面代码表示,对于普通的对象,`for...in`循环可以遍历键名,`for...of`循环会报错。 @@ -792,10 +804,10 @@ for (let value of myArray) { ``` - 有着同`for...in`一样的简洁语法,但是没有`for...in`那些缺点。 -- 不同用于`forEach`方法,它可以与`break`、`continue`和`return`配合使用。 +- 不同于`forEach`方法,它可以与`break`、`continue`和`return`配合使用。 - 提供了遍历所有数据结构的统一操作接口。 -下面是一个使用break语句,跳出`for...of`循环的例子。 +下面是一个使用 break 语句,跳出`for...of`循环的例子。 ```javascript for (var n of fibonacci) { @@ -805,5 +817,4 @@ for (var n of fibonacci) { } ``` -上面的例子,会输出斐波纳契数列小于等于1000的项。如果当前项大于1000,就会使用`break`语句跳出`for...of`循环。 - +上面的例子,会输出斐波纳契数列小于等于 1000 的项。如果当前项大于 1000,就会使用`break`语句跳出`for...of`循环。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/let.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/let.md" old mode 100644 new mode 100755 similarity index 76% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/let.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/let.md" index 7c42ed921..741e876a1 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/let.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/let.md" @@ -1,10 +1,10 @@ -# let和const命令 +# let 和 const 命令 -## let命令 +## let 命令 ### 基本用法 -ES6新增了`let`命令,用来声明变量。它的用法类似于`var`,但是所声明的变量,只在`let`命令所在的代码块内有效。 +ES6 新增了`let`命令,用来声明变量。它的用法类似于`var`,但是所声明的变量,只在`let`命令所在的代码块内有效。 ```javascript { @@ -21,10 +21,12 @@ b // 1 `for`循环的计数器,就很合适使用`let`命令。 ```javascript -for (let i = 0; i < 10; i++) {} +for (let i = 0; i < 10; i++) { + // ... +} console.log(i); -//ReferenceError: i is not defined +// ReferenceError: i is not defined ``` 上面代码中,计数器`i`只在`for`循环体内有效,在循环体外引用就会报错。 @@ -41,9 +43,9 @@ for (var i = 0; i < 10; i++) { a[6](); // 10 ``` -上面代码中,变量`i`是`var`声明的,在全局范围内都有效,所以全局只有一个变量`i`。每一次循环,变量`i`的值都会发生改变,而循环内被赋给数组`a`的`function`在运行时,会通过闭包读到这同一个变量`i`,导致最后输出的是最后一轮的`i`的值,也就是10。 +上面代码中,变量`i`是`var`命令声明的,在全局范围内都有效,所以全局只有一个变量`i`。每一次循环,变量`i`的值都会发生改变,而循环内被赋给数组`a`的函数内部的`console.log(i)`,里面的`i`指向的就是全局的`i`。也就是说,所有数组`a`的成员里面的`i`,指向的都是同一个`i`,导致运行时输出的是最后一轮的`i`的值,也就是 10。 -而如果使用`let`,声明的变量仅在块级作用域内有效,最后输出的是6。 +如果使用`let`,声明的变量仅在块级作用域内有效,最后输出的是 6。 ```javascript var a = []; @@ -57,7 +59,7 @@ a[6](); // 6 上面代码中,变量`i`是`let`声明的,当前的`i`只在本轮循环有效,所以每一次循环的`i`其实都是一个新的变量,所以最后输出的是`6`。你可能会问,如果每一轮循环的变量`i`都是重新声明的,那它怎么知道上一轮循环的值,从而计算出本轮循环的值?这是因为 JavaScript 引擎内部会记住上一轮循环的值,初始化本轮的变量`i`时,就在上一轮循环的基础上进行计算。 -另外,`for`循环还有一个特别之处,就是循环语句部分是一个父作用域,而循环体内部是一个单独的子作用域。 +另外,`for`循环还有一个特别之处,就是设置循环变量的那部分是一个父作用域,而循环体内部是一个单独的子作用域。 ```javascript for (let i = 0; i < 3; i++) { @@ -69,11 +71,11 @@ for (let i = 0; i < 3; i++) { // abc ``` -上面代码输出了3次`abc`,这表明函数内部的变量`i`和外部的变量`i`是分离的。 +上面代码正确运行,输出了 3 次`abc`。这表明函数内部的变量`i`与循环变量`i`不在同一个作用域,有各自单独的作用域。 ### 不存在变量提升 -`var`命令会发生”变量提升“现象,即变量可以在声明之前使用,值为`undefined`。这种现象多多少少是有些奇怪的,按照一般的逻辑,变量应该在声明语句之后才可以使用。 +`var`命令会发生“变量提升”现象,即变量可以在声明之前使用,值为`undefined`。这种现象多多少少是有些奇怪的,按照一般的逻辑,变量应该在声明语句之后才可以使用。 为了纠正这种现象,`let`命令改变了语法行为,它所声明的变量一定要在声明后使用,否则报错。 @@ -104,7 +106,7 @@ if (true) { 上面代码中,存在全局变量`tmp`,但是块级作用域内`let`又声明了一个局部变量`tmp`,导致后者绑定这个块级作用域,所以在`let`声明变量前,对`tmp`赋值会报错。 -ES6明确规定,如果区块中存在`let`和`const`命令,这个区块对这些命令声明的变量,从一开始就形成了封闭作用域。凡是在声明之前就使用这些变量,就会报错。 +ES6 明确规定,如果区块中存在`let`和`const`命令,这个区块对这些命令声明的变量,从一开始就形成了封闭作用域。凡是在声明之前就使用这些变量,就会报错。 总之,在代码块内,使用`let`命令声明变量之前,该变量都是不可用的。这在语法上,称为“暂时性死区”(temporal dead zone,简称 TDZ)。 @@ -151,7 +153,7 @@ function bar(x = y, y = 2) { bar(); // 报错 ``` -上面代码中,调用`bar`函数之所以报错(某些实现可能不报错),是因为参数`x`默认值等于另一个参数`y`,而此时`y`还没有声明,属于”死区“。如果`y`的默认值是`x`,就不会报错,因为此时`x`已经声明了。 +上面代码中,调用`bar`函数之所以报错(某些实现可能不报错),是因为参数`x`默认值等于另一个参数`y`,而此时`y`还没有声明,属于“死区”。如果`y`的默认值是`x`,就不会报错,因为此时`x`已经声明了。 ```javascript function bar(x = 2, y = x) { @@ -183,13 +185,13 @@ ES6 规定暂时性死区和`let`、`const`语句不出现变量提升,主要 ```javascript // 报错 -function () { +function func() { let a = 10; var a = 1; } // 报错 -function () { +function func() { let a = 10; let a = 1; } @@ -199,14 +201,16 @@ function () { ```javascript function func(arg) { - let arg; // 报错 + let arg; } +func() // 报错 function func(arg) { { - let arg; // 不报错 + let arg; } } +func() // 不报错 ``` ## 块级作用域 @@ -260,7 +264,7 @@ function f1() { } ``` -上面的函数有两个代码块,都声明了变量`n`,运行后输出5。这表示外层代码块不受内层代码块的影响。如果使用`var`定义变量`n`,最后输出的值就是10。 +上面的函数有两个代码块,都声明了变量`n`,运行后输出 5。这表示外层代码块不受内层代码块的影响。如果两次都使用`var`定义变量`n`,最后输出的值才是 10。 ES6 允许块级作用域的任意嵌套。 @@ -357,7 +361,7 @@ function f() { console.log('I am outside!'); } ES6 就完全不一样了,理论上会得到“I am outside!”。因为块级作用域内声明的函数类似于`let`,对作用域之外没有影响。但是,如果你真的在 ES6 浏览器中运行一下上面的代码,是会报错的,这是为什么呢? -原来,如果改变了块级作用域内声明的函数的处理规则,显然会对老代码产生很大影响。为了减轻因此产生的不兼容问题,ES6在[附录B](http://www.ecma-international.org/ecma-262/6.0/index.html#sec-block-level-function-declarations-web-legacy-compatibility-semantics)里面规定,浏览器的实现可以不遵守上面的规定,有自己的[行为方式](http://stackoverflow.com/questions/31419897/what-are-the-precise-semantics-of-block-level-functions-in-es6)。 +原来,如果改变了块级作用域内声明的函数的处理规则,显然会对老代码产生很大影响。为了减轻因此产生的不兼容问题,ES6 在[附录 B](http://www.ecma-international.org/ecma-262/6.0/index.html#sec-block-level-function-declarations-web-legacy-compatibility-semantics)里面规定,浏览器的实现可以不遵守上面的规定,有自己的[行为方式](http://stackoverflow.com/questions/31419897/what-are-the-precise-semantics-of-block-level-functions-in-es6)。 - 允许在块级作用域内声明函数。 - 函数声明类似于`var`,即会提升到全局作用域或函数作用域的头部。 @@ -433,30 +437,6 @@ if (true) function f() {} ``` -### do 表达式 - -本质上,块级作用域是一个语句,将多个操作封装在一起,没有返回值。 - -```javascript -{ - let t = f(); - t = t * t + 1; -} -``` - -上面代码中,块级作用域将两个语句封装在一起。但是,在块级作用域以外,没有办法得到`t`的值,因为块级作用域不返回值,除非`t`是全局变量。 - -现在有一个[提案](http://wiki.ecmascript.org/doku.php?id=strawman:do_expressions),使得块级作用域可以变为表达式,也就是说可以返回值,办法就是在块级作用域之前加上`do`,使它变为`do`表达式。 - -```javascript -let x = do { - let t = f(); - t * t + 1; -}; -``` - -上面代码中,变量`x`会得到整个块级作用域的返回值。 - ## const 命令 ### 基本用法 @@ -516,7 +496,7 @@ const age = 30; ### 本质 -`const`实际上保证的,并不是变量的值不得改动,而是变量指向的那个内存地址不得改动。对于简单类型的数据(数值、字符串、布尔值),值就保存在变量指向的那个内存地址,因此等同于常量。但对于复合类型的数据(主要是对象和数组),变量指向的内存地址,保存的只是一个指针,`const`只能保证这个指针是固定的,至于它指向的数据结构是不是可变的,就完全不能控制了。因此,将一个对象声明为常量必须非常小心。 +`const`实际上保证的,并不是变量的值不得改动,而是变量指向的那个内存地址所保存的数据不得改动。对于简单类型的数据(数值、字符串、布尔值),值就保存在变量指向的那个内存地址,因此等同于常量。但对于复合类型的数据(主要是对象和数组),变量指向的内存地址,保存的只是一个指向实际数据的指针,`const`只能保证这个指针是固定的(即总是指向另一个固定的地址),至于它指向的数据结构是不是可变的,就完全不能控制了。因此,将一个对象声明为常量必须非常小心。 ```javascript const foo = {}; @@ -569,11 +549,11 @@ var constantize = (obj) => { ### ES6 声明变量的六种方法 -ES5 只有两种声明变量的方法:`var`命令和`function`命令。ES6除了添加`let`和`const`命令,后面章节还会提到,另外两种声明变量的方法:`import`命令和`class`命令。所以,ES6 一共有6种声明变量的方法。 +ES5 只有两种声明变量的方法:`var`命令和`function`命令。ES6 除了添加`let`和`const`命令,后面章节还会提到,另外两种声明变量的方法:`import`命令和`class`命令。所以,ES6 一共有 6 种声明变量的方法。 ## 顶层对象的属性 -顶层对象,在浏览器环境指的是`window`对象,在Node指的是`global`对象。ES5之中,顶层对象的属性与全局变量是等价的。 +顶层对象,在浏览器环境指的是`window`对象,在 Node 指的是`global`对象。ES5 之中,顶层对象的属性与全局变量是等价的。 ```javascript window.a = 1; @@ -585,14 +565,14 @@ window.a // 2 上面代码中,顶层对象的属性赋值与全局变量的赋值,是同一件事。 -顶层对象的属性与全局变量挂钩,被认为是JavaScript语言最大的设计败笔之一。这样的设计带来了几个很大的问题,首先是没法在编译时就报出变量未声明的错误,只有运行时才能知道(因为全局变量可能是顶层对象的属性创造的,而属性的创造是动态的);其次,程序员很容易不知不觉地就创建了全局变量(比如打字出错);最后,顶层对象的属性是到处可以读写的,这非常不利于模块化编程。另一方面,`window`对象有实体含义,指的是浏览器的窗口对象,顶层对象是一个有实体含义的对象,也是不合适的。 +顶层对象的属性与全局变量挂钩,被认为是 JavaScript 语言最大的设计败笔之一。这样的设计带来了几个很大的问题,首先是没法在编译时就报出变量未声明的错误,只有运行时才能知道(因为全局变量可能是顶层对象的属性创造的,而属性的创造是动态的);其次,程序员很容易不知不觉地就创建了全局变量(比如打字出错);最后,顶层对象的属性是到处可以读写的,这非常不利于模块化编程。另一方面,`window`对象有实体含义,指的是浏览器的窗口对象,顶层对象是一个有实体含义的对象,也是不合适的。 -ES6为了改变这一点,一方面规定,为了保持兼容性,`var`命令和`function`命令声明的全局变量,依旧是顶层对象的属性;另一方面规定,`let`命令、`const`命令、`class`命令声明的全局变量,不属于顶层对象的属性。也就是说,从ES6开始,全局变量将逐步与顶层对象的属性脱钩。 +ES6 为了改变这一点,一方面规定,为了保持兼容性,`var`命令和`function`命令声明的全局变量,依旧是顶层对象的属性;另一方面规定,`let`命令、`const`命令、`class`命令声明的全局变量,不属于顶层对象的属性。也就是说,从 ES6 开始,全局变量将逐步与顶层对象的属性脱钩。 ```javascript var a = 1; -// 如果在Node的REPL环境,可以写成global.a -// 或者采用通用方法,写成this.a +// 如果在 Node 的 REPL 环境,可以写成 global.a +// 或者采用通用方法,写成 this.a window.a // 1 let b = 1; @@ -603,17 +583,17 @@ window.b // undefined ## global 对象 -ES5的顶层对象,本身也是一个问题,因为它在各种实现里面是不统一的。 +ES5 的顶层对象,本身也是一个问题,因为它在各种实现里面是不统一的。 - 浏览器里面,顶层对象是`window`,但 Node 和 Web Worker 没有`window`。 -- 浏览器和 Web Worker 里面,`self`也指向顶层对象,但是Node没有`self`。 +- 浏览器和 Web Worker 里面,`self`也指向顶层对象,但是 Node 没有`self`。 - Node 里面,顶层对象是`global`,但其他环境都不支持。 同一段代码为了能够在各种环境,都能取到顶层对象,现在一般是使用`this`变量,但是有局限性。 -- 全局环境中,`this`会返回顶层对象。但是,Node模块和ES6模块中,`this`返回的是当前模块。 +- 全局环境中,`this`会返回顶层对象。但是,Node 模块和 ES6 模块中,`this`返回的是当前模块。 - 函数里面的`this`,如果函数不是作为对象的方法运行,而是单纯作为函数运行,`this`会指向顶层对象。但是,严格模式下,这时`this`会返回`undefined`。 -- 不管是严格模式,还是普通模式,`new Function('return this')()`,总是会返回全局对象。但是,如果浏览器用了CSP(Content Security Policy,内容安全政策),那么`eval`、`new Function`这些方法都可能无法使用。 +- 不管是严格模式,还是普通模式,`new Function('return this')()`,总是会返回全局对象。但是,如果浏览器用了 CSP(Content Security Policy,内容安全策略),那么`eval`、`new Function`这些方法都可能无法使用。 综上所述,很难找到一种方法,可以在所有情况下,都取到顶层对象。下面是两种勉强可以使用的方法。 @@ -641,23 +621,22 @@ var getGlobal = function () { 垫片库[`system.global`](https://github.com/ljharb/System.global)模拟了这个提案,可以在所有环境拿到`global`。 ```javascript -// CommonJS的写法 +// CommonJS 的写法 require('system.global/shim')(); -// ES6模块的写法 +// ES6 模块的写法 import shim from 'system.global/shim'; shim(); ``` 上面代码可以保证各种环境里面,`global`对象都是存在的。 ```javascript -// CommonJS的写法 +// CommonJS 的写法 var global = require('system.global')(); -// ES6模块的写法 +// ES6 模块的写法 import getGlobal from 'system.global'; const global = getGlobal(); ``` 上面代码将顶层对象放入变量`global`。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/mixin.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/mixin.md" old mode 100644 new mode 100755 similarity index 55% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/mixin.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/mixin.md" index 0c00d57c5..153bad301 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/mixin.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/mixin.md" @@ -1,12 +1,12 @@ # Mixin -JavaScript语言的设计是单一继承,即子类只能继承一个父类,不允许继承多个父类。这种设计保证了对象继承的层次结构是树状的,而不是复杂的[网状结构](https://en.wikipedia.org/wiki/Multiple_inheritance#The_diamond_problem)。 +JavaScript 语言的设计是单一继承,即子类只能继承一个父类,不允许继承多个父类。这种设计保证了对象继承的层次结构是树状的,而不是复杂的[网状结构](https://en.wikipedia.org/wiki/Multiple_inheritance#The_diamond_problem)。 但是,这大大降低了编程的灵活性。因为实际开发中,有时不可避免,子类需要继承多个父类。举例来说,“猫”可以继承“哺乳类动物”,也可以继承“宠物”。 -各种单一继承的编程语言,有不同的多重继承解决方案。比如,Java语言也是子类只能继承一个父类,但是还允许继承多个界面(interface),这样就间接实现了多重继承。Interface与父类一样,也是一个类,只不过它只定义接口(method signature),不定义实现,因此又被称为“抽象类”。凡是继承于Interface的方法,都必须自己定义实现,否则就会报错。这样就避免了多重继承的最大问题:多个父类的同名方法的碰撞(naming collision)。 +各种单一继承的编程语言,有不同的多重继承解决方案。比如,Java 语言也是子类只能继承一个父类,但是还允许继承多个界面(interface),这样就间接实现了多重继承。Interface 与父类一样,也是一个类,只不过它只定义接口(method signature),不定义实现,因此又被称为“抽象类”。凡是继承于 Interface 的方法,都必须自己定义实现,否则就会报错。这样就避免了多重继承的最大问题:多个父类的同名方法的碰撞(naming collision)。 -JavaScript语言没有采用Interface的方案,而是通过代理(delegation)实现了从其他类引入方法。 +JavaScript 语言没有采用 Interface 的方案,而是通过代理(delegation)实现了从其他类引入方法。 ```javascript var Enumerable_first = function () { @@ -24,15 +24,15 @@ list.first() // "foo" ## 含义 -Mixin这个名字来自于冰淇淋,在基本口味的冰淇淋上面混入其他口味,这就叫做Mix-in。 +Mixin 这个名字来自于冰淇淋,在基本口味的冰淇淋上面混入其他口味,这就叫做 Mix-in。 它允许向一个类里面注入一些代码,使得一个类的功能能够“混入”另一个类。实质上是多重继承的一种解决方案,但是避免了多重继承的复杂性,而且有利于代码复用。 -Mixin就是一个正常的类,不仅定义了接口,还定义了接口的实现。 +Mixin 就是一个正常的类,不仅定义了接口,还定义了接口的实现。 子类通过在`this`对象上面绑定方法,达到多重继承的目的。 -很多库提供了Mixin功能。下面以Lodash为例。 +很多库提供了 Mixin 功能。下面以 Lodash 为例。 ```javascript function vowels(string) { @@ -44,9 +44,9 @@ _.mixin(obj, {vowels: vowels}) obj.vowels() // true ``` -上面代码通过Lodash库的`_.mixin`方法,让`obj`对象继承了`vowels`方法。 +上面代码通过 Lodash 库的`_.mixin`方法,让`obj`对象继承了`vowels`方法。 -Underscore的类似方法是`_.extend`。 +Underscore 的类似方法是`_.extend`。 ```javascript var Person = function (fName, lName) { @@ -90,7 +90,7 @@ function extend(destination, source) { ## Trait -Trait是另外一种多重继承的解决方案。它与Mixin很相似,但是有一些细微的差别。 +Trait 是另外一种多重继承的解决方案。它与 Mixin 很相似,但是有一些细微的差别。 -- Mixin可以包含状态(state),Trait不包含,即Trait里面的方法都是互不相干,可以线性包含的。比如,`Trait1`包含方法`A`和`B`,`Trait2`继承了`Trait1`,同时还包含一个自己的方法`C`,实际上就等同于直接包含方法`A`、`B`、`C`。 -- 对于同名方法的碰撞,Mixin包含了解决规则,Trait则是报错。 +- Mixin 可以包含状态(state),Trait 不包含,即 Trait 里面的方法都是互不相干,可以线性包含的。比如,`Trait1`包含方法`A`和`B`,`Trait2`继承了`Trait1`,同时还包含一个自己的方法`C`,实际上就等同于直接包含方法`A`、`B`、`C`。 +- 对于同名方法的碰撞,Mixin 包含了解决规则,Trait 则是报错。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/module-loader.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/module-loader.md" old mode 100644 new mode 100755 similarity index 60% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/module-loader.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/module-loader.md" index 036f9c01b..4a3fa0e50 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/module-loader.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/module-loader.md" @@ -6,7 +6,7 @@ ### 传统方法 -在 HTML 网页中,浏览器通过` @@ -32,14 +32,14 @@ 上面代码中,` + ``` 上面代码在网页中插入一个模块`foo.js`,由于`type`属性设为`module`,所以浏览器知道这是一个 ES6 模块。 @@ -47,17 +47,21 @@ 浏览器对于带有`type="module"`的` + - + ``` +如果网页有多个` + ``` +一旦使用了`async`属性,` ``` -上面代码中的`./app`,指的是当前目录下的app.js文件。它可以是ES6模块文件,`System.import`会自动将其转码。 +上面代码中的`./app`,指的是当前目录下的 app.js 文件。它可以是 ES6 模块文件,`System.import`会自动将其转码。 需要注意的是,`System.import`使用异步加载,返回一个 Promise 对象,可以针对这个对象编程。下面是一个模块文件。 @@ -803,4 +809,3 @@ System.import('app/es6-file').then(function(m) { ``` 上面代码中,`System.import`方法返回的是一个 Promise 对象,所以可以用`then`方法指定回调函数。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/module.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/module.md" old mode 100644 new mode 100755 similarity index 85% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/module.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/module.md" index 009592804..42482fe4f --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/module.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/module.md" @@ -6,7 +6,7 @@ 在 ES6 之前,社区制定了一些模块加载方案,最主要的有 CommonJS 和 AMD 两种。前者用于服务器,后者用于浏览器。ES6 在语言标准的层面上,实现了模块功能,而且实现得相当简单,完全可以取代 CommonJS 和 AMD 规范,成为浏览器和服务器通用的模块解决方案。 -ES6 模块的设计思想,是尽量的静态化,使得编译时就能确定模块的依赖关系,以及输入和输出的变量。CommonJS 和 AMD 模块,都只能在运行时确定这些东西。比如,CommonJS 模块就是对象,输入时必须查找对象属性。 +ES6 模块的设计思想是尽量的静态化,使得编译时就能确定模块的依赖关系,以及输入和输出的变量。CommonJS 和 AMD 模块,都只能在运行时确定这些东西。比如,CommonJS 模块就是对象,输入时必须查找对象属性。 ```javascript // CommonJS模块 @@ -19,7 +19,7 @@ let exists = _fs.exists; let readfile = _fs.readfile; ``` -上面代码的实质是整体加载`fs`模块(即加载`fs`的所有方法),生成一个对象(`_fs`),然后再从这个对象上面读取3个方法。这种加载称为“运行时加载”,因为只有运行时才能得到这个对象,导致完全没办法在编译时做“静态优化”。 +上面代码的实质是整体加载`fs`模块(即加载`fs`的所有方法),生成一个对象(`_fs`),然后再从这个对象上面读取 3 个方法。这种加载称为“运行时加载”,因为只有运行时才能得到这个对象,导致完全没办法在编译时做“静态优化”。 ES6 模块不是对象,而是通过`export`命令显式指定输出的代码,再通过`import`命令输入。 @@ -28,7 +28,7 @@ ES6 模块不是对象,而是通过`export`命令显式指定输出的代码 import { stat, exists, readFile } from 'fs'; ``` -上面代码的实质是从`fs`模块加载3个方法,其他方法不加载。这种加载称为“编译时加载”或者静态加载,即 ES6 可以在编译时就完成模块加载,效率要比 CommonJS 模块的加载方式高。当然,这也导致了没法引用 ES6 模块本身,因为它不是对象。 +上面代码的实质是从`fs`模块加载 3 个方法,其他方法不加载。这种加载称为“编译时加载”或者静态加载,即 ES6 可以在编译时就完成模块加载,效率要比 CommonJS 模块的加载方式高。当然,这也导致了没法引用 ES6 模块本身,因为它不是对象。 由于 ES6 模块是编译时加载,使得静态分析成为可能。有了它,就能进一步拓宽 JavaScript 的语法,比如引入宏(macro)和类型检验(type system)这些只能靠静态分析实现的功能。 @@ -50,7 +50,7 @@ ES6 的模块自动采用严格模式,不管你有没有在模块头部加上` - 函数的参数不能有同名属性,否则报错 - 不能使用`with`语句 - 不能对只读属性赋值,否则报错 -- 不能使用前缀0表示八进制数,否则报错 +- 不能使用前缀 0 表示八进制数,否则报错 - 不能删除不可删除的属性,否则报错 - 不能删除变量`delete prop`,会报错,只能删除属性`delete global[prop]` - `eval`不会在它的外层作用域引入变量 @@ -130,7 +130,7 @@ var m = 1; export m; ``` -上面两种写法都会报错,因为没有提供对外的接口。第一种写法直接输出1,第二种写法通过变量`m`,还是直接输出1。`1`只是一个值,不是接口。正确的写法是下面这样。 +上面两种写法都会报错,因为没有提供对外的接口。第一种写法直接输出 1,第二种写法通过变量`m`,还是直接输出 1。`1`只是一个值,不是接口。正确的写法是下面这样。 ```javascript // 写法一 @@ -169,11 +169,11 @@ export var foo = 'bar'; setTimeout(() => foo = 'baz', 500); ``` -上面代码输出变量`foo`,值为`bar`,500毫秒之后变成`baz`。 +上面代码输出变量`foo`,值为`bar`,500 毫秒之后变成`baz`。 -这一点与 CommonJS 规范完全不同。CommonJS 模块输出的是值的缓存,不存在动态更新,详见下文《ES6模块加载的实质》一节。 +这一点与 CommonJS 规范完全不同。CommonJS 模块输出的是值的缓存,不存在动态更新,详见下文《Module 的加载实现》一节。 -最后,`export`命令可以出现在模块的任何位置,只要处于模块顶层就可以。如果处于块级作用域内,就会报错,下一节的`import`命令也是如此。这是因为处于条件代码块之中,就没法做静态优化了,违背了ES6模块的设计初衷。 +最后,`export`命令可以出现在模块的任何位置,只要处于模块顶层就可以。如果处于块级作用域内,就会报错,下一节的`import`命令也是如此。这是因为处于条件代码块之中,就没法做静态优化了,违背了 ES6 模块的设计初衷。 ```javascript function foo() { @@ -190,7 +190,7 @@ foo() ```javascript // main.js -import {firstName, lastName, year} from './profile'; +import {firstName, lastName, year} from './profile.js'; function setName(element) { element.textContent = firstName + ' ' + lastName; @@ -202,10 +202,28 @@ function setName(element) { 如果想为输入的变量重新取一个名字,`import`命令要使用`as`关键字,将输入的变量重命名。 ```javascript -import { lastName as surname } from './profile'; +import { lastName as surname } from './profile.js'; ``` -`import`后面的`from`指定模块文件的位置,可以是相对路径,也可以是绝对路径,`.js`路径可以省略。如果只是模块名,不带有路径,那么必须有配置文件,告诉 JavaScript 引擎该模块的位置。 +`import`命令输入的变量都是只读的,因为它的本质是输入接口。也就是说,不允许在加载模块的脚本里面,改写接口。 + +```javascript +import {a} from './xxx.js' + +a = {}; // Syntax Error : 'a' is read-only; +``` + +上面代码中,脚本加载了变量`a`,对其重新赋值就会报错,因为`a`是一个只读的接口。但是,如果`a`是一个对象,改写`a`的属性是允许的。 + +```javascript +import {a} from './xxx.js' + +a.foo = 'hello'; // 合法操作 +``` + +上面代码中,`a`的属性可以成功改写,并且其他模块也可以读到改写后的值。不过,这种写法很难查错,建议凡是输入的变量,都当作完全只读,轻易不要改变它的属性。 + +`import`后面的`from`指定模块文件的位置,可以是相对路径,也可以是绝对路径,`.js`后缀可以省略。如果只是模块名,不带有路径,那么必须有配置文件,告诉 JavaScript 引擎该模块的位置。 ```javascript import {myMethod} from 'util'; @@ -270,6 +288,14 @@ import { foo, bar } from 'my_module'; 上面代码中,虽然`foo`和`bar`在两个语句中加载,但是它们对应的是同一个`my_module`实例。也就是说,`import`语句是 Singleton 模式。 +目前阶段,通过 Babel 转码,CommonJS 模块的`require`命令和 ES6 模块的`import`命令,可以写在同一个模块里面,但是最好不要这样做。因为`import`在静态解析阶段执行,所以它是一个模块之中最早执行的。下面的代码可能不会得到预期结果。 + +```javascript +require('core-js/modules/es6.symbol'); +require('core-js/modules/es6.promise'); +import React from 'React'; +``` + ## 模块的整体加载 除了指定加载某个输出值,还可以使用整体加载,即用星号(`*`)指定一个对象,所有输出值都加载在这个对象上面。 @@ -382,7 +408,7 @@ import {crc32} from 'crc32'; // 输入 上面代码的两组写法,第一组是使用`export default`时,对应的`import`语句不需要使用大括号;第二组是不使用`export default`时,对应的`import`语句需要使用大括号。 -`export default`命令用于指定模块的默认输出。显然,一个模块只能有一个默认输出,因此`export default`命令只能使用一次。所以,`import`命令后面才不用加大括号,因为只可能对应一个方法。 +`export default`命令用于指定模块的默认输出。显然,一个模块只能有一个默认输出,因此`export default`命令只能使用一次。所以,import命令后面才不用加大括号,因为只可能唯一对应`export default`命令。 本质上,`export default`就是输出一个叫做`default`的变量或方法,然后系统允许你为它取任意名字。所以,下面的写法是有效的。 @@ -396,9 +422,9 @@ export {add as default}; // export default add; // app.js -import { default as xxx } from 'modules'; +import { default as foo } from 'modules'; // 等同于 -// import xxx from 'modules'; +// import foo from 'modules'; ``` 正是因为`export default`命令其实只是输出一个叫做`default`的变量,所以它后面不能跟变量声明语句。 @@ -417,7 +443,7 @@ export default var a = 1; 上面代码中,`export default a`的含义是将变量`a`的值赋给变量`default`。所以,最后一种写法会报错。 -同样地,因为`export default`本质是将该命令后面的值,赋给`default`变量以后再默认,所以直接将一个值写在`export default`之后。 +同样地,因为`export default`命令的本质是将后面的值,赋给`default`变量,所以可以直接将一个值写在`export default`之后。 ```javascript // 正确 @@ -427,7 +453,7 @@ export default 42; export 42; ``` -上面代码中,后一句报错是因为没有指定对外的接口,而前一句指定外对接口为`default`。 +上面代码中,后一句报错是因为没有指定对外的接口,而前一句指定对外接口为`default`。 有了`export default`命令,输入模块时就非常直观了,以输入 lodash 模块为例。 @@ -435,10 +461,10 @@ export 42; import _ from 'lodash'; ``` -如果想在一条`import`语句中,同时输入默认方法和其他变量,可以写成下面这样。 +如果想在一条`import`语句中,同时输入默认方法和其他接口,可以写成下面这样。 ```javascript -import _, { each } from 'lodash'; +import _, { each, forEach } from 'lodash'; ``` 对应上面代码的`export`语句如下。 @@ -475,12 +501,12 @@ let o = new MyClass(); ```javascript export { foo, bar } from 'my_module'; -// 等同于 +// 可以简单理解为 import { foo, bar } from 'my_module'; export { foo, bar }; ``` -上面代码中,`export`和`import`语句可以结合在一起,写成一行。 +上面代码中,`export`和`import`语句可以结合在一起,写成一行。但需要注意的是,写成一行以后,`foo`和`bar`实际上并没有被导入当前模块,只是相当于对外转发了这两个接口,导致当前模块不能直接使用`foo`和`bar`。 模块的接口改名和整体输出,也可以采用这种写法。 @@ -617,14 +643,14 @@ export {users} from './users'; ```javascript // script.js -import {db, users} from './constants'; +import {db, users} from './constants/index'; ``` ## import() ### 简介 -前面介绍过,`import`命令会被 JavaScript 引擎静态分析,先于模块内的其他模块执行(叫做”连接“更合适)。所以,下面的代码会报错。 +前面介绍过,`import`命令会被 JavaScript 引擎静态分析,先于模块内的其他语句执行(`import`命令叫做“连接” binding 其实更合适)。所以,下面的代码会报错。 ```javascript // 报错 @@ -635,14 +661,14 @@ if (x === 2) { 上面代码中,引擎处理`import`语句是在编译时,这时不会去分析或执行`if`语句,所以`import`语句放在`if`代码块之中毫无意义,因此会报句法错误,而不是执行时错误。也就是说,`import`和`export`命令只能在模块的顶层,不能在代码块之中(比如,在`if`代码块之中,或在函数之中)。 -这样的设计,固然有利于编译器提高效率,但也导致无法在运行时加载模块。从语法上,条件加载就不可能实现。如果`import`命令要取代 Node 的`require`方法,这就形成了一个障碍。因为`require`是运行时加载模块,`import`命令无法取代`require`的动态加载功能。 +这样的设计,固然有利于编译器提高效率,但也导致无法在运行时加载模块。在语法上,条件加载就不可能实现。如果`import`命令要取代 Node 的`require`方法,这就形成了一个障碍。因为`require`是运行时加载模块,`import`命令无法取代`require`的动态加载功能。 ```javascript const path = './' + fileName; const myModual = require(path); ``` -上面的语句就是动态加载,`require`到底加载哪一个模块,只有运行时才知道。`import`语句做不到这一点。 +上面的语句就是动态加载,`require`到底加载哪一个模块,只有运行时才知道。`import`命令做不到这一点。 因此,有一个[提案](https://github.com/tc39/proposal-dynamic-import),建议引入`import()`函数,完成动态加载。 @@ -666,9 +692,7 @@ import(`./section-modules/${someVariable}.js`) }); ``` -`import()`函数可以用在任何地方,不仅仅是模块,非模块的脚本也可以使用。它是运行时执行,也就是说,什么时候运行到这一句,也会加载指定的模块。另外,`import()`函数与所加载的模块没有静态连接关系,这点也是与`import`语句不相同。 - -`import()`类似于 Node 的`require`方法,区别主要是前者是异步加载,后者是同步加载。 +`import()`函数可以用在任何地方,不仅仅是模块,非模块的脚本也可以使用。它是运行时执行,也就是说,什么时候运行到这一句,就会加载指定的模块。另外,`import()`函数与所加载的模块没有静态连接关系,这点也是与`import`语句不相同。`import()`类似于 Node 的`require`方法,区别主要是前者是异步加载,后者是同步加载。 ### 适用场合 @@ -776,4 +800,3 @@ async function main() { } main(); ``` - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/number.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/number.md" old mode 100644 new mode 100755 similarity index 57% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/number.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/number.md" index ea152a1b6..27e384d51 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/number.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/number.md" @@ -33,9 +33,9 @@ Number('0o10') // 8 ## Number.isFinite(), Number.isNaN() -ES6在Number对象上,新提供了`Number.isFinite()`和`Number.isNaN()`两个方法。 +ES6 在`Number`对象上,新提供了`Number.isFinite()`和`Number.isNaN()`两个方法。 -`Number.isFinite()`用来检查一个数值是否为有限的(finite)。 +`Number.isFinite()`用来检查一个数值是否为有限的(finite),即不是`Infinity`。 ```javascript Number.isFinite(15); // true @@ -48,22 +48,7 @@ Number.isFinite('15'); // false Number.isFinite(true); // false ``` -ES5可以通过下面的代码,部署`Number.isFinite`方法。 - -```javascript -(function (global) { - var global_isFinite = global.isFinite; - - Object.defineProperty(Number, 'isFinite', { - value: function isFinite(value) { - return typeof value === 'number' && global_isFinite(value); - }, - configurable: true, - enumerable: false, - writable: true - }); -})(this); -``` +注意,如果参数类型不是数值,`Number.isFinite`一律返回`false`。 `Number.isNaN()`用来检查一个值是否为`NaN`。 @@ -73,28 +58,13 @@ Number.isNaN(15) // false Number.isNaN('15') // false Number.isNaN(true) // false Number.isNaN(9/NaN) // true -Number.isNaN('true'/0) // true -Number.isNaN('true'/'true') // true +Number.isNaN('true' / 0) // true +Number.isNaN('true' / 'true') // true ``` -ES5通过下面的代码,部署`Number.isNaN()`。 - -```javascript -(function (global) { - var global_isNaN = global.isNaN; - - Object.defineProperty(Number, 'isNaN', { - value: function isNaN(value) { - return typeof value === 'number' && global_isNaN(value); - }, - configurable: true, - enumerable: false, - writable: true - }); -})(this); -``` +如果参数类型不是`NaN`,`Number.isNaN`一律返回`false`。 -它们与传统的全局方法`isFinite()`和`isNaN()`的区别在于,传统方法先调用`Number()`将非数值的值转为数值,再进行判断,而这两个新方法只对数值有效,非数值一律返回`false`。 +它们与传统的全局方法`isFinite()`和`isNaN()`的区别在于,传统方法先调用`Number()`将非数值的值转为数值,再进行判断,而这两个新方法只对数值有效,`Number.isFinite()`对于非数值一律返回`false`, `Number.isNaN()`只有对于`NaN`才返回`true`,非`NaN`一律返回`false`。 ```javascript isFinite(25) // true @@ -106,11 +76,12 @@ isNaN(NaN) // true isNaN("NaN") // true Number.isNaN(NaN) // true Number.isNaN("NaN") // false +Number.isNaN(1) // false ``` ## Number.parseInt(), Number.parseFloat() -ES6将全局方法`parseInt()`和`parseFloat()`,移植到Number对象上面,行为完全保持不变。 +ES6 将全局方法`parseInt()`和`parseFloat()`,移植到`Number`对象上面,行为完全保持不变。 ```javascript // ES5的写法 @@ -131,47 +102,65 @@ Number.parseFloat === parseFloat // true ## Number.isInteger() -`Number.isInteger()`用来判断一个值是否为整数。需要注意的是,在JavaScript内部,整数和浮点数是同样的储存方法,所以3和3.0被视为同一个值。 +`Number.isInteger()`用来判断一个数值是否为整数。 ```javascript Number.isInteger(25) // true -Number.isInteger(25.0) // true Number.isInteger(25.1) // false -Number.isInteger("15") // false +``` + +JavaScript 内部,整数和浮点数采用的是同样的储存方法,所以 25 和 25.0 被视为同一个值。 + +```javascript +Number.isInteger(25) // true +Number.isInteger(25.0) // true +``` + +如果参数不是数值,`Number.isInteger`返回`false`。 + +```javascript +Number.isInteger() // false +Number.isInteger(null) // false +Number.isInteger('15') // false Number.isInteger(true) // false ``` -ES5可以通过下面的代码,部署`Number.isInteger()`。 +注意,由于 JavaScript 采用 IEEE 754 标准,数值存储为64位双精度格式,数值精度最多可以达到 53 个二进制位(1 个隐藏位与 52 个有效位)。如果数值的精度超过这个限度,第54位及后面的位就会被丢弃,这种情况下,`Number.isInteger`可能会误判。 ```javascript -(function (global) { - var floor = Math.floor, - isFinite = global.isFinite; +Number.isInteger(3.0000000000000002) // true +``` + +上面代码中,`Number.isInteger`的参数明明不是整数,但是会返回`true`。原因就是这个小数的精度达到了小数点后16个十进制位,转成二进制位超过了53个二进制位,导致最后的那个`2`被丢弃了。 + +类似的情况还有,如果一个数值的绝对值小于`Number.MIN_VALUE`(5E-324),即小于 JavaScript 能够分辨的最小值,会被自动转为 0。这时,`Number.isInteger`也会误判。 - Object.defineProperty(Number, 'isInteger', { - value: function isInteger(value) { - return typeof value === 'number' && isFinite(value) && - value > -9007199254740992 && value < 9007199254740992 && - floor(value) === value; - }, - configurable: true, - enumerable: false, - writable: true - }); -})(this); +```javascript +Number.isInteger(5E-324) // false +Number.isInteger(5E-325) // true ``` +上面代码中,`5E-325`由于值太小,会被自动转为0,因此返回`true`。 + +总之,如果对数据精度的要求较高,不建议使用`Number.isInteger()`判断一个数值是否为整数。 + ## Number.EPSILON -ES6在Number对象上面,新增一个极小的常量`Number.EPSILON`。 +ES6 在`Number`对象上面,新增一个极小的常量`Number.EPSILON`。根据规格,它表示 1 与大于 1 的最小浮点数之间的差。 + +对于 64 位浮点数来说,大于 1 的最小浮点数相当于二进制的`1.00..001`,小数点后面有连续 51 个零。这个值减去 1 之后,就等于 2 的 -52 次方。 ```javascript +Number.EPSILON === Math.pow(2, -52) +// true Number.EPSILON // 2.220446049250313e-16 Number.EPSILON.toFixed(20) -// '0.00000000000000022204' +// "0.00000000000000022204" ``` +`Number.EPSILON`实际上是 JavaScript 能够表示的最小精度。误差如果小于这个值,就可以认为已经没有意义了,即不存在误差了。 + 引入一个这么小的量的目的,在于为浮点数计算,设置一个误差范围。我们知道浮点数计算是不精确的。 ```javascript @@ -185,30 +174,38 @@ Number.EPSILON.toFixed(20) // '0.00000000000000005551' ``` -但是如果这个误差能够小于`Number.EPSILON`,我们就可以认为得到了正确结果。 +上面代码解释了,为什么比较`0.1 + 0.2`与`0.3`得到的结果是`false`。 ```javascript -5.551115123125783e-17 < Number.EPSILON +0.1 + 0.2 === 0.3 // false +``` + +`Number.EPSILON`可以用来设置“能够接受的误差范围”。比如,误差范围设为 2 的-50 次方(即`Number.EPSILON * Math.pow(2, 2)`),即如果两个浮点数的差小于这个值,我们就认为这两个浮点数相等。 + +```javascript +5.551115123125783e-17 < Number.EPSILON * Math.pow(2, 2) // true ``` -因此,`Number.EPSILON`的实质是一个可以接受的误差范围。 +因此,`Number.EPSILON`的实质是一个可以接受的最小误差范围。 ```javascript function withinErrorMargin (left, right) { - return Math.abs(left - right) < Number.EPSILON; + return Math.abs(left - right) < Number.EPSILON * Math.pow(2, 2); } -withinErrorMargin(0.1 + 0.2, 0.3) -// true -withinErrorMargin(0.2 + 0.2, 0.3) -// false + +0.1 + 0.2 === 0.3 // false +withinErrorMargin(0.1 + 0.2, 0.3) // true + +1.1 + 1.3 === 2.4 // false +withinErrorMargin(1.1 + 1.3, 2.4) // true ``` 上面的代码为浮点数运算,部署了一个误差检查函数。 -## 安全整数和Number.isSafeInteger() +## 安全整数和 Number.isSafeInteger() -JavaScript能够准确表示的整数范围在`-2^53`到`2^53`之间(不含两个端点),超过这个范围,无法精确表示这个值。 +JavaScript 能够准确表示的整数范围在`-2^53`到`2^53`之间(不含两个端点),超过这个范围,无法精确表示这个值。 ```javascript Math.pow(2, 53) // 9007199254740992 @@ -220,9 +217,9 @@ Math.pow(2, 53) === Math.pow(2, 53) + 1 // true ``` -上面代码中,超出2的53次方之后,一个数就不精确了。 +上面代码中,超出 2 的 53 次方之后,一个数就不精确了。 -ES6引入了`Number.MAX_SAFE_INTEGER`和`Number.MIN_SAFE_INTEGER`这两个常量,用来表示这个范围的上下限。 +ES6 引入了`Number.MAX_SAFE_INTEGER`和`Number.MIN_SAFE_INTEGER`这两个常量,用来表示这个范围的上下限。 ```javascript Number.MAX_SAFE_INTEGER === Math.pow(2, 53) - 1 @@ -236,7 +233,7 @@ Number.MIN_SAFE_INTEGER === -9007199254740991 // true ``` -上面代码中,可以看到JavaScript能够精确表示的极限。 +上面代码中,可以看到 JavaScript 能够精确表示的极限。 `Number.isSafeInteger()`则是用来判断一个整数是否落在这个范围之内。 @@ -311,9 +308,9 @@ trusty(1, 2, 3) // 3 ``` -## Math对象的扩展 +## Math 对象的扩展 -ES6在Math对象上新增了17个与数学相关的方法。所有这些方法都是静态方法,只能在Math对象上调用。 +ES6 在 Math 对象上新增了 17 个与数学相关的方法。所有这些方法都是静态方法,只能在 Math 对象上调用。 ### Math.trunc() @@ -330,16 +327,19 @@ Math.trunc(-0.1234) // -0 对于非数值,`Math.trunc`内部使用`Number`方法将其先转为数值。 ```javascript -Math.trunc('123.456') -// 123 +Math.trunc('123.456') // 123 +Math.trunc(true) //1 +Math.trunc(false) // 0 +Math.trunc(null) // 0 ``` -对于空值和无法截取整数的值,返回NaN。 +对于空值和无法截取整数的值,返回`NaN`。 ```javascript Math.trunc(NaN); // NaN Math.trunc('foo'); // NaN Math.trunc(); // NaN +Math.trunc(undefined) // NaN ``` 对于没有部署这个方法的环境,可以用下面的代码模拟。 @@ -352,15 +352,15 @@ Math.trunc = Math.trunc || function(x) { ### Math.sign() -`Math.sign`方法用来判断一个数到底是正数、负数、还是零。 +`Math.sign`方法用来判断一个数到底是正数、负数、还是零。对于非数值,会先将其转换为数值。 它会返回五种值。 -- 参数为正数,返回+1; -- 参数为负数,返回-1; -- 参数为0,返回0; -- 参数为-0,返回-0; -- 其他值,返回NaN。 +- 参数为正数,返回`+1`; +- 参数为负数,返回`-1`; +- 参数为 0,返回`0`; +- 参数为-0,返回`-0`; +- 其他值,返回`NaN`。 ```javascript Math.sign(-5) // -1 @@ -368,8 +368,19 @@ Math.sign(5) // +1 Math.sign(0) // +0 Math.sign(-0) // -0 Math.sign(NaN) // NaN -Math.sign('foo'); // NaN -Math.sign(); // NaN +``` + +如果参数是非数值,会自动转为数值。对于那些无法转为数值的值,会返回`NaN`。 + +```javascript +Math.sign('') // 0 +Math.sign(true) // +1 +Math.sign(false) // 0 +Math.sign(null) // 0 +Math.sign('9') // +1 +Math.sign('foo') // NaN +Math.sign() // NaN +Math.sign(undefined) // NaN ``` 对于没有部署这个方法的环境,可以用下面的代码模拟。 @@ -413,7 +424,7 @@ Math.cbrt = Math.cbrt || function(x) { ### Math.clz32() -JavaScript的整数使用32位二进制形式表示,`Math.clz32`方法返回一个数的32位无符号整数形式有多少个前导0。 +`Math.clz32()`方法将参数转为 32 位无符号整数的形式,然后这个 32 位值里面有多少个前导 0。 ```javascript Math.clz32(0) // 32 @@ -423,9 +434,9 @@ Math.clz32(0b01000000000000000000000000000000) // 1 Math.clz32(0b00100000000000000000000000000000) // 2 ``` -上面代码中,0的二进制形式全为0,所以有32个前导0;1的二进制形式是`0b1`,只占1位,所以32位之中有31个前导0;1000的二进制形式是`0b1111101000`,一共有10位,所以32位之中有22个前导0。 +上面代码中,0 的二进制形式全为 0,所以有 32 个前导 0;1 的二进制形式是`0b1`,只占 1 位,所以 32 位之中有 31 个前导 0;1000 的二进制形式是`0b1111101000`,一共有 10 位,所以 32 位之中有 22 个前导 0。 -`clz32`这个函数名就来自”count leading zero bits in 32-bit binary representations of a number“(计算32位整数的前导0)的缩写。 +`clz32`这个函数名就来自”count leading zero bits in 32-bit binary representation of a number“(计算一个数的 32 位二进制形式的前导 0 的个数)的缩写。 左移运算符(`<<`)与`Math.clz32`方法直接相关。 @@ -459,7 +470,7 @@ Math.clz32(true) // 31 ### Math.imul() -`Math.imul`方法返回两个数以32位带符号整数形式相乘的结果,返回的也是一个32位的带符号整数。 +`Math.imul`方法返回两个数以 32 位带符号整数形式相乘的结果,返回的也是一个 32 位的带符号整数。 ```javascript Math.imul(2, 4) // 8 @@ -467,13 +478,13 @@ Math.imul(-1, 8) // -8 Math.imul(-2, -2) // 4 ``` -如果只考虑最后32位,大多数情况下,`Math.imul(a, b)`与`a * b`的结果是相同的,即该方法等同于`(a * b)|0`的效果(超过32位的部分溢出)。之所以需要部署这个方法,是因为JavaScript有精度限制,超过2的53次方的值无法精确表示。这就是说,对于那些很大的数的乘法,低位数值往往都是不精确的,`Math.imul`方法可以返回正确的低位数值。 +如果只考虑最后 32 位,大多数情况下,`Math.imul(a, b)`与`a * b`的结果是相同的,即该方法等同于`(a * b)|0`的效果(超过 32 位的部分溢出)。之所以需要部署这个方法,是因为 JavaScript 有精度限制,超过 2 的 53 次方的值无法精确表示。这就是说,对于那些很大的数的乘法,低位数值往往都是不精确的,`Math.imul`方法可以返回正确的低位数值。 ```javascript (0x7fffffff * 0x7fffffff)|0 // 0 ``` -上面这个乘法算式,返回结果为0。但是由于这两个二进制数的最低位都是1,所以这个结果肯定是不正确的,因为根据二进制乘法,计算结果的二进制最低位应该也是1。这个错误就是因为它们的乘积超过了2的53次方,JavaScript无法保存额外的精度,就把低位的值都变成了0。`Math.imul`方法可以返回正确的值1。 +上面这个乘法算式,返回结果为 0。但是由于这两个二进制数的最低位都是 1,所以这个结果肯定是不正确的,因为根据二进制乘法,计算结果的二进制最低位应该也是 1。这个错误就是因为它们的乘积超过了 2 的 53 次方,JavaScript 无法保存额外的精度,就把低位的值都变成了 0。`Math.imul`方法可以返回正确的值 1。 ```javascript Math.imul(0x7fffffff, 0x7fffffff) // 1 @@ -481,22 +492,53 @@ Math.imul(0x7fffffff, 0x7fffffff) // 1 ### Math.fround() -Math.fround方法返回一个数的单精度浮点数形式。 +`Math.fround`方法返回一个数的32位单精度浮点数形式。 + +对于32位单精度格式来说,数值精度是24个二进制位(1 位隐藏位与 23 位有效位),所以对于 -224 至 224 之间的整数(不含两个端点),返回结果与参数本身一致。 + +```javascript +Math.fround(0) // 0 +Math.fround(1)   // 1 +Math.fround(2 ** 24 - 1) // 16777215 +``` + +如果参数的绝对值大于 224,返回的结果便开始丢失精度。 ```javascript -Math.fround(0) // 0 -Math.fround(1) // 1 -Math.fround(1.337) // 1.3370000123977661 -Math.fround(1.5) // 1.5 -Math.fround(NaN) // NaN +Math.fround(2 ** 24) // 16777216 +Math.fround(2 ** 24 + 1) // 16777216 ``` -对于整数来说,`Math.fround`方法返回结果不会有任何不同,区别主要是那些无法用64个二进制位精确表示的小数。这时,`Math.fround`方法会返回最接近这个小数的单精度浮点数。 +`Math.fround`方法的主要作用,是将64位双精度浮点数转为32位单精度浮点数。如果小数的精度超过24个二进制位,返回值就会不同于原值,否则返回值不变(即与64位双精度值一致)。 + +```javascript +// 未丢失有效精度 +Math.fround(1.125) // 1.125 +Math.fround(7.25) // 7.25 + +// 丢失精度 +Math.fround(0.3)   // 0.30000001192092896 +Math.fround(0.7)   // 0.699999988079071 +Math.fround(1.0000000123) // 1 +``` + +对于 `NaN` 和 `Infinity`,此方法返回原值。对于其它类型的非数值,`Math.fround` 方法会先将其转为数值,再返回单精度浮点数。 + +```javascript +Math.fround(NaN) // NaN +Math.fround(Infinity) // Infinity + +Math.fround('5') // 5 +Math.fround(true) // 1 +Math.fround(null) // 0 +Math.fround([]) // 0 +Math.fround({}) // NaN +``` 对于没有部署这个方法的环境,可以用下面的代码模拟。 ```javascript -Math.fround = Math.fround || function(x) { +Math.fround = Math.fround || function (x) { return new Float32Array([x])[0]; }; ``` @@ -515,17 +557,17 @@ Math.hypot(3, 4, '5'); // 7.0710678118654755 Math.hypot(-3); // 3 ``` -上面代码中,3的平方加上4的平方,等于5的平方。 +上面代码中,3 的平方加上 4 的平方,等于 5 的平方。 -如果参数不是数值,`Math.hypot`方法会将其转为数值。只要有一个参数无法转为数值,就会返回NaN。 +如果参数不是数值,`Math.hypot`方法会将其转为数值。只要有一个参数无法转为数值,就会返回 NaN。 ### 对数方法 -ES6新增了4个对数相关方法。 +ES6 新增了 4 个对数相关方法。 **(1) Math.expm1()** -`Math.expm1(x)`返回ex - 1,即`Math.exp(x) - 1`。 +`Math.expm1(x)`返回 ex - 1,即`Math.exp(x) - 1`。 ```javascript Math.expm1(-1) // -0.6321205588285577 @@ -562,7 +604,7 @@ Math.log1p = Math.log1p || function(x) { **(3)Math.log10()** -`Math.log10(x)`返回以10为底的`x`的对数。如果`x`小于0,则返回NaN。 +`Math.log10(x)`返回以 10 为底的`x`的对数。如果`x`小于 0,则返回 NaN。 ```javascript Math.log10(2) // 0.3010299956639812 @@ -582,7 +624,7 @@ Math.log10 = Math.log10 || function(x) { **(4)Math.log2()** -`Math.log2(x)`返回以2为底的`x`的对数。如果`x`小于0,则返回NaN。 +`Math.log2(x)`返回以 2 为底的`x`的对数。如果`x`小于 0,则返回 NaN。 ```javascript Math.log2(3) // 1.584962500721156 @@ -602,9 +644,9 @@ Math.log2 = Math.log2 || function(x) { }; ``` -### 三角函数方法 +### 双曲函数方法 -ES6新增了6个三角函数方法。 +ES6 新增了 6 个双曲函数方法。 - `Math.sinh(x)` 返回`x`的双曲正弦(hyperbolic sine) - `Math.cosh(x)` 返回`x`的双曲余弦(hyperbolic cosine) @@ -613,60 +655,38 @@ ES6新增了6个三角函数方法。 - `Math.acosh(x)` 返回`x`的反双曲余弦(inverse hyperbolic cosine) - `Math.atanh(x)` 返回`x`的反双曲正切(inverse hyperbolic tangent) -## Math.signbit() - -`Math.sign()`用来判断一个值的正负,但是如果参数是`-0`,它会返回`-0`。 - -```javascript -Math.sign(-0) // -0 -``` +## 指数运算符 -这导致对于判断符号位的正负,`Math.sign()`不是很有用。JavaScript 内部使用64位浮点数(国际标准IEEE 754)表示数值,IEEE 754规定第一位是符号位,`0`表示正数,`1`表示负数。所以会有两种零,`+0`是符号位为`0`时的零值,`-0`是符号位为`1`时的零值。实际编程中,判断一个值是`+0`还是`-0`非常麻烦,因为它们是相等的。 +ES2016 新增了一个指数运算符(`**`)。 ```javascript -+0 === -0 // true +2 ** 2 // 4 +2 ** 3 // 8 ``` -目前,有一个[提案](http://jfbastien.github.io/papers/Math.signbit.html),引入了`Math.signbit()`方法判断一个数的符号位是否设置了。 +这个运算符的一个特点是右结合,而不是常见的左结合。多个指数运算符连用时,是从最右边开始计算的。 ```javascript -Math.signbit(2) //false -Math.signbit(-2) //true -Math.signbit(0) //false -Math.signbit(-0) //true +// 相当于 2 ** (3 ** 2) +2 ** 3 ** 2 +// 512 ``` -可以看到,该方法正确返回了`-0`的符号位是设置了的。 - -该方法的算法如下。 - -- 如果参数是`NaN`,返回`false` -- 如果参数是`-0`,返回`true` -- 如果参数是负值,返回`true` -- 其他情况返回`false` - -## 指数运算符 - -ES2016 新增了一个指数运算符(`**`)。 - -```javascript -2 ** 2 // 4 -2 ** 3 // 8 -``` +上面代码中,首先计算的是第二个指数运算符,而不是第一个。 指数运算符可以与等号结合,形成一个新的赋值运算符(`**=`)。 ```javascript -let a = 2; +let a = 1.5; a **= 2; // 等同于 a = a * a; -let b = 3; +let b = 4; b **= 3; // 等同于 b = b * b * b; ``` -注意,在 V8 引擎中,指数运算符与`Math.pow`的实现不相同,对于特别大的运算结果,两者会有细微的差异。 +注意,V8 引擎的指数运算符与`Math.pow`的实现不相同,对于特别大的运算结果,两者会有细微的差异。 ```javascript Math.pow(99, 99) @@ -677,4 +697,3 @@ Math.pow(99, 99) ``` 上面代码中,两个运算结果的最后一位有效数字是有差异的。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/object-methods.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/object-methods.md" new file mode 100755 index 000000000..d6f133ab4 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/object-methods.md" @@ -0,0 +1,833 @@ +# 对象的新增方法 + +## Object.is() + +ES5 比较两个值是否相等,只有两个运算符:相等运算符(`==`)和严格相等运算符(`===`)。它们都有缺点,前者会自动转换数据类型,后者的`NaN`不等于自身,以及`+0`等于`-0`。JavaScript 缺乏一种运算,在所有环境中,只要两个值是一样的,它们就应该相等。 + +ES6 提出“Same-value equality”(同值相等)算法,用来解决这个问题。`Object.is`就是部署这个算法的新方法。它用来比较两个值是否严格相等,与严格比较运算符(===)的行为基本一致。 + +```javascript +Object.is('foo', 'foo') +// true +Object.is({}, {}) +// false +``` + +不同之处只有两个:一是`+0`不等于`-0`,二是`NaN`等于自身。 + +```javascript ++0 === -0 //true +NaN === NaN // false + +Object.is(+0, -0) // false +Object.is(NaN, NaN) // true +``` + +ES5 可以通过下面的代码,部署`Object.is`。 + +```javascript +Object.defineProperty(Object, 'is', { + value: function(x, y) { + if (x === y) { + // 针对+0 不等于 -0的情况 + return x !== 0 || 1 / x === 1 / y; + } + // 针对NaN的情况 + return x !== x && y !== y; + }, + configurable: true, + enumerable: false, + writable: true +}); +``` + +## Object.assign() + +### 基本用法 + +`Object.assign`方法用于对象的合并,将源对象(source)的所有可枚举属性,复制到目标对象(target)。 + +```javascript +const target = { a: 1 }; + +const source1 = { b: 2 }; +const source2 = { c: 3 }; + +Object.assign(target, source1, source2); +target // {a:1, b:2, c:3} +``` + +`Object.assign`方法的第一个参数是目标对象,后面的参数都是源对象。 + +注意,如果目标对象与源对象有同名属性,或多个源对象有同名属性,则后面的属性会覆盖前面的属性。 + +```javascript +const target = { a: 1, b: 1 }; + +const source1 = { b: 2, c: 2 }; +const source2 = { c: 3 }; + +Object.assign(target, source1, source2); +target // {a:1, b:2, c:3} +``` + +如果只有一个参数,`Object.assign`会直接返回该参数。 + +```javascript +const obj = {a: 1}; +Object.assign(obj) === obj // true +``` + +如果该参数不是对象,则会先转成对象,然后返回。 + +```javascript +typeof Object.assign(2) // "object" +``` + +由于`undefined`和`null`无法转成对象,所以如果它们作为参数,就会报错。 + +```javascript +Object.assign(undefined) // 报错 +Object.assign(null) // 报错 +``` + +如果非对象参数出现在源对象的位置(即非首参数),那么处理规则有所不同。首先,这些参数都会转成对象,如果无法转成对象,就会跳过。这意味着,如果`undefined`和`null`不在首参数,就不会报错。 + +```javascript +let obj = {a: 1}; +Object.assign(obj, undefined) === obj // true +Object.assign(obj, null) === obj // true +``` + +其他类型的值(即数值、字符串和布尔值)不在首参数,也不会报错。但是,除了字符串会以数组形式,拷贝入目标对象,其他值都不会产生效果。 + +```javascript +const v1 = 'abc'; +const v2 = true; +const v3 = 10; + +const obj = Object.assign({}, v1, v2, v3); +console.log(obj); // { "0": "a", "1": "b", "2": "c" } +``` + +上面代码中,`v1`、`v2`、`v3`分别是字符串、布尔值和数值,结果只有字符串合入目标对象(以字符数组的形式),数值和布尔值都会被忽略。这是因为只有字符串的包装对象,会产生可枚举属性。 + +```javascript +Object(true) // {[[PrimitiveValue]]: true} +Object(10) // {[[PrimitiveValue]]: 10} +Object('abc') // {0: "a", 1: "b", 2: "c", length: 3, [[PrimitiveValue]]: "abc"} +``` + +上面代码中,布尔值、数值、字符串分别转成对应的包装对象,可以看到它们的原始值都在包装对象的内部属性`[[PrimitiveValue]]`上面,这个属性是不会被`Object.assign`拷贝的。只有字符串的包装对象,会产生可枚举的实义属性,那些属性则会被拷贝。 + +`Object.assign`拷贝的属性是有限制的,只拷贝源对象的自身属性(不拷贝继承属性),也不拷贝不可枚举的属性(`enumerable: false`)。 + +```javascript +Object.assign({b: 'c'}, + Object.defineProperty({}, 'invisible', { + enumerable: false, + value: 'hello' + }) +) +// { b: 'c' } +``` + +上面代码中,`Object.assign`要拷贝的对象只有一个不可枚举属性`invisible`,这个属性并没有被拷贝进去。 + +属性名为 Symbol 值的属性,也会被`Object.assign`拷贝。 + +```javascript +Object.assign({ a: 'b' }, { [Symbol('c')]: 'd' }) +// { a: 'b', Symbol(c): 'd' } +``` + +### 注意点 + +**(1)浅拷贝** + +`Object.assign`方法实行的是浅拷贝,而不是深拷贝。也就是说,如果源对象某个属性的值是对象,那么目标对象拷贝得到的是这个对象的引用。 + +```javascript +const obj1 = {a: {b: 1}}; +const obj2 = Object.assign({}, obj1); + +obj1.a.b = 2; +obj2.a.b // 2 +``` + +上面代码中,源对象`obj1`的`a`属性的值是一个对象,`Object.assign`拷贝得到的是这个对象的引用。这个对象的任何变化,都会反映到目标对象上面。 + +**(2)同名属性的替换** + +对于这种嵌套的对象,一旦遇到同名属性,`Object.assign`的处理方法是替换,而不是添加。 + +```javascript +const target = { a: { b: 'c', d: 'e' } } +const source = { a: { b: 'hello' } } +Object.assign(target, source) +// { a: { b: 'hello' } } +``` + +上面代码中,`target`对象的`a`属性被`source`对象的`a`属性整个替换掉了,而不会得到`{ a: { b: 'hello', d: 'e' } }`的结果。这通常不是开发者想要的,需要特别小心。 + +一些函数库提供`Object.assign`的定制版本(比如 Lodash 的`_.defaultsDeep`方法),可以得到深拷贝的合并。 + +**(3)数组的处理** + +`Object.assign`可以用来处理数组,但是会把数组视为对象。 + +```javascript +Object.assign([1, 2, 3], [4, 5]) +// [4, 5, 3] +``` + +上面代码中,`Object.assign`把数组视为属性名为 0、1、2 的对象,因此源数组的 0 号属性`4`覆盖了目标数组的 0 号属性`1`。 + +**(4)取值函数的处理** + +`Object.assign`只能进行值的复制,如果要复制的值是一个取值函数,那么将求值后再复制。 + +```javascript +const source = { + get foo() { return 1 } +}; +const target = {}; + +Object.assign(target, source) +// { foo: 1 } +``` + +上面代码中,`source`对象的`foo`属性是一个取值函数,`Object.assign`不会复制这个取值函数,只会拿到值以后,将这个值复制过去。 + +### 常见用途 + +`Object.assign`方法有很多用处。 + +**(1)为对象添加属性** + +```javascript +class Point { + constructor(x, y) { + Object.assign(this, {x, y}); + } +} +``` + +上面方法通过`Object.assign`方法,将`x`属性和`y`属性添加到`Point`类的对象实例。 + +**(2)为对象添加方法** + +```javascript +Object.assign(SomeClass.prototype, { + someMethod(arg1, arg2) { + ··· + }, + anotherMethod() { + ··· + } +}); + +// 等同于下面的写法 +SomeClass.prototype.someMethod = function (arg1, arg2) { + ··· +}; +SomeClass.prototype.anotherMethod = function () { + ··· +}; +``` + +上面代码使用了对象属性的简洁表示法,直接将两个函数放在大括号中,再使用`assign`方法添加到`SomeClass.prototype`之中。 + +**(3)克隆对象** + +```javascript +function clone(origin) { + return Object.assign({}, origin); +} +``` + +上面代码将原始对象拷贝到一个空对象,就得到了原始对象的克隆。 + +不过,采用这种方法克隆,只能克隆原始对象自身的值,不能克隆它继承的值。如果想要保持继承链,可以采用下面的代码。 + +```javascript +function clone(origin) { + let originProto = Object.getPrototypeOf(origin); + return Object.assign(Object.create(originProto), origin); +} +``` + +**(4)合并多个对象** + +将多个对象合并到某个对象。 + +```javascript +const merge = + (target, ...sources) => Object.assign(target, ...sources); +``` + +如果希望合并后返回一个新对象,可以改写上面函数,对一个空对象合并。 + +```javascript +const merge = + (...sources) => Object.assign({}, ...sources); +``` + +**(5)为属性指定默认值** + +```javascript +const DEFAULTS = { + logLevel: 0, + outputFormat: 'html' +}; + +function processContent(options) { + options = Object.assign({}, DEFAULTS, options); + console.log(options); + // ... +} +``` + +上面代码中,`DEFAULTS`对象是默认值,`options`对象是用户提供的参数。`Object.assign`方法将`DEFAULTS`和`options`合并成一个新对象,如果两者有同名属性,则`option`的属性值会覆盖`DEFAULTS`的属性值。 + +注意,由于存在浅拷贝的问题,`DEFAULTS`对象和`options`对象的所有属性的值,最好都是简单类型,不要指向另一个对象。否则,`DEFAULTS`对象的该属性很可能不起作用。 + +```javascript +const DEFAULTS = { + url: { + host: 'example.com', + port: 7070 + }, +}; + +processContent({ url: {port: 8000} }) +// { +// url: {port: 8000} +// } +``` + +上面代码的原意是将`url.port`改成 8000,`url.host`不变。实际结果却是`options.url`覆盖掉`DEFAULTS.url`,所以`url.host`就不存在了。 + +## Object.getOwnPropertyDescriptors() + +ES5 的`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: get 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: set 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() + +JavaScript 语言的对象继承是通过原型链实现的。ES6 提供了更多原型对象的操作方法。 + +### `__proto__`属性 + +`__proto__`属性(前后各两个下划线),用来读取或设置当前对象的`prototype`对象。目前,所有浏览器(包括 IE11)都部署了这个属性。 + +```javascript +// es5 的写法 +const obj = { + method: function() { ... } +}; +obj.__proto__ = someOtherObj; + +// es6 的写法 +var obj = Object.create(someOtherObj); +obj.method = function() { ... }; +``` + +该属性没有写入 ES6 的正文,而是写入了附录,原因是`__proto__`前后的双下划线,说明它本质上是一个内部属性,而不是一个正式的对外的 API,只是由于浏览器广泛支持,才被加入了 ES6。标准明确规定,只有浏览器必须部署这个属性,其他运行环境不一定需要部署,而且新的代码最好认为这个属性是不存在的。因此,无论从语义的角度,还是从兼容性的角度,都不要使用这个属性,而是使用下面的`Object.setPrototypeOf()`(写操作)、`Object.getPrototypeOf()`(读操作)、`Object.create()`(生成操作)代替。 + +实现上,`__proto__`调用的是`Object.prototype.__proto__`,具体实现如下。 + +```javascript +Object.defineProperty(Object.prototype, '__proto__', { + get() { + let _thisObj = Object(this); + return Object.getPrototypeOf(_thisObj); + }, + set(proto) { + if (this === undefined || this === null) { + throw new TypeError(); + } + if (!isObject(this)) { + return undefined; + } + if (!isObject(proto)) { + return undefined; + } + let status = Reflect.setPrototypeOf(this, proto); + if (!status) { + throw new TypeError(); + } + }, +}); + +function isObject(value) { + return Object(value) === value; +} +``` + +如果一个对象本身部署了`__proto__`属性,该属性的值就是对象的原型。 + +```javascript +Object.getPrototypeOf({ __proto__: null }) +// null +``` + +### Object.setPrototypeOf() + +`Object.setPrototypeOf`方法的作用与`__proto__`相同,用来设置一个对象的`prototype`对象,返回参数对象本身。它是 ES6 正式推荐的设置原型对象的方法。 + +```javascript +// 格式 +Object.setPrototypeOf(object, prototype) + +// 用法 +const o = Object.setPrototypeOf({}, null); +``` + +该方法等同于下面的函数。 + +```javascript +function setPrototypeOf(obj, proto) { + obj.__proto__ = proto; + return obj; +} +``` + +下面是一个例子。 + +```javascript +let proto = {}; +let obj = { x: 10 }; +Object.setPrototypeOf(obj, proto); + +proto.y = 20; +proto.z = 40; + +obj.x // 10 +obj.y // 20 +obj.z // 40 +``` + +上面代码将`proto`对象设为`obj`对象的原型,所以从`obj`对象可以读取`proto`对象的属性。 + +如果第一个参数不是对象,会自动转为对象。但是由于返回的还是第一个参数,所以这个操作不会产生任何效果。 + +```javascript +Object.setPrototypeOf(1, {}) === 1 // true +Object.setPrototypeOf('foo', {}) === 'foo' // true +Object.setPrototypeOf(true, {}) === true // true +``` + +由于`undefined`和`null`无法转为对象,所以如果第一个参数是`undefined`或`null`,就会报错。 + +```javascript +Object.setPrototypeOf(undefined, {}) +// TypeError: Object.setPrototypeOf called on null or undefined + +Object.setPrototypeOf(null, {}) +// TypeError: Object.setPrototypeOf called on null or undefined +``` + +### Object.getPrototypeOf() + +该方法与`Object.setPrototypeOf`方法配套,用于读取一个对象的原型对象。 + +```javascript +Object.getPrototypeOf(obj); +``` + +下面是一个例子。 + +```javascript +function Rectangle() { + // ... +} + +const rec = new Rectangle(); + +Object.getPrototypeOf(rec) === Rectangle.prototype +// true + +Object.setPrototypeOf(rec, Object.prototype); +Object.getPrototypeOf(rec) === Rectangle.prototype +// false +``` + +如果参数不是对象,会被自动转为对象。 + +```javascript +// 等同于 Object.getPrototypeOf(Number(1)) +Object.getPrototypeOf(1) +// Number {[[PrimitiveValue]]: 0} + +// 等同于 Object.getPrototypeOf(String('foo')) +Object.getPrototypeOf('foo') +// String {length: 0, [[PrimitiveValue]]: ""} + +// 等同于 Object.getPrototypeOf(Boolean(true)) +Object.getPrototypeOf(true) +// Boolean {[[PrimitiveValue]]: false} + +Object.getPrototypeOf(1) === Number.prototype // true +Object.getPrototypeOf('foo') === String.prototype // true +Object.getPrototypeOf(true) === Boolean.prototype // true +``` + +如果参数是`undefined`或`null`,它们无法转为对象,所以会报错。 + +```javascript +Object.getPrototypeOf(null) +// TypeError: Cannot convert undefined or null to object + +Object.getPrototypeOf(undefined) +// TypeError: Cannot convert undefined or null to object +``` + +## Object.keys(),Object.values(),Object.entries() + +### Object.keys() + +ES5 引入了`Object.keys`方法,返回一个数组,成员是参数对象自身的(不含继承的)所有可遍历(enumerable)属性的键名。 + +```javascript +var obj = { foo: 'bar', baz: 42 }; +Object.keys(obj) +// ["foo", "baz"] +``` + +ES2017 [引入](https://github.com/tc39/proposal-object-values-entries)了跟`Object.keys`配套的`Object.values`和`Object.entries`,作为遍历一个对象的补充手段,供`for...of`循环使用。 + +```javascript +let {keys, values, entries} = Object; +let obj = { a: 1, b: 2, c: 3 }; + +for (let key of keys(obj)) { + console.log(key); // 'a', 'b', 'c' +} + +for (let value of values(obj)) { + console.log(value); // 1, 2, 3 +} + +for (let [key, value] of entries(obj)) { + console.log([key, value]); // ['a', 1], ['b', 2], ['c', 3] +} +``` + +### Object.values() + +`Object.values`方法返回一个数组,成员是参数对象自身的(不含继承的)所有可遍历(enumerable)属性的键值。 + +```javascript +const obj = { foo: 'bar', baz: 42 }; +Object.values(obj) +// ["bar", 42] +``` + +返回数组的成员顺序,与本章的《属性的遍历》部分介绍的排列规则一致。 + +```javascript +const obj = { 100: 'a', 2: 'b', 7: 'c' }; +Object.values(obj) +// ["b", "c", "a"] +``` + +上面代码中,属性名为数值的属性,是按照数值大小,从小到大遍历的,因此返回的顺序是`b`、`c`、`a`。 + +`Object.values`只返回对象自身的可遍历属性。 + +```javascript +const obj = Object.create({}, {p: {value: 42}}); +Object.values(obj) // [] +``` + +上面代码中,`Object.create`方法的第二个参数添加的对象属性(属性`p`),如果不显式声明,默认是不可遍历的,因为`p`的属性描述对象的`enumerable`默认是`false`,`Object.values`不会返回这个属性。只要把`enumerable`改成`true`,`Object.values`就会返回属性`p`的值。 + +```javascript +const obj = Object.create({}, {p: + { +    value: 42, +    enumerable: true +  } +}); +Object.values(obj) // [42] +``` + +`Object.values`会过滤属性名为 Symbol 值的属性。 + +```javascript +Object.values({ [Symbol()]: 123, foo: 'abc' }); +// ['abc'] +``` + +如果`Object.values`方法的参数是一个字符串,会返回各个字符组成的一个数组。 + +```javascript +Object.values('foo') +// ['f', 'o', 'o'] +``` + +上面代码中,字符串会先转成一个类似数组的对象。字符串的每个字符,就是该对象的一个属性。因此,`Object.values`返回每个属性的键值,就是各个字符组成的一个数组。 + +如果参数不是对象,`Object.values`会先将其转为对象。由于数值和布尔值的包装对象,都不会为实例添加非继承的属性。所以,`Object.values`会返回空数组。 + +```javascript +Object.values(42) // [] +Object.values(true) // [] +``` + +### Object.entries() + +`Object.entries()`方法返回一个数组,成员是参数对象自身的(不含继承的)所有可遍历(enumerable)属性的键值对数组。 + +```javascript +const obj = { foo: 'bar', baz: 42 }; +Object.entries(obj) +// [ ["foo", "bar"], ["baz", 42] ] +``` + +除了返回值不一样,该方法的行为与`Object.values`基本一致。 + +如果原对象的属性名是一个 Symbol 值,该属性会被忽略。 + +```javascript +Object.entries({ [Symbol()]: 123, foo: 'abc' }); +// [ [ 'foo', 'abc' ] ] +``` + +上面代码中,原对象有两个属性,`Object.entries`只输出属性名非 Symbol 值的属性。将来可能会有`Reflect.ownEntries()`方法,返回对象自身的所有属性。 + +`Object.entries`的基本用途是遍历对象的属性。 + +```javascript +let obj = { one: 1, two: 2 }; +for (let [k, v] of Object.entries(obj)) { + console.log( + `${JSON.stringify(k)}: ${JSON.stringify(v)}` + ); +} +// "one": 1 +// "two": 2 +``` + +`Object.entries`方法的另一个用处是,将对象转为真正的`Map`结构。 + +```javascript +const obj = { foo: 'bar', baz: 42 }; +const map = new Map(Object.entries(obj)); +map // Map { foo: "bar", baz: 42 } +``` + +自己实现`Object.entries`方法,非常简单。 + +```javascript +// Generator函数的版本 +function* entries(obj) { + for (let key of Object.keys(obj)) { + yield [key, obj[key]]; + } +} + +// 非Generator函数的版本 +function entries(obj) { + let arr = []; + for (let key of Object.keys(obj)) { + arr.push([key, obj[key]]); + } + return arr; +} +``` + +## Object.fromEntries() + +`Object.fromEntries()`方法是`Object.entries()`的逆操作,用于将一个键值对数组转为对象。 + +```javascript +Object.fromEntries([ + ['foo', 'bar'], + ['baz', 42] +]) +// { foo: "bar", baz: 42 } +``` + +该方法的主要目的,是将键值对的数据结构还原为对象,因此特别适合将 Map 结构转为对象。 + +```javascript +// 例一 +const entries = new Map([ + ['foo', 'bar'], + ['baz', 42] +]); + +Object.fromEntries(entries) +// { foo: "bar", baz: 42 } + +// 例二 +const map = new Map().set('foo', true).set('bar', false); +Object.fromEntries(map) +// { foo: true, bar: false } +``` + +该方法的一个用处是配合`URLSearchParams`对象,将查询字符串转为对象。 + +```javascript +Object.fromEntries(new URLSearchParams('foo=bar&baz=qux')) +// { foo: "bar", baz: "qux" } +``` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/object.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/object.md" new file mode 100755 index 000000000..049032d59 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/object.md" @@ -0,0 +1,707 @@ +# 对象的扩展 + +对象(object)是 JavaScript 最重要的数据结构。ES6 对它进行了重大升级,本章介绍数据结构本身的改变,下一章介绍`Object`对象的新增方法。 + +## 属性的简洁表示法 + +ES6 允许直接写入变量和函数,作为对象的属性和方法。这样的书写更加简洁。 + +```javascript +const foo = 'bar'; +const baz = {foo}; +baz // {foo: "bar"} + +// 等同于 +const baz = {foo: foo}; +``` + +上面代码表明,ES6 允许在对象之中,直接写变量。这时,属性名为变量名, 属性值为变量的值。下面是另一个例子。 + +```javascript +function f(x, y) { + return {x, y}; +} + +// 等同于 + +function f(x, y) { + return {x: x, y: y}; +} + +f(1, 2) // Object {x: 1, y: 2} +``` + +除了属性简写,方法也可以简写。 + +```javascript +const o = { + method() { + return "Hello!"; + } +}; + +// 等同于 + +const o = { + method: function() { + return "Hello!"; + } +}; +``` + +下面是一个实际的例子。 + +```javascript +let birth = '2000/01/01'; + +const Person = { + + name: '张三', + + //等同于birth: birth + birth, + + // 等同于hello: function ()... + hello() { console.log('我的名字是', this.name); } + +}; +``` + +这种写法用于函数的返回值,将会非常方便。 + +```javascript +function getPoint() { + const x = 1; + const y = 10; + return {x, y}; +} + +getPoint() +// {x:1, y:10} +``` + +CommonJS 模块输出一组变量,就非常合适使用简洁写法。 + +```javascript +let ms = {}; + +function getItem (key) { + return key in ms ? ms[key] : null; +} + +function setItem (key, value) { + ms[key] = value; +} + +function clear () { + ms = {}; +} + +module.exports = { getItem, setItem, clear }; +// 等同于 +module.exports = { + getItem: getItem, + setItem: setItem, + clear: clear +}; +``` + +属性的赋值器(setter)和取值器(getter),事实上也是采用这种写法。 + +```javascript +const cart = { + _wheels: 4, + + get wheels () { + return this._wheels; + }, + + set wheels (value) { + if (value < this._wheels) { + throw new Error('数值太小了!'); + } + this._wheels = value; + } +} +``` + +注意,简洁写法的属性名总是字符串,这会导致一些看上去比较奇怪的结果。 + +```javascript +const obj = { + class () {} +}; + +// 等同于 + +var obj = { + 'class': function() {} +}; +``` + +上面代码中,`class`是字符串,所以不会因为它属于关键字,而导致语法解析报错。 + +如果某个方法的值是一个 Generator 函数,前面需要加上星号。 + +```javascript +const obj = { + * m() { + yield 'hello world'; + } +}; +``` + +## 属性名表达式 + +JavaScript 定义对象的属性,有两种方法。 + +```javascript +// 方法一 +obj.foo = true; + +// 方法二 +obj['a' + 'bc'] = 123; +``` + +上面代码的方法一是直接用标识符作为属性名,方法二是用表达式作为属性名,这时要将表达式放在方括号之内。 + +但是,如果使用字面量方式定义对象(使用大括号),在 ES5 中只能使用方法一(标识符)定义属性。 + +```javascript +var obj = { + foo: true, + abc: 123 +}; +``` + +ES6 允许字面量定义对象时,用方法二(表达式)作为对象的属性名,即把表达式放在方括号内。 + +```javascript +let propKey = 'foo'; + +let obj = { + [propKey]: true, + ['a' + 'bc']: 123 +}; +``` + +下面是另一个例子。 + +```javascript +let lastWord = 'last word'; + +const a = { + 'first word': 'hello', + [lastWord]: 'world' +}; + +a['first word'] // "hello" +a[lastWord] // "world" +a['last word'] // "world" +``` + +表达式还可以用于定义方法名。 + +```javascript +let obj = { + ['h' + 'ello']() { + return 'hi'; + } +}; + +obj.hello() // hi +``` + +注意,属性名表达式与简洁表示法,不能同时使用,会报错。 + +```javascript +// 报错 +const foo = 'bar'; +const bar = 'abc'; +const baz = { [foo] }; + +// 正确 +const foo = 'bar'; +const baz = { [foo]: 'abc'}; +``` + +注意,属性名表达式如果是一个对象,默认情况下会自动将对象转为字符串`[object Object]`,这一点要特别小心。 + +```javascript +const keyA = {a: 1}; +const keyB = {b: 2}; + +const myObject = { + [keyA]: 'valueA', + [keyB]: 'valueB' +}; + +myObject // Object {[object Object]: "valueB"} +``` + +上面代码中,`[keyA]`和`[keyB]`得到的都是`[object Object]`,所以`[keyB]`会把`[keyA]`覆盖掉,而`myObject`最后只有一个`[object Object]`属性。 + +## 方法的 name 属性 + +函数的`name`属性,返回函数名。对象方法也是函数,因此也有`name`属性。 + +```javascript +const person = { + sayName() { +    console.log('hello!'); + }, +}; + +person.sayName.name // "sayName" +``` + +上面代码中,方法的`name`属性返回函数名(即方法名)。 + +如果对象的方法使用了取值函数(`getter`)和存值函数(`setter`),则`name`属性不是在该方法上面,而是该方法的属性的描述对象的`get`和`set`属性上面,返回值是方法名前加上`get`和`set`。 + +```javascript +const obj = { + get foo() {}, + set foo(x) {} +}; + +obj.foo.name +// TypeError: Cannot read property 'name' of undefined + +const descriptor = Object.getOwnPropertyDescriptor(obj, 'foo'); + +descriptor.get.name // "get foo" +descriptor.set.name // "set foo" +``` + +有两种特殊情况:`bind`方法创造的函数,`name`属性返回`bound`加上原函数的名字;`Function`构造函数创造的函数,`name`属性返回`anonymous`。 + +```javascript +(new Function()).name // "anonymous" + +var doSomething = function() { + // ... +}; +doSomething.bind().name // "bound doSomething" +``` + +如果对象的方法是一个 Symbol 值,那么`name`属性返回的是这个 Symbol 值的描述。 + +```javascript +const key1 = Symbol('description'); +const key2 = Symbol(); +let obj = { + [key1]() {}, + [key2]() {}, +}; +obj[key1].name // "[description]" +obj[key2].name // "" +``` + +上面代码中,`key1`对应的 Symbol 值有描述,`key2`没有。 + +## 属性的可枚举性和遍历 + +### 可枚举性 + +对象的每个属性都有一个描述对象(Descriptor),用来控制该属性的行为。`Object.getOwnPropertyDescriptor`方法可以获取该属性的描述对象。 + +```javascript +let obj = { foo: 123 }; +Object.getOwnPropertyDescriptor(obj, 'foo') +// { +// value: 123, +// writable: true, +// enumerable: true, +// configurable: true +// } +``` + +描述对象的`enumerable`属性,称为“可枚举性”,如果该属性为`false`,就表示某些操作会忽略当前属性。 + +目前,有四个操作会忽略`enumerable`为`false`的属性。 + +- `for...in`循环:只遍历对象自身的和继承的可枚举的属性。 +- `Object.keys()`:返回对象自身的所有可枚举的属性的键名。 +- `JSON.stringify()`:只串行化对象自身的可枚举的属性。 +- `Object.assign()`: 忽略`enumerable`为`false`的属性,只拷贝对象自身的可枚举的属性。 + +这四个操作之中,前三个是 ES5 就有的,最后一个`Object.assign()`是 ES6 新增的。其中,只有`for...in`会返回继承的属性,其他三个方法都会忽略继承的属性,只处理对象自身的属性。实际上,引入“可枚举”(`enumerable`)这个概念的最初目的,就是让某些属性可以规避掉`for...in`操作,不然所有内部属性和方法都会被遍历到。比如,对象原型的`toString`方法,以及数组的`length`属性,就通过“可枚举性”,从而避免被`for...in`遍历到。 + +```javascript +Object.getOwnPropertyDescriptor(Object.prototype, 'toString').enumerable +// false + +Object.getOwnPropertyDescriptor([], 'length').enumerable +// false +``` + +上面代码中,`toString`和`length`属性的`enumerable`都是`false`,因此`for...in`不会遍历到这两个继承自原型的属性。 + +另外,ES6 规定,所有 Class 的原型的方法都是不可枚举的。 + +```javascript +Object.getOwnPropertyDescriptor(class {foo() {}}.prototype, 'foo').enumerable +// false +``` + +总的来说,操作中引入继承的属性会让问题复杂化,大多数时候,我们只关心对象自身的属性。所以,尽量不要用`for...in`循环,而用`Object.keys()`代替。 + +### 属性的遍历 + +ES6 一共有 5 种方法可以遍历对象的属性。 + +**(1)for...in** + +`for...in`循环遍历对象自身的和继承的可枚举属性(不含 Symbol 属性)。 + +**(2)Object.keys(obj)** + +`Object.keys`返回一个数组,包括对象自身的(不含继承的)所有可枚举属性(不含 Symbol 属性)的键名。 + +**(3)Object.getOwnPropertyNames(obj)** + +`Object.getOwnPropertyNames`返回一个数组,包含对象自身的所有属性(不含 Symbol 属性,但是包括不可枚举属性)的键名。 + +**(4)Object.getOwnPropertySymbols(obj)** + +`Object.getOwnPropertySymbols`返回一个数组,包含对象自身的所有 Symbol 属性的键名。 + +**(5)Reflect.ownKeys(obj)** + +`Reflect.ownKeys`返回一个数组,包含对象自身的所有键名,不管键名是 Symbol 或字符串,也不管是否可枚举。 + +以上的 5 种方法遍历对象的键名,都遵守同样的属性遍历的次序规则。 + +- 首先遍历所有数值键,按照数值升序排列。 +- 其次遍历所有字符串键,按照加入时间升序排列。 +- 最后遍历所有 Symbol 键,按照加入时间升序排列。 + +```javascript +Reflect.ownKeys({ [Symbol()]:0, b:0, 10:0, 2:0, a:0 }) +// ['2', '10', 'b', 'a', Symbol()] +``` + +上面代码中,`Reflect.ownKeys`方法返回一个数组,包含了参数对象的所有属性。这个数组的属性次序是这样的,首先是数值属性`2`和`10`,其次是字符串属性`b`和`a`,最后是 Symbol 属性。 + +## super 关键字 + +我们知道,`this`关键字总是指向函数所在的当前对象,ES6 又新增了另一个类似的关键字`super`,指向当前对象的原型对象。 + +```javascript +const proto = { + foo: 'hello' +}; + +const obj = { + foo: 'world', + find() { + return super.foo; + } +}; + +Object.setPrototypeOf(obj, proto); +obj.find() // "hello" +``` + +上面代码中,对象`obj.find()`方法之中,通过`super.foo`引用了原型对象`proto`的`foo`属性。 + +注意,`super`关键字表示原型对象时,只能用在对象的方法之中,用在其他地方都会报错。 + +```javascript +// 报错 +const obj = { + foo: super.foo +} + +// 报错 +const obj = { + foo: () => super.foo +} + +// 报错 +const obj = { + foo: function () { + return super.foo + } +} +``` + +上面三种`super`的用法都会报错,因为对于 JavaScript 引擎来说,这里的`super`都没有用在对象的方法之中。第一种写法是`super`用在属性里面,第二种和第三种写法是`super`用在一个函数里面,然后赋值给`foo`属性。目前,只有对象方法的简写法可以让 JavaScript 引擎确认,定义的是对象的方法。 + +JavaScript 引擎内部,`super.foo`等同于`Object.getPrototypeOf(this).foo`(属性)或`Object.getPrototypeOf(this).foo.call(this)`(方法)。 + +```javascript +const proto = { + x: 'hello', + foo() { + console.log(this.x); + }, +}; + +const obj = { + x: 'world', + foo() { + super.foo(); + } +} + +Object.setPrototypeOf(obj, proto); + +obj.foo() // "world" +``` + +上面代码中,`super.foo`指向原型对象`proto`的`foo`方法,但是绑定的`this`却还是当前对象`obj`,因此输出的就是`world`。 + +## 对象的扩展运算符 + +《数组的扩展》一章中,已经介绍过扩展运算符(`...`)。ES2018 将这个运算符[引入](https://github.com/sebmarkbage/ecmascript-rest-spread)了对象。 + +### 解构赋值 + +对象的解构赋值用于从一个对象取值,相当于将目标对象自身的所有可遍历的(enumerable)、但尚未被读取的属性,分配到指定的对象上面。所有的键和它们的值,都会拷贝到新对象上面。 + +```javascript +let { x, y, ...z } = { x: 1, y: 2, a: 3, b: 4 }; +x // 1 +y // 2 +z // { a: 3, b: 4 } +``` + +上面代码中,变量`z`是解构赋值所在的对象。它获取等号右边的所有尚未读取的键(`a`和`b`),将它们连同值一起拷贝过来。 + +由于解构赋值要求等号右边是一个对象,所以如果等号右边是`undefined`或`null`,就会报错,因为它们无法转为对象。 + +```javascript +let { x, y, ...z } = null; // 运行时错误 +let { x, y, ...z } = undefined; // 运行时错误 +``` + +解构赋值必须是最后一个参数,否则会报错。 + +```javascript +let { ...x, y, z } = someObject; // 句法错误 +let { x, ...y, ...z } = someObject; // 句法错误 +``` + +上面代码中,解构赋值不是最后一个参数,所以会报错。 + +注意,解构赋值的拷贝是浅拷贝,即如果一个键的值是复合类型的值(数组、对象、函数)、那么解构赋值拷贝的是这个值的引用,而不是这个值的副本。 + +```javascript +let obj = { a: { b: 1 } }; +let { ...x } = obj; +obj.a.b = 2; +x.a.b // 2 +``` + +上面代码中,`x`是解构赋值所在的对象,拷贝了对象`obj`的`a`属性。`a`属性引用了一个对象,修改这个对象的值,会影响到解构赋值对它的引用。 + +另外,扩展运算符的解构赋值,不能复制继承自原型对象的属性。 + +```javascript +let o1 = { a: 1 }; +let o2 = { b: 2 }; +o2.__proto__ = o1; +let { ...o3 } = o2; +o3 // { b: 2 } +o3.a // undefined +``` + +上面代码中,对象`o3`复制了`o2`,但是只复制了`o2`自身的属性,没有复制它的原型对象`o1`的属性。 + +下面是另一个例子。 + +```javascript +const o = Object.create({ x: 1, y: 2 }); +o.z = 3; + +let { x, ...newObj } = o; +let { y, z } = newObj; +x // 1 +y // undefined +z // 3 +``` + +上面代码中,变量`x`是单纯的解构赋值,所以可以读取对象`o`继承的属性;变量`y`和`z`是扩展运算符的解构赋值,只能读取对象`o`自身的属性,所以变量`z`可以赋值成功,变量`y`取不到值。ES6 规定,变量声明语句之中,如果使用解构赋值,扩展运算符后面必须是一个变量名,而不能是一个解构赋值表达式,所以上面代码引入了中间变量`newObj`,如果写成下面这样会报错。 + +```javascript +let { x, ...{ y, z } } = o; +// SyntaxError: ... must be followed by an identifier in declaration contexts +``` + +解构赋值的一个用处,是扩展某个函数的参数,引入其他操作。 + +```javascript +function baseFunction({ a, b }) { + // ... +} +function wrapperFunction({ x, y, ...restConfig }) { + // 使用 x 和 y 参数进行操作 + // 其余参数传给原始函数 + return baseFunction(restConfig); +} +``` + +上面代码中,原始函数`baseFunction`接受`a`和`b`作为参数,函数`wrapperFunction`在`baseFunction`的基础上进行了扩展,能够接受多余的参数,并且保留原始函数的行为。 + +### 扩展运算符 + +对象的扩展运算符(`...`)用于取出参数对象的所有可遍历属性,拷贝到当前对象之中。 + +```javascript +let z = { a: 3, b: 4 }; +let n = { ...z }; +n // { a: 3, b: 4 } +``` + +由于数组是特殊的对象,所以对象的扩展运算符也可以用于数组。 + +```javascript +let foo = { ...['a', 'b', 'c'] }; +foo +// {0: "a", 1: "b", 2: "c"} +``` + +如果扩展运算符后面是一个空对象,则没有任何效果。 + +```javascript +{...{}, a: 1} +// { a: 1 } +``` + +如果扩展运算符后面不是对象,则会自动将其转为对象。 + +```javascript +// 等同于 {...Object(1)} +{...1} // {} +``` + +上面代码中,扩展运算符后面是整数`1`,会自动转为数值的包装对象`Number{1}`。由于该对象没有自身属性,所以返回一个空对象。 + +下面的例子都是类似的道理。 + +```javascript +// 等同于 {...Object(true)} +{...true} // {} + +// 等同于 {...Object(undefined)} +{...undefined} // {} + +// 等同于 {...Object(null)} +{...null} // {} +``` + +但是,如果扩展运算符后面是字符串,它会自动转成一个类似数组的对象,因此返回的不是空对象。 + +```javascript +{...'hello'} +// {0: "h", 1: "e", 2: "l", 3: "l", 4: "o"} +``` + +对象的扩展运算符等同于使用`Object.assign()`方法。 + +```javascript +let aClone = { ...a }; +// 等同于 +let aClone = Object.assign({}, a); +``` + +上面的例子只是拷贝了对象实例的属性,如果想完整克隆一个对象,还拷贝对象原型的属性,可以采用下面的写法。 + +```javascript +// 写法一 +const clone1 = { + __proto__: Object.getPrototypeOf(obj), + ...obj +}; + +// 写法二 +const clone2 = Object.assign( + Object.create(Object.getPrototypeOf(obj)), + obj +); + +// 写法三 +const clone3 = Object.create( + Object.getPrototypeOf(obj), + Object.getOwnPropertyDescriptors(obj) +) +``` + +上面代码中,写法一的`__proto__`属性在非浏览器的环境不一定部署,因此推荐使用写法二和写法三。 + +扩展运算符可以用于合并两个对象。 + +```javascript +let ab = { ...a, ...b }; +// 等同于 +let ab = Object.assign({}, a, b); +``` + +如果用户自定义的属性,放在扩展运算符后面,则扩展运算符内部的同名属性会被覆盖掉。 + +```javascript +let aWithOverrides = { ...a, x: 1, y: 2 }; +// 等同于 +let aWithOverrides = { ...a, ...{ x: 1, y: 2 } }; +// 等同于 +let x = 1, y = 2, aWithOverrides = { ...a, x, y }; +// 等同于 +let aWithOverrides = Object.assign({}, a, { x: 1, y: 2 }); +``` + +上面代码中,`a`对象的`x`属性和`y`属性,拷贝到新对象后会被覆盖掉。 + +这用来修改现有对象部分的属性就很方便了。 + +```javascript +let newVersion = { + ...previousVersion, + name: 'New Name' // Override the name property +}; +``` + +上面代码中,`newVersion`对象自定义了`name`属性,其他属性全部复制自`previousVersion`对象。 + +如果把自定义属性放在扩展运算符前面,就变成了设置新对象的默认属性值。 + +```javascript +let aWithDefaults = { x: 1, y: 2, ...a }; +// 等同于 +let aWithDefaults = Object.assign({}, { x: 1, y: 2 }, a); +// 等同于 +let aWithDefaults = Object.assign({ x: 1, y: 2 }, a); +``` + +与数组的扩展运算符一样,对象的扩展运算符后面可以跟表达式。 + +```javascript +const obj = { + ...(x > 1 ? {a: 1} : {}), + b: 2, +}; +``` + +扩展运算符的参数对象之中,如果有取值函数`get`,这个函数是会执行的。 + +```javascript +// 并不会抛出错误,因为 x 属性只是被定义,但没执行 +let aWithXGetter = { + ...a, + get x() { + throw new Error('not throw yet'); + } +}; + +// 会抛出错误,因为 x 属性被执行了 +let runtimeError = { + ...a, + ...{ + get x() { + throw new Error('throw now'); + } + } +}; +``` + diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/promise.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/promise.md" old mode 100644 new mode 100755 similarity index 52% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/promise.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/promise.md" index 55dbfdf5e..bda0dce64 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/promise.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/promise.md" @@ -2,30 +2,32 @@ ## Promise 的含义 -Promise 是异步编程的一种解决方案,比传统的解决方案——回调函数和事件——更合理和更强大。它由社区最早提出和实现,ES6将其写进了语言标准,统一了用法,原生提供了`Promise`对象。 +Promise 是异步编程的一种解决方案,比传统的解决方案——回调函数和事件——更合理和更强大。它由社区最早提出和实现,ES6 将其写进了语言标准,统一了用法,原生提供了`Promise`对象。 所谓`Promise`,简单说就是一个容器,里面保存着某个未来才会结束的事件(通常是一个异步操作)的结果。从语法上说,Promise 是一个对象,从它可以获取异步操作的消息。Promise 提供统一的 API,各种异步操作都可以用同样的方法进行处理。 `Promise`对象有以下两个特点。 -(1)对象的状态不受外界影响。`Promise`对象代表一个异步操作,有三种状态:`Pending`(进行中)、`Resolved`(已完成,又称 Fulfilled)和`Rejected`(已失败)。只有异步操作的结果,可以决定当前是哪一种状态,任何其他操作都无法改变这个状态。这也是`Promise`这个名字的由来,它的英语意思就是“承诺”,表示其他手段无法改变。 +(1)对象的状态不受外界影响。`Promise`对象代表一个异步操作,有三种状态:`pending`(进行中)、`fulfilled`(已成功)和`rejected`(已失败)。只有异步操作的结果,可以决定当前是哪一种状态,任何其他操作都无法改变这个状态。这也是`Promise`这个名字的由来,它的英语意思就是“承诺”,表示其他手段无法改变。 -(2)一旦状态改变,就不会再变,任何时候都可以得到这个结果。`Promise`对象的状态改变,只有两种可能:从`Pending`变为`Resolved`和从`Pending`变为`Rejected`。只要这两种情况发生,状态就凝固了,不会再变了,会一直保持这个结果。如果改变已经发生了,就算你再对`Promise`对象添加回调函数,也会立即得到这个结果。这与事件(Event)完全不同,事件的特点是,如果你错过了它,再去监听,是得不到结果的。 +(2)一旦状态改变,就不会再变,任何时候都可以得到这个结果。`Promise`对象的状态改变,只有两种可能:从`pending`变为`fulfilled`和从`pending`变为`rejected`。只要这两种情况发生,状态就凝固了,不会再变了,会一直保持这个结果,这时就称为 resolved(已定型)。如果改变已经发生了,你再对`Promise`对象添加回调函数,也会立即得到这个结果。这与事件(Event)完全不同,事件的特点是,如果你错过了它,再去监听,是得不到结果的。 + +注意,为了行文方便,本章后面的`resolved`统一只指`fulfilled`状态,不包含`rejected`状态。 有了`Promise`对象,就可以将异步操作以同步操作的流程表达出来,避免了层层嵌套的回调函数。此外,`Promise`对象提供统一的接口,使得控制异步操作更加容易。 -`Promise`也有一些缺点。首先,无法取消`Promise`,一旦新建它就会立即执行,无法中途取消。其次,如果不设置回调函数,`Promise`内部抛出的错误,不会反应到外部。第三,当处于`Pending`状态时,无法得知目前进展到哪一个阶段(刚刚开始还是即将完成)。 +`Promise`也有一些缺点。首先,无法取消`Promise`,一旦新建它就会立即执行,无法中途取消。其次,如果不设置回调函数,`Promise`内部抛出的错误,不会反应到外部。第三,当处于`pending`状态时,无法得知目前进展到哪一个阶段(刚刚开始还是即将完成)。 -如果某些事件不断地反复发生,一般来说,使用 stream 模式是比部署`Promise`更好的选择。 +如果某些事件不断地反复发生,一般来说,使用 [Stream](https://nodejs.org/api/stream.html) 模式是比部署`Promise`更好的选择。 ## 基本用法 -ES6规定,Promise对象是一个构造函数,用来生成Promise实例。 +ES6 规定,`Promise`对象是一个构造函数,用来生成`Promise`实例。 -下面代码创造了一个Promise实例。 +下面代码创造了一个`Promise`实例。 ```javascript -var promise = new Promise(function(resolve, reject) { +const promise = new Promise(function(resolve, reject) { // ... some code if (/* 异步操作成功 */){ @@ -36,11 +38,11 @@ var promise = new Promise(function(resolve, reject) { }); ``` -Promise构造函数接受一个函数作为参数,该函数的两个参数分别是`resolve`和`reject`。它们是两个函数,由JavaScript引擎提供,不用自己部署。 +`Promise`构造函数接受一个函数作为参数,该函数的两个参数分别是`resolve`和`reject`。它们是两个函数,由 JavaScript 引擎提供,不用自己部署。 -`resolve`函数的作用是,将Promise对象的状态从“未完成”变为“成功”(即从Pending变为Resolved),在异步操作成功时调用,并将异步操作的结果,作为参数传递出去;`reject`函数的作用是,将Promise对象的状态从“未完成”变为“失败”(即从Pending变为Rejected),在异步操作失败时调用,并将异步操作报出的错误,作为参数传递出去。 +`resolve`函数的作用是,将`Promise`对象的状态从“未完成”变为“成功”(即从 pending 变为 resolved),在异步操作成功时调用,并将异步操作的结果,作为参数传递出去;`reject`函数的作用是,将`Promise`对象的状态从“未完成”变为“失败”(即从 pending 变为 rejected),在异步操作失败时调用,并将异步操作报出的错误,作为参数传递出去。 -Promise实例生成以后,可以用`then`方法分别指定`Resolved`状态和`Reject`状态的回调函数。 +`Promise`实例生成以后,可以用`then`方法分别指定`resolved`状态和`rejected`状态的回调函数。 ```javascript promise.then(function(value) { @@ -50,9 +52,9 @@ promise.then(function(value) { }); ``` -`then`方法可以接受两个回调函数作为参数。第一个回调函数是Promise对象的状态变为Resolved时调用,第二个回调函数是Promise对象的状态变为Reject时调用。其中,第二个函数是可选的,不一定要提供。这两个函数都接受Promise对象传出的值作为参数。 +`then`方法可以接受两个回调函数作为参数。第一个回调函数是`Promise`对象的状态变为`resolved`时调用,第二个回调函数是`Promise`对象的状态变为`rejected`时调用。其中,第二个函数是可选的,不一定要提供。这两个函数都接受`Promise`对象传出的值作为参数。 -下面是一个Promise对象的简单例子。 +下面是一个`Promise`对象的简单例子。 ```javascript function timeout(ms) { @@ -66,9 +68,9 @@ timeout(100).then((value) => { }); ``` -上面代码中,`timeout`方法返回一个Promise实例,表示一段时间以后才会发生的结果。过了指定的时间(`ms`参数)以后,Promise实例的状态变为Resolved,就会触发`then`方法绑定的回调函数。 +上面代码中,`timeout`方法返回一个`Promise`实例,表示一段时间以后才会发生的结果。过了指定的时间(`ms`参数)以后,`Promise`实例的状态变为`resolved`,就会触发`then`方法绑定的回调函数。 -Promise新建后就会立即执行。 +Promise 新建后就会立即执行。 ```javascript let promise = new Promise(function(resolve, reject) { @@ -77,24 +79,24 @@ let promise = new Promise(function(resolve, reject) { }); promise.then(function() { - console.log('Resolved.'); + console.log('resolved.'); }); console.log('Hi!'); // Promise // Hi! -// Resolved +// resolved ``` -上面代码中,Promise新建后立即执行,所以首先输出的是“Promise”。然后,`then`方法指定的回调函数,将在当前脚本所有同步任务执行完才会执行,所以“Resolved”最后输出。 +上面代码中,Promise 新建后立即执行,所以首先输出的是`Promise`。然后,`then`方法指定的回调函数,将在当前脚本所有同步任务执行完才会执行,所以`resolved`最后输出。 下面是异步加载图片的例子。 ```javascript function loadImageAsync(url) { return new Promise(function(resolve, reject) { - var image = new Image(); + const image = new Image(); image.onload = function() { resolve(image); @@ -109,21 +111,14 @@ function loadImageAsync(url) { } ``` -上面代码中,使用Promise包装了一个图片加载的异步操作。如果加载成功,就调用`resolve`方法,否则就调用`reject`方法。 +上面代码中,使用`Promise`包装了一个图片加载的异步操作。如果加载成功,就调用`resolve`方法,否则就调用`reject`方法。 -下面是一个用Promise对象实现的Ajax操作的例子。 +下面是一个用`Promise`对象实现的 Ajax 操作的例子。 ```javascript -var getJSON = function(url) { - var promise = new Promise(function(resolve, reject){ - var client = new XMLHttpRequest(); - client.open("GET", url); - client.onreadystatechange = handler; - client.responseType = "json"; - client.setRequestHeader("Accept", "application/json"); - client.send(); - - function handler() { +const getJSON = function(url) { + const promise = new Promise(function(resolve, reject){ + const handler = function() { if (this.readyState !== 4) { return; } @@ -133,6 +128,13 @@ var getJSON = function(url) { reject(new Error(this.statusText)); } }; + const client = new XMLHttpRequest(); + client.open("GET", url); + client.onreadystatechange = handler; + client.responseType = "json"; + client.setRequestHeader("Accept", "application/json"); + client.send(); + }); return promise; @@ -145,31 +147,31 @@ getJSON("/posts.json").then(function(json) { }); ``` -上面代码中,`getJSON`是对XMLHttpRequest对象的封装,用于发出一个针对JSON数据的HTTP请求,并且返回一个Promise对象。需要注意的是,在`getJSON`内部,`resolve`函数和`reject`函数调用时,都带有参数。 +上面代码中,`getJSON`是对 XMLHttpRequest 对象的封装,用于发出一个针对 JSON 数据的 HTTP 请求,并且返回一个`Promise`对象。需要注意的是,在`getJSON`内部,`resolve`函数和`reject`函数调用时,都带有参数。 -如果调用`resolve`函数和`reject`函数时带有参数,那么它们的参数会被传递给回调函数。`reject`函数的参数通常是Error对象的实例,表示抛出的错误;`resolve`函数的参数除了正常的值以外,还可能是另一个Promise实例,表示异步操作的结果有可能是一个值,也有可能是另一个异步操作,比如像下面这样。 +如果调用`resolve`函数和`reject`函数时带有参数,那么它们的参数会被传递给回调函数。`reject`函数的参数通常是`Error`对象的实例,表示抛出的错误;`resolve`函数的参数除了正常的值以外,还可能是另一个 Promise 实例,比如像下面这样。 ```javascript -var p1 = new Promise(function (resolve, reject) { +const p1 = new Promise(function (resolve, reject) { // ... }); -var p2 = new Promise(function (resolve, reject) { +const p2 = new Promise(function (resolve, reject) { // ... resolve(p1); }) ``` -上面代码中,`p1`和`p2`都是Promise的实例,但是`p2`的`resolve`方法将`p1`作为参数,即一个异步操作的结果是返回另一个异步操作。 +上面代码中,`p1`和`p2`都是 Promise 的实例,但是`p2`的`resolve`方法将`p1`作为参数,即一个异步操作的结果是返回另一个异步操作。 -注意,这时`p1`的状态就会传递给`p2`,也就是说,`p1`的状态决定了`p2`的状态。如果`p1`的状态是`Pending`,那么`p2`的回调函数就会等待`p1`的状态改变;如果`p1`的状态已经是`Resolved`或者`Rejected`,那么`p2`的回调函数将会立刻执行。 +注意,这时`p1`的状态就会传递给`p2`,也就是说,`p1`的状态决定了`p2`的状态。如果`p1`的状态是`pending`,那么`p2`的回调函数就会等待`p1`的状态改变;如果`p1`的状态已经是`resolved`或者`rejected`,那么`p2`的回调函数将会立刻执行。 ```javascript -var p1 = new Promise(function (resolve, reject) { +const p1 = new Promise(function (resolve, reject) { setTimeout(() => reject(new Error('fail')), 3000) }) -var p2 = new Promise(function (resolve, reject) { +const p2 = new Promise(function (resolve, reject) { setTimeout(() => resolve(p1), 1000) }) @@ -179,13 +181,38 @@ p2 // Error: fail ``` -上面代码中,`p1`是一个Promise,3秒之后变为`rejected`。`p2`的状态在1秒之后改变,`resolve`方法返回的是`p1`。由于`p2`返回的是另一个 Promise,导致`p2`自己的状态无效了,由`p1`的状态决定`p2`的状态。所以,后面的`then`语句都变成针对后者(`p1`)。又过了2秒,`p1`变为`rejected`,导致触发`catch`方法指定的回调函数。 +上面代码中,`p1`是一个 Promise,3 秒之后变为`rejected`。`p2`的状态在 1 秒之后改变,`resolve`方法返回的是`p1`。由于`p2`返回的是另一个 Promise,导致`p2`自己的状态无效了,由`p1`的状态决定`p2`的状态。所以,后面的`then`语句都变成针对后者(`p1`)。又过了 2 秒,`p1`变为`rejected`,导致触发`catch`方法指定的回调函数。 + +注意,调用`resolve`或`reject`并不会终结 Promise 的参数函数的执行。 + +```javascript +new Promise((resolve, reject) => { + resolve(1); + console.log(2); +}).then(r => { + console.log(r); +}); +// 2 +// 1 +``` + +上面代码中,调用`resolve(1)`以后,后面的`console.log(2)`还是会执行,并且会首先打印出来。这是因为立即 resolved 的 Promise 是在本轮事件循环的末尾执行,总是晚于本轮循环的同步任务。 + +一般来说,调用`resolve`或`reject`以后,Promise 的使命就完成了,后继操作应该放到`then`方法里面,而不应该直接写在`resolve`或`reject`的后面。所以,最好在它们前面加上`return`语句,这样就不会有意外。 + +```javascript +new Promise((resolve, reject) => { + return resolve(1); + // 后面的语句不会执行 + console.log(2); +}) +``` ## Promise.prototype.then() -Promise实例具有`then`方法,也就是说,`then`方法是定义在原型对象Promise.prototype上的。它的作用是为Promise实例添加状态改变时的回调函数。前面说过,`then`方法的第一个参数是Resolved状态的回调函数,第二个参数(可选)是Rejected状态的回调函数。 +Promise 实例具有`then`方法,也就是说,`then`方法是定义在原型对象`Promise.prototype`上的。它的作用是为 Promise 实例添加状态改变时的回调函数。前面说过,`then`方法的第一个参数是`resolved`状态的回调函数,第二个参数(可选)是`rejected`状态的回调函数。 -`then`方法返回的是一个新的Promise实例(注意,不是原来那个Promise实例)。因此可以采用链式写法,即`then`方法后面再调用另一个`then`方法。 +`then`方法返回的是一个新的`Promise`实例(注意,不是原来那个`Promise`实例)。因此可以采用链式写法,即`then`方法后面再调用另一个`then`方法。 ```javascript getJSON("/posts.json").then(function(json) { @@ -197,19 +224,19 @@ getJSON("/posts.json").then(function(json) { 上面的代码使用`then`方法,依次指定了两个回调函数。第一个回调函数完成以后,会将返回结果作为参数,传入第二个回调函数。 -采用链式的`then`,可以指定一组按照次序调用的回调函数。这时,前一个回调函数,有可能返回的还是一个Promise对象(即有异步操作),这时后一个回调函数,就会等待该Promise对象的状态发生变化,才会被调用。 +采用链式的`then`,可以指定一组按照次序调用的回调函数。这时,前一个回调函数,有可能返回的还是一个`Promise`对象(即有异步操作),这时后一个回调函数,就会等待该`Promise`对象的状态发生变化,才会被调用。 ```javascript getJSON("/post/1.json").then(function(post) { return getJSON(post.commentURL); }).then(function funcA(comments) { - console.log("Resolved: ", comments); + console.log("resolved: ", comments); }, function funcB(err){ - console.log("Rejected: ", err); + console.log("rejected: ", err); }); ``` -上面代码中,第一个`then`方法指定的回调函数,返回的是另一个Promise对象。这时,第二个`then`方法指定的回调函数,就会等待这个新的Promise对象状态发生变化。如果变为Resolved,就调用`funcA`,如果状态变为Rejected,就调用`funcB`。 +上面代码中,第一个`then`方法指定的回调函数,返回的是另一个`Promise`对象。这时,第二个`then`方法指定的回调函数,就会等待这个新的`Promise`对象状态发生变化。如果变为`resolved`,就调用`funcA`,如果状态变为`rejected`,就调用`funcB`。 如果采用箭头函数,上面的代码可以写得更简洁。 @@ -217,14 +244,14 @@ getJSON("/post/1.json").then(function(post) { getJSON("/post/1.json").then( post => getJSON(post.commentURL) ).then( - comments => console.log("Resolved: ", comments), - err => console.log("Rejected: ", err) + comments => console.log("resolved: ", comments), + err => console.log("rejected: ", err) ); ``` ## Promise.prototype.catch() -`Promise.prototype.catch`方法是`.then(null, rejection)`的别名,用于指定发生错误时的回调函数。 +`Promise.prototype.catch`方法是`.then(null, rejection)`或`.then(undefined, rejection)`的别名,用于指定发生错误时的回调函数。 ```javascript getJSON('/posts.json').then(function(posts) { @@ -235,7 +262,7 @@ getJSON('/posts.json').then(function(posts) { }); ``` -上面代码中,`getJSON`方法返回一个 Promise 对象,如果该对象状态变为`Resolved`,则会调用`then`方法指定的回调函数;如果异步操作抛出错误,状态就会变为`Rejected`,就会调用`catch`方法指定的回调函数,处理这个错误。另外,`then`方法指定的回调函数,如果运行中抛出错误,也会被`catch`方法捕获。 +上面代码中,`getJSON`方法返回一个 Promise 对象,如果该对象状态变为`resolved`,则会调用`then`方法指定的回调函数;如果异步操作抛出错误,状态就会变为`rejected`,就会调用`catch`方法指定的回调函数,处理这个错误。另外,`then`方法指定的回调函数,如果运行中抛出错误,也会被`catch`方法捕获。 ```javascript p.then((val) => console.log('fulfilled:', val)) @@ -249,7 +276,7 @@ p.then((val) => console.log('fulfilled:', val)) 下面是一个例子。 ```javascript -var promise = new Promise(function(resolve, reject) { +const promise = new Promise(function(resolve, reject) { throw new Error('test'); }); promise.catch(function(error) { @@ -262,7 +289,7 @@ promise.catch(function(error) { ```javascript // 写法一 -var promise = new Promise(function(resolve, reject) { +const promise = new Promise(function(resolve, reject) { try { throw new Error('test'); } catch(e) { @@ -274,7 +301,7 @@ promise.catch(function(error) { }); // 写法二 -var promise = new Promise(function(resolve, reject) { +const promise = new Promise(function(resolve, reject) { reject(new Error('test')); }); promise.catch(function(error) { @@ -284,10 +311,10 @@ promise.catch(function(error) { 比较上面两种写法,可以发现`reject`方法的作用,等同于抛出错误。 -如果Promise状态已经变成`Resolved`,再抛出错误是无效的。 +如果 Promise 状态已经变成`resolved`,再抛出错误是无效的。 ```javascript -var promise = new Promise(function(resolve, reject) { +const promise = new Promise(function(resolve, reject) { resolve('ok'); throw new Error('test'); }); @@ -311,9 +338,9 @@ getJSON('/post/1.json').then(function(post) { }); ``` -上面代码中,一共有三个Promise对象:一个由`getJSON`产生,两个由`then`产生。它们之中任何一个抛出的错误,都会被最后一个`catch`捕获。 +上面代码中,一共有三个 Promise 对象:一个由`getJSON`产生,两个由`then`产生。它们之中任何一个抛出的错误,都会被最后一个`catch`捕获。 -一般来说,不要在`then`方法里面定义Reject状态的回调函数(即`then`的第二个参数),总是使用`catch`方法。 +一般来说,不要在`then`方法里面定义 Reject 状态的回调函数(即`then`的第二个参数),总是使用`catch`方法。 ```javascript // bad @@ -336,10 +363,10 @@ promise 上面代码中,第二种写法要好于第一种写法,理由是第二种写法可以捕获前面`then`方法执行中的错误,也更接近同步的写法(`try/catch`)。因此,建议总是使用`catch`方法,而不使用`then`方法的第二个参数。 -跟传统的`try/catch`代码块不同的是,如果没有使用`catch`方法指定错误处理的回调函数,Promise对象抛出的错误不会传递到外层代码,即不会有任何反应。 +跟传统的`try/catch`代码块不同的是,如果没有使用`catch`方法指定错误处理的回调函数,Promise 对象抛出的错误不会传递到外层代码,即不会有任何反应。 ```javascript -var someAsyncThing = function() { +const someAsyncThing = function() { return new Promise(function(resolve, reject) { // 下面一行会报错,因为x没有声明 resolve(x + 2); @@ -349,36 +376,44 @@ var someAsyncThing = function() { someAsyncThing().then(function() { console.log('everything is great'); }); + +setTimeout(() => { console.log(123) }, 2000); +// Uncaught (in promise) ReferenceError: x is not defined +// 123 ``` -上面代码中,`someAsyncThing`函数产生的Promise对象会报错,但是由于没有指定`catch`方法,这个错误不会被捕获,也不会传递到外层代码,导致运行后没有任何输出。注意,Chrome浏览器不遵守这条规定,它会抛出错误“ReferenceError: x is not defined”。 +上面代码中,`someAsyncThing`函数产生的 Promise 对象,内部有语法错误。浏览器运行到这一行,会打印出错误提示`ReferenceError: x is not defined`,但是不会退出进程、终止脚本执行,2 秒之后还是会输出`123`。这就是说,Promise 内部的错误不会影响到 Promise 外部的代码,通俗的说法就是“Promise 会吃掉错误”。 + +这个脚本放在服务器执行,退出码就是`0`(即表示执行成功)。不过,Node 有一个`unhandledRejection`事件,专门监听未捕获的`reject`错误,上面的脚本会触发这个事件的监听函数,可以在监听函数里面抛出错误。 ```javascript -var promise = new Promise(function(resolve, reject) { - resolve('ok'); - setTimeout(function() { throw new Error('test') }, 0) +process.on('unhandledRejection', function (err, p) { + throw err; }); -promise.then(function(value) { console.log(value) }); -// ok -// Uncaught Error: test ``` -上面代码中,Promise 指定在下一轮“事件循环”再抛出错误,结果由于没有指定使用`try...catch`语句,就冒泡到最外层,成了未捕获的错误。因为此时,Promise的函数体已经运行结束了,所以这个错误是在Promise函数体外抛出的。 +上面代码中,`unhandledRejection`事件的监听函数有两个参数,第一个是错误对象,第二个是报错的 Promise 实例,它可以用来了解发生错误的环境信息。 + +注意,Node 有计划在未来废除`unhandledRejection`事件。如果 Promise 内部有未捕获的错误,会直接终止进程,并且进程的退出码不为 0。 -Node 有一个`unhandledRejection`事件,专门监听未捕获的`reject`错误。 +再看下面的例子。 ```javascript -process.on('unhandledRejection', function (err, p) { - console.error(err.stack) +const promise = new Promise(function (resolve, reject) { + resolve('ok'); + setTimeout(function () { throw new Error('test') }, 0) }); +promise.then(function (value) { console.log(value) }); +// ok +// Uncaught Error: test ``` -上面代码中,`unhandledRejection`事件的监听函数有两个参数,第一个是错误对象,第二个是报错的Promise实例,它可以用来了解发生错误的环境信息。。 +上面代码中,Promise 指定在下一轮“事件循环”再抛出错误。到了那个时候,Promise 的运行已经结束了,所以这个错误是在 Promise 函数体外抛出的,会冒泡到最外层,成了未捕获的错误。 -需要注意的是,`catch`方法返回的还是一个 Promise 对象,因此后面还可以接着调用`then`方法。 +一般总是建议,Promise 对象后面要跟`catch`方法,这样可以处理 Promise 内部发生的错误。`catch`方法返回的还是一个 Promise 对象,因此后面还可以接着调用`then`方法。 ```javascript -var someAsyncThing = function() { +const someAsyncThing = function() { return new Promise(function(resolve, reject) { // 下面一行会报错,因为x没有声明 resolve(x + 2); @@ -414,7 +449,7 @@ Promise.resolve() `catch`方法之中,还能再抛出错误。 ```javascript -var someAsyncThing = function() { +const someAsyncThing = function() { return new Promise(function(resolve, reject) { // 下面一行会报错,因为x没有声明 resolve(x + 2); @@ -425,7 +460,7 @@ someAsyncThing().then(function() { return someOtherAsyncThing(); }).catch(function(error) { console.log('oh no', error); - // 下面一行会报错,因为y没有声明 + // 下面一行会报错,因为 y 没有声明 y + 2; }).then(function() { console.log('carry on'); @@ -449,17 +484,96 @@ someAsyncThing().then(function() { // carry on [ReferenceError: y is not defined] ``` -上面代码中,第二个`catch`方法用来捕获,前一个`catch`方法抛出的错误。 +上面代码中,第二个`catch`方法用来捕获前一个`catch`方法抛出的错误。 + +## Promise.prototype.finally() + +`finally`方法用于指定不管 Promise 对象最后状态如何,都会执行的操作。该方法是 ES2018 引入标准的。 + +```javascript +promise +.then(result => {···}) +.catch(error => {···}) +.finally(() => {···}); +``` + +上面代码中,不管`promise`最后的状态,在执行完`then`或`catch`指定的回调函数以后,都会执行`finally`方法指定的回调函数。 + +下面是一个例子,服务器使用 Promise 处理请求,然后使用`finally`方法关掉服务器。 + +```javascript +server.listen(port) + .then(function () { + // ... + }) + .finally(server.stop); +``` + +`finally`方法的回调函数不接受任何参数,这意味着没有办法知道,前面的 Promise 状态到底是`fulfilled`还是`rejected`。这表明,`finally`方法里面的操作,应该是与状态无关的,不依赖于 Promise 的执行结果。 + +`finally`本质上是`then`方法的特例。 + +```javascript +promise +.finally(() => { + // 语句 +}); + +// 等同于 +promise +.then( + result => { + // 语句 + return result; + }, + error => { + // 语句 + throw error; + } +); +``` + +上面代码中,如果不使用`finally`方法,同样的语句需要为成功和失败两种情况各写一次。有了`finally`方法,则只需要写一次。 + +它的实现也很简单。 + +```javascript +Promise.prototype.finally = function (callback) { + let P = this.constructor; + return this.then( + value => P.resolve(callback()).then(() => value), + reason => P.resolve(callback()).then(() => { throw reason }) + ); +}; +``` + +上面代码中,不管前面的 Promise 是`fulfilled`还是`rejected`,都会执行回调函数`callback`。 + +从上面的实现还可以看到,`finally`方法总是会返回原来的值。 + +```javascript +// resolve 的值是 undefined +Promise.resolve(2).then(() => {}, () => {}) + +// resolve 的值是 2 +Promise.resolve(2).finally(() => {}) + +// reject 的值是 undefined +Promise.reject(3).then(() => {}, () => {}) + +// reject 的值是 3 +Promise.reject(3).finally(() => {}) +``` ## Promise.all() -`Promise.all`方法用于将多个Promise实例,包装成一个新的Promise实例。 +`Promise.all`方法用于将多个 Promise 实例,包装成一个新的 Promise 实例。 ```javascript -var p = Promise.all([p1, p2, p3]); +const p = Promise.all([p1, p2, p3]); ``` -上面代码中,`Promise.all`方法接受一个数组作为参数,`p1`、`p2`、`p3`都是Promise对象的实例,如果不是,就会先调用下面讲到的`Promise.resolve`方法,将参数转为Promise实例,再进一步处理。(`Promise.all`方法的参数可以不是数组,但必须具有Iterator接口,且返回的每个成员都是Promise实例。) +上面代码中,`Promise.all`方法接受一个数组作为参数,`p1`、`p2`、`p3`都是 Promise 实例,如果不是,就会先调用下面讲到的`Promise.resolve`方法,将参数转为 Promise 实例,再进一步处理。(`Promise.all`方法的参数可以不是数组,但必须具有 Iterator 接口,且返回的每个成员都是 Promise 实例。) `p`的状态由`p1`、`p2`、`p3`决定,分成两种情况。 @@ -471,8 +585,8 @@ var p = Promise.all([p1, p2, p3]); ```javascript // 生成一个Promise对象的数组 -var promises = [2, 3, 5, 7, 11, 13].map(function (id) { - return getJSON("/post/" + id + ".json"); +const promises = [2, 3, 5, 7, 11, 13].map(function (id) { + return getJSON('/post/' + id + ".json"); }); Promise.all(promises).then(function (posts) { @@ -482,7 +596,7 @@ Promise.all(promises).then(function (posts) { }); ``` -上面代码中,`promises`是包含6个Promise实例的数组,只有这6个实例的状态都变成`fulfilled`,或者其中有一个变为`rejected`,才会调用`Promise.all`方法后面的回调函数。 +上面代码中,`promises`是包含 6 个 Promise 实例的数组,只有这 6 个实例的状态都变成`fulfilled`,或者其中有一个变为`rejected`,才会调用`Promise.all`方法后面的回调函数。 下面是另一个例子。 @@ -499,24 +613,66 @@ Promise.all([ booksPromise, userPromise ]) -.then(([books, user]) => pickTopRecommentations(books, user)); +.then(([books, user]) => pickTopRecommendations(books, user)); ``` -上面代码中,`booksPromise`和`userPromise`是两个异步操作,只有等到它们的结果都返回了,才会触发`pickTopRecommentations`这个回调函数。 +上面代码中,`booksPromise`和`userPromise`是两个异步操作,只有等到它们的结果都返回了,才会触发`pickTopRecommendations`这个回调函数。 + +注意,如果作为参数的 Promise 实例,自己定义了`catch`方法,那么它一旦被`rejected`,并不会触发`Promise.all()`的`catch`方法。 + +```javascript +const p1 = new Promise((resolve, reject) => { + resolve('hello'); +}) +.then(result => result) +.catch(e => e); + +const p2 = new Promise((resolve, reject) => { + throw new Error('报错了'); +}) +.then(result => result) +.catch(e => e); + +Promise.all([p1, p2]) +.then(result => console.log(result)) +.catch(e => console.log(e)); +// ["hello", Error: 报错了] +``` + +上面代码中,`p1`会`resolved`,`p2`首先会`rejected`,但是`p2`有自己的`catch`方法,该方法返回的是一个新的 Promise 实例,`p2`指向的实际上是这个实例。该实例执行完`catch`方法后,也会变成`resolved`,导致`Promise.all()`方法参数里面的两个实例都会`resolved`,因此会调用`then`方法指定的回调函数,而不会调用`catch`方法指定的回调函数。 + +如果`p2`没有自己的`catch`方法,就会调用`Promise.all()`的`catch`方法。 + +```javascript +const p1 = new Promise((resolve, reject) => { + resolve('hello'); +}) +.then(result => result); + +const p2 = new Promise((resolve, reject) => { + throw new Error('报错了'); +}) +.then(result => result); + +Promise.all([p1, p2]) +.then(result => console.log(result)) +.catch(e => console.log(e)); +// Error: 报错了 +``` ## Promise.race() -`Promise.race`方法同样是将多个Promise实例,包装成一个新的Promise实例。 +`Promise.race`方法同样是将多个 Promise 实例,包装成一个新的 Promise 实例。 ```javascript -var p = Promise.race([p1, p2, p3]); +const p = Promise.race([p1, p2, p3]); ``` 上面代码中,只要`p1`、`p2`、`p3`之中有一个实例率先改变状态,`p`的状态就跟着改变。那个率先改变的 Promise 实例的返回值,就传递给`p`的回调函数。 `Promise.race`方法的参数与`Promise.all`方法一样,如果不是 Promise 实例,就会先调用下面讲到的`Promise.resolve`方法,将参数转为 Promise 实例,再进一步处理。 -下面是一个例子,如果指定时间内没有获得结果,就将Promise的状态变为`reject`,否则变为`resolve`。 +下面是一个例子,如果指定时间内没有获得结果,就将 Promise 的状态变为`reject`,否则变为`resolve`。 ```javascript const p = Promise.race([ @@ -525,21 +681,23 @@ const p = Promise.race([ setTimeout(() => reject(new Error('request timeout')), 5000) }) ]); -p.then(response => console.log(response)); -p.catch(error => console.log(error)); + +p +.then(console.log) +.catch(console.error); ``` -上面代码中,如果5秒之内`fetch`方法无法返回结果,变量`p`的状态就会变为`rejected`,从而触发`catch`方法指定的回调函数。 +上面代码中,如果 5 秒之内`fetch`方法无法返回结果,变量`p`的状态就会变为`rejected`,从而触发`catch`方法指定的回调函数。 ## Promise.resolve() -有时需要将现有对象转为Promise对象,`Promise.resolve`方法就起到这个作用。 +有时需要将现有对象转为 Promise 对象,`Promise.resolve`方法就起到这个作用。 ```javascript -var jsPromise = Promise.resolve($.ajax('/whatever.json')); +const jsPromise = Promise.resolve($.ajax('/whatever.json')); ``` -上面代码将jQuery生成的`deferred`对象,转为一个新的Promise对象。 +上面代码将 jQuery 生成的`deferred`对象,转为一个新的 Promise 对象。 `Promise.resolve`等价于下面的写法。 @@ -551,9 +709,9 @@ new Promise(resolve => resolve('foo')) `Promise.resolve`方法的参数分成四种情况。 -**(1)参数是一个Promise实例** +**(1)参数是一个 Promise 实例** -如果参数是Promise实例,那么`Promise.resolve`将不做任何修改、原封不动地返回这个实例。 +如果参数是 Promise 实例,那么`Promise.resolve`将不做任何修改、原封不动地返回这个实例。 **(2)参数是一个`thenable`对象** @@ -567,7 +725,7 @@ let thenable = { }; ``` -`Promise.resolve`方法会将这个对象转为Promise对象,然后就立即执行`thenable`对象的`then`方法。 +`Promise.resolve`方法会将这个对象转为 Promise 对象,然后就立即执行`thenable`对象的`then`方法。 ```javascript let thenable = { @@ -582,14 +740,14 @@ p1.then(function(value) { }); ``` -上面代码中,`thenable`对象的`then`方法执行后,对象`p1`的状态就变为`resolved`,从而立即执行最后那个`then`方法指定的回调函数,输出42。 +上面代码中,`thenable`对象的`then`方法执行后,对象`p1`的状态就变为`resolved`,从而立即执行最后那个`then`方法指定的回调函数,输出 42。 **(3)参数不是具有`then`方法的对象,或根本就不是对象** -如果参数是一个原始值,或者是一个不具有`then`方法的对象,则`Promise.resolve`方法返回一个新的Promise对象,状态为`Resolved`。 +如果参数是一个原始值,或者是一个不具有`then`方法的对象,则`Promise.resolve`方法返回一个新的 Promise 对象,状态为`resolved`。 ```javascript -var p = Promise.resolve('Hello'); +const p = Promise.resolve('Hello'); p.then(function (s){ console.log(s) @@ -597,25 +755,25 @@ p.then(function (s){ // Hello ``` -上面代码生成一个新的Promise对象的实例`p`。由于字符串`Hello`不属于异步操作(判断方法是它不是具有then方法的对象),返回Promise实例的状态从一生成就是`Resolved`,所以回调函数会立即执行。`Promise.resolve`方法的参数,会同时传给回调函数。 +上面代码生成一个新的 Promise 对象的实例`p`。由于字符串`Hello`不属于异步操作(判断方法是字符串对象不具有 then 方法),返回 Promise 实例的状态从一生成就是`resolved`,所以回调函数会立即执行。`Promise.resolve`方法的参数,会同时传给回调函数。 **(4)不带有任何参数** -`Promise.resolve`方法允许调用时不带参数,直接返回一个`Resolved`状态的Promise对象。 +`Promise.resolve`方法允许调用时不带参数,直接返回一个`resolved`状态的 Promise 对象。 -所以,如果希望得到一个Promise对象,比较方便的方法就是直接调用`Promise.resolve`方法。 +所以,如果希望得到一个 Promise 对象,比较方便的方法就是直接调用`Promise.resolve`方法。 ```javascript -var p = Promise.resolve(); +const p = Promise.resolve(); p.then(function () { // ... }); ``` -上面代码的变量`p`就是一个Promise对象。 +上面代码的变量`p`就是一个 Promise 对象。 -需要注意的是,立即`resolve`的Promise对象,是在本轮“事件循环”(event loop)的结束时,而不是在下一轮“事件循环”的开始时。 +需要注意的是,立即`resolve`的 Promise 对象,是在本轮“事件循环”(event loop)的结束时,而不是在下一轮“事件循环”的开始时。 ```javascript setTimeout(function () { @@ -633,16 +791,16 @@ console.log('one'); // three ``` -上面代码中,`setTimeout(fn, 0)`在下一轮“事件循环”开始时执行,`Promise.resolve()`在本轮“事件循环”结束时执行,`console.log(’one‘)`则是立即执行,因此最先输出。 +上面代码中,`setTimeout(fn, 0)`在下一轮“事件循环”开始时执行,`Promise.resolve()`在本轮“事件循环”结束时执行,`console.log('one')`则是立即执行,因此最先输出。 ## Promise.reject() `Promise.reject(reason)`方法也会返回一个新的 Promise 实例,该实例的状态为`rejected`。 ```javascript -var p = Promise.reject('出错了'); +const p = Promise.reject('出错了'); // 等同于 -var p = new Promise((resolve, reject) => reject('出错了')) +const p = new Promise((resolve, reject) => reject('出错了')) p.then(null, function (s) { console.log(s) @@ -650,7 +808,7 @@ p.then(null, function (s) { // 出错了 ``` -上面代码生成一个Promise对象的实例`p`,状态为`rejected`,回调函数会立即执行。 +上面代码生成一个 Promise 对象的实例`p`,状态为`rejected`,回调函数会立即执行。 注意,`Promise.reject()`方法的参数,会原封不动地作为`reject`的理由,变成后续方法的参数。这一点与`Promise.resolve`方法不一致。 @@ -670,64 +828,6 @@ Promise.reject(thenable) 上面代码中,`Promise.reject`方法的参数是一个`thenable`对象,执行以后,后面`catch`方法的参数不是`reject`抛出的“出错了”这个字符串,而是`thenable`对象。 -## 两个有用的附加方法 - -ES6的Promise API提供的方法不是很多,有些有用的方法可以自己部署。下面介绍如何部署两个不在ES6之中、但很有用的方法。 - -### done() - -Promise对象的回调链,不管以`then`方法或`catch`方法结尾,要是最后一个方法抛出错误,都有可能无法捕捉到(因为Promise内部的错误不会冒泡到全局)。因此,我们可以提供一个`done`方法,总是处于回调链的尾端,保证抛出任何可能出现的错误。 - -```javascript -asyncFunc() - .then(f1) - .catch(r1) - .then(f2) - .done(); -``` - -它的实现代码相当简单。 - -```javascript -Promise.prototype.done = function (onFulfilled, onRejected) { - this.then(onFulfilled, onRejected) - .catch(function (reason) { - // 抛出一个全局错误 - setTimeout(() => { throw reason }, 0); - }); -}; -``` - -从上面代码可见,`done`方法的使用,可以像`then`方法那样用,提供`Fulfilled`和`Rejected`状态的回调函数,也可以不提供任何参数。但不管怎样,`done`都会捕捉到任何可能出现的错误,并向全局抛出。 - -### finally() - -`finally`方法用于指定不管Promise对象最后状态如何,都会执行的操作。它与`done`方法的最大区别,它接受一个普通的回调函数作为参数,该函数不管怎样都必须执行。 - -下面是一个例子,服务器使用Promise处理请求,然后使用`finally`方法关掉服务器。 - -```javascript -server.listen(0) - .then(function () { - // run test - }) - .finally(server.stop); -``` - -它的实现也很简单。 - -```javascript -Promise.prototype.finally = function (callback) { - let P = this.constructor; - return this.then( - value => P.resolve(callback()).then(() => value), - reason => P.resolve(callback()).then(() => { throw reason }) - ); -}; -``` - -上面代码中,不管前面的Promise是`fulfilled`还是`rejected`,都会执行回调函数`callback`。 - ## 应用 ### 加载图片 @@ -737,7 +837,7 @@ Promise.prototype.finally = function (callback) { ```javascript const preloadImage = function (path) { return new Promise(function (resolve, reject) { - var image = new Image(); + const image = new Image(); image.onload = resolve; image.onerror = reject; image.src = path; @@ -745,9 +845,9 @@ const preloadImage = function (path) { }; ``` -### Generator函数与Promise的结合 +### Generator 函数与 Promise 的结合 -使用Generator函数管理流程,遇到异步操作的时候,通常返回一个`Promise`对象。 +使用 Generator 函数管理流程,遇到异步操作的时候,通常返回一个`Promise`对象。 ```javascript function getFoo () { @@ -756,9 +856,9 @@ function getFoo () { }); } -var g = function* () { +const g = function* () { try { - var foo = yield getFoo(); + const foo = yield getFoo(); console.log(foo); } catch (e) { console.log(e); @@ -766,7 +866,7 @@ var g = function* () { }; function run (generator) { - var it = generator(); + const it = generator(); function go(result) { if (result.done) return result.value; @@ -784,7 +884,7 @@ function run (generator) { run(g); ``` -上面代码的Generator函数`g`之中,有一个异步操作`getFoo`,它返回的就是一个`Promise`对象。函数`run`用来处理这个`Promise`对象,并调用下一个`next`方法。 +上面代码的 Generator 函数`g`之中,有一个异步操作`getFoo`,它返回的就是一个`Promise`对象。函数`run`用来处理这个`Promise`对象,并调用下一个`next`方法。 ## Promise.try() @@ -893,10 +993,9 @@ try { 上面这样的写法就很笨拙了,这时就可以统一用`promise.catch()`捕获所有同步和异步的错误。 ```javascript -Promise.try(database.users.get({id: userId})) +Promise.try(() => database.users.get({id: userId})) .then(...) .catch(...) ``` 事实上,`Promise.try`就是模拟`try`代码块,就像`promise.catch`模拟的是`catch`代码块。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/proposals.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/proposals.md" new file mode 100755 index 000000000..d6c27598a --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/proposals.md" @@ -0,0 +1,789 @@ +# 最新提案 + +本章介绍一些尚未进入标准、但很有希望的最新提案。 + +## do 表达式 + +本质上,块级作用域是一个语句,将多个操作封装在一起,没有返回值。 + +```javascript +{ + let t = f(); + t = t * t + 1; +} +``` + +上面代码中,块级作用域将两个语句封装在一起。但是,在块级作用域以外,没有办法得到`t`的值,因为块级作用域不返回值,除非`t`是全局变量。 + +现在有一个[提案](https://github.com/tc39/proposal-do-expressions),使得块级作用域可以变为表达式,也就是说可以返回值,办法就是在块级作用域之前加上`do`,使它变为`do`表达式,然后就会返回内部最后执行的表达式的值。 + +```javascript +let x = do { + let t = f(); + t * t + 1; +}; +``` + +上面代码中,变量`x`会得到整个块级作用域的返回值(`t * t + 1`)。 + +`do`表达式的逻辑非常简单:封装的是什么,就会返回什么。 + +```javascript +// 等同于 <表达式> +do { <表达式>; } + +// 等同于 <语句> +do { <语句> } +``` + +`do`表达式的好处是可以封装多个语句,让程序更加模块化,就像乐高积木那样一块块拼装起来。 + +```javascript +let x = do { + if (foo()) { f() } + else if (bar()) { g() } + else { h() } +}; +``` + +上面代码的本质,就是根据函数`foo`的执行结果,调用不同的函数,将返回结果赋给变量`x`。使用`do`表达式,就将这个操作的意图表达得非常简洁清晰。而且,`do`块级作用域提供了单独的作用域,内部操作可以与全局作用域隔绝。 + +值得一提的是,`do`表达式在 JSX 语法中非常好用。 + +```javascript +return ( + +) +``` + +上面代码中,如果不用`do`表达式,就只能用三元判断运算符(`?:`)。那样的话,一旦判断逻辑复杂,代码就会变得很不易读。 + +## throw 表达式 + +JavaScript 语法规定`throw`是一个命令,用来抛出错误,不能用于表达式之中。 + +```javascript +// 报错 +console.log(throw new Error()); +``` + +上面代码中,`console.log`的参数必须是一个表达式,如果是一个`throw`语句就会报错。 + +现在有一个[提案](https://github.com/tc39/proposal-throw-expressions),允许`throw`用于表达式。 + +```javascript +// 参数的默认值 +function save(filename = throw new TypeError("Argument required")) { +} + +// 箭头函数的返回值 +lint(ast, { + with: () => throw new Error("avoid using 'with' statements.") +}); + +// 条件表达式 +function getEncoder(encoding) { + const encoder = encoding === "utf8" ? + new UTF8Encoder() : + encoding === "utf16le" ? + new UTF16Encoder(false) : + encoding === "utf16be" ? + new UTF16Encoder(true) : + throw new Error("Unsupported encoding"); +} + +// 逻辑表达式 +class Product { + get id() { + return this._id; + } + set id(value) { + this._id = value || throw new Error("Invalid value"); + } +} +``` + +上面代码中,`throw`都出现在表达式里面。 + +语法上,`throw`表达式里面的`throw`不再是一个命令,而是一个运算符。为了避免与`throw`命令混淆,规定`throw`出现在行首,一律解释为`throw`语句,而不是`throw`表达式。 + +## 链判断运算符 + +编程实务中,如果读取对象内部的某个属性,往往需要判断一下该对象是否存在。比如,要读取`message.body.user.firstName`,安全的写法是写成下面这样。 + +```javascript +const firstName = (message + && message.body + && message.body.user + && message.body.user.firstName) || 'default'; +``` + +这样的层层判断非常麻烦,因此现在有一个[提案](https://github.com/tc39/proposal-optional-chaining),引入了“链判断运算符”(optional chaining operator)`?.`,简化上面的写法。 + +```javascript +const firstName = message?.body?.user?.firstName || 'default'; +``` + +上面代码有三个`?.`运算符,直接在链式调用的时候判断,左侧的对象是否为`null`或`undefined`。如果是的,就不再往下运算,而是返回`undefined`。 + +链判断运算符号有三种用法。 + +- `obj?.prop` // 读取对象属性 +- `obj?.[expr]` // 同上 +- `func?.(...args)` // 函数或对象方法的调用 + +下面是判断函数是否存在的例子。 + +```javascript +iterator.return?.() +``` + +上面代码中,`iterator.return`如果有定义,就会调用该方法,否则直接返回`undefined`。 + +下面是更多的例子。 + +```javascript +a?.b +// 等同于 +a == null ? undefined : a.b + +a?.[x] +// 等同于 +a == null ? undefined : a[x] + +a?.b() +// 等同于 +a == null ? undefined : a.b() + +a?.() +// 等同于 +a == null ? undefined : a() +``` + +使用这个运算符,有几个注意点。 + +(1)短路机制 + +```javascript +a?.[++x] +// 等同于 +a == null ? undefined : a[++x] +``` + +上面代码中,如果`a`是`undefined`或`null`,那么`x`不会进行递增运算。也就是说,链判断运算符一旦为真,右侧的表达式就不再求值。 + +(2)delete 运算符 + +```javascript +delete a?.b +// 等同于 +a == null ? undefined : delete a.b +``` + +上面代码中,如果`a`是`undefined`或`null`,会直接返回`undefined`,而不会进行`delete`运算。 + +(3)报错场合 + +以下写法是禁止,会报错。 + +```javascript +// 构造函数判断 +new a?.() + +// 运算符右侧是模板字符串 +a?.`{b}` + +// 链判断运算符前后有构造函数或模板字符串 +new a?.b() +a?.b`{c}` + +// 链运算符用于赋值运算符左侧 +a?.b = c +``` + +(4)右侧不得为十进制数值 + +为了保证兼容以前的代码,允许`foo?.3:0`被解析成`foo ? .3 : 0`,因此规定如果`?.`后面紧跟一个十进制数字,那么`?.`不再被看成是一个完整的运算符,而会按照三元运算符进行处理,也就是说,那个小数点会归属于后面的十进制数字,形成一个小数。 + +## 直接输入 U+2028 和 U+2029 + +JavaScript 字符串允许直接输入字符,以及输入字符的转义形式。举例来说,“中”的 Unicode 码点是 U+4e2d,你可以直接在字符串里面输入这个汉字,也可以输入它的转义形式`\u4e2d`,两者是等价的。 + +```javascript +'中' === '\u4e2d' // true +``` + +但是,JavaScript 规定有5个字符,不能在字符串里面直接使用,只能使用转义形式。 + +- U+005C:反斜杠(reverse solidus) +- U+000D:回车(carriage return) +- U+2028:行分隔符(line separator) +- U+2029:段分隔符(paragraph separator) +- U+000A:换行符(line feed) + +举例来说,字符串里面不能直接包含反斜杠,一定要转义写成`\\`或者`\u005c`。 + +这个规定本身没有问题,麻烦在于 JSON 格式允许字符串里面直接使用 U+2028(行分隔符)和 U+2029(段分隔符)。这样一来,服务器输出的 JSON 被`JSON.parse`解析,就有可能直接报错。 + +JSON 格式已经冻结(RFC 7159),没法修改了。为了消除这个报错,现在有一个[提案](https://github.com/tc39/proposal-json-superset),允许 JavaScript 字符串直接输入 U+2028(行分隔符)和 U+2029(段分隔符)。 + +```javascript +const PS = eval("'\u2029'"); +``` + +根据这个提案,上面的代码不会报错。 + +注意,模板字符串现在就允许直接输入这两个字符。另外,正则表达式依然不允许直接输入这两个字符,这是没有问题的,因为 JSON 本来就不允许直接包含正则表达式。 + +## 函数的部分执行 + +### 语法 + +多参数的函数有时需要绑定其中的一个或多个参数,然后返回一个新函数。 + +```javascript +function add(x, y) { return x + y; } +function add7(x) { return x + 7; } +``` + +上面代码中,`add7`函数其实是`add`函数的一个特殊版本,通过将一个参数绑定为`7`,就可以从`add`得到`add7`。 + +```javascript +// bind 方法 +const add7 = add.bind(null, 7); + +// 箭头函数 +const add7 = x => add(x, 7); +``` + +上面两种写法都有些冗余。其中,`bind`方法的局限更加明显,它必须提供`this`,并且只能从前到后一个个绑定参数,无法只绑定非头部的参数。 + +现在有一个[提案](https://github.com/tc39/proposal-partial-application),使得绑定参数并返回一个新函数更加容易。这叫做函数的部分执行(partial application)。 + +```javascript +const add = (x, y) => x + y; +const addOne = add(1, ?); + +const maxGreaterThanZero = Math.max(0, ...); +``` + +根据新提案,`?`是单个参数的占位符,`...`是多个参数的占位符。以下的形式都属于函数的部分执行。 + +```javascript +f(x, ?) +f(x, ...) +f(?, x) +f(..., x) +f(?, x, ?) +f(..., x, ...) +``` + +`?`和`...`只能出现在函数的调用之中,并且会返回一个新函数。 + +```javascript +const g = f(?, 1, ...); +// 等同于 +const g = (x, ...y) => f(x, 1, ...y); +``` + +函数的部分执行,也可以用于对象的方法。 + +```javascript +let obj = { + f(x, y) { return x + y; }, +}; + +const g = obj.f(?, 3); +g(1) // 4 +``` + +### 注意点 + +函数的部分执行有一些特别注意的地方。 + +(1)函数的部分执行是基于原函数的。如果原函数发生变化,部分执行生成的新函数也会立即反映这种变化。 + +```javascript +let f = (x, y) => x + y; + +const g = f(?, 3); +g(1); // 4 + +// 替换函数 f +f = (x, y) => x * y; + +g(1); // 3 +``` + +上面代码中,定义了函数的部分执行以后,更换原函数会立即影响到新函数。 + +(2)如果预先提供的那个值是一个表达式,那么这个表达式并不会在定义时求值,而是在每次调用时求值。 + +```javascript +let a = 3; +const f = (x, y) => x + y; + +const g = f(?, a); +g(1); // 4 + +// 改变 a 的值 +a = 10; +g(1); // 11 +``` + +上面代码中,预先提供的参数是变量`a`,那么每次调用函数`g`的时候,才会对`a`进行求值。 + +(3)如果新函数的参数多于占位符的数量,那么多余的参数将被忽略。 + +```javascript +const f = (x, ...y) => [x, ...y]; +const g = f(?, 1); +g(2, 3, 4); // [2, 1] +``` + +上面代码中,函数`g`只有一个占位符,也就意味着它只能接受一个参数,多余的参数都会被忽略。 + +写成下面这样,多余的参数就没有问题。 + +```javascript +const f = (x, ...y) => [x, ...y]; +const g = f(?, 1, ...); +g(2, 3, 4); // [2, 1, 3, 4]; +``` + +(4)`...`只会被采集一次,如果函数的部分执行使用了多个`...`,那么每个`...`的值都将相同。 + +```javascript +const f = (...x) => x; +const g = f(..., 9, ...); +g(1, 2, 3); // [1, 2, 3, 9, 1, 2, 3] +``` + +上面代码中,`g`定义了两个`...`占位符,真正执行的时候,它们的值是一样的。 + +## 管道运算符 + +Unix 操作系统有一个管道机制(pipeline),可以把前一个操作的值传给后一个操作。这个机制非常有用,使得简单的操作可以组合成为复杂的操作。许多语言都有管道的实现,现在有一个[提案](https://github.com/tc39/proposal-pipeline-operator),让 JavaScript 也拥有管道机制。 + +JavaScript 的管道是一个运算符,写作`|>`。它的左边是一个表达式,右边是一个函数。管道运算符把左边表达式的值,传入右边的函数进行求值。 + +```javascript +x |> f +// 等同于 +f(x) +``` + +管道运算符最大的好处,就是可以把嵌套的函数,写成从左到右的链式表达式。 + +```javascript +function doubleSay (str) { + return str + ", " + str; +} + +function capitalize (str) { + return str[0].toUpperCase() + str.substring(1); +} + +function exclaim (str) { + return str + '!'; +} +``` + +上面是三个简单的函数。如果要嵌套执行,传统的写法和管道的写法分别如下。 + +```javascript +// 传统的写法 +exclaim(capitalize(doubleSay('hello'))) +// "Hello, hello!" + +// 管道的写法 +'hello' + |> doubleSay + |> capitalize + |> exclaim +// "Hello, hello!" +``` + +管道运算符只能传递一个值,这意味着它右边的函数必须是一个单参数函数。如果是多参数函数,就必须进行柯里化,改成单参数的版本。 + +```javascript +function double (x) { return x + x; } +function add (x, y) { return x + y; } + +let person = { score: 25 }; +person.score + |> double + |> (_ => add(7, _)) +// 57 +``` + +上面代码中,`add`函数需要两个参数。但是,管道运算符只能传入一个值,因此需要事先提供另一个参数,并将其改成单参数的箭头函数`_ => add(7, _)`。这个函数里面的下划线并没有特别的含义,可以用其他符号代替,使用下划线只是因为,它能够形象地表示这里是占位符。 + +管道运算符对于`await`函数也适用。 + +```javascript +x |> await f +// 等同于 +await f(x) + +const userAge = userId |> await fetchUserById |> getAgeFromUser; +// 等同于 +const userAge = getAgeFromUser(await fetchUserById(userId)); +``` + +## 数值分隔符 + +欧美语言中,较长的数值允许每三位添加一个分隔符(通常是一个逗号),增加数值的可读性。比如,`1000`可以写作`1,000`。 + +现在有一个[提案](https://github.com/tc39/proposal-numeric-separator),允许 JavaScript 的数值使用下划线(`_`)作为分隔符。 + +```javascript +let budget = 1_000_000_000_000; +budget === 10 ** 12 // true +``` + +JavaScript 的数值分隔符没有指定间隔的位数,也就是说,可以每三位添加一个分隔符,也可以每一位、每两位、每四位添加一个。 + +```javascript +123_00 === 12_300 // true + +12345_00 === 123_4500 // true +12345_00 === 1_234_500 // true +``` + +小数和科学计数法也可以使用数值分隔符。 + +```javascript +// 小数 +0.000_001 +// 科学计数法 +1e10_000 +``` + +数值分隔符有几个使用注意点。 + +- 不能在数值的最前面(leading)或最后面(trailing)。 +- 不能两个或两个以上的分隔符连在一起。 +- 小数点的前后不能有分隔符。 +- 科学计数法里面,表示指数的`e`或`E`前后不能有分隔符。 + +下面的写法都会报错。 + +```javascript +// 全部报错 +3_.141 +3._141 +1_e12 +1e_12 +123__456 +_1464301 +1464301_ +``` + +除了十进制,其他进制的数值也可以使用分隔符。 + +```javascript +// 二进制 +0b1010_0001_1000_0101 +// 十六进制 +0xA0_B0_C0 +``` + +注意,分隔符不能紧跟着进制的前缀`0b`、`0B`、`0o`、`0O`、`0x`、`0X`。 + +```javascript +// 报错 +0_b111111000 +0b_111111000 +``` + +下面三个将字符串转成数值的函数,不支持数值分隔符。主要原因是提案的设计者认为,数值分隔符主要是为了编码时书写数值的方便,而不是为了处理外部输入的数据。 + +- Number() +- parseInt() +- parseFloat() + +```javascript +Number('123_456') // NaN +parseInt('123_456') // 123 +``` + +## BigInt 数据类型 + +### 简介 + +JavaScript 所有数字都保存成 64 位浮点数,这给数值的表示带来了两大限制。一是数值的精度只能到 53 个二进制位(相当于 16 个十进制位),大于这个范围的整数,JavaScript 是无法精确表示的,这使得 JavaScript 不适合进行科学和金融方面的精确计算。二是大于或等于2的1024次方的数值,JavaScript 无法表示,会返回`Infinity`。 + +```javascript +// 超过 53 个二进制位的数值,无法保持精度 +Math.pow(2, 53) === Math.pow(2, 53) + 1 // true + +// 超过 2 的 1024 次方的数值,无法表示 +Math.pow(2, 1024) // Infinity +``` + +现在有一个[提案](https://github.com/tc39/proposal-bigint),引入了一种新的数据类型 BigInt(大整数),来解决这个问题。BigInt 只用来表示整数,没有位数的限制,任何位数的整数都可以精确表示。 + +```javascript +const a = 2172141653n; +const b = 15346349309n; + +// BigInt 可以保持精度 +a * b // 33334444555566667777n + +// 普通整数无法保持精度 +Number(a) * Number(b) // 33334444555566670000 +``` + +为了与 Number 类型区别,BigInt 类型的数据必须添加后缀`n`。 + +```javascript +1234 // 普通整数 +1234n // BigInt + +// BigInt 的运算 +1n + 2n // 3n +``` + +BigInt 同样可以使用各种进制表示,都要加上后缀`n`。 + +```javascript +0b1101n // 二进制 +0o777n // 八进制 +0xFFn // 十六进制 +``` + +BigInt 与普通整数是两种值,它们之间并不相等。 + +```javascript +42n === 42 // false +``` + +`typeof`运算符对于 BigInt 类型的数据返回`bigint`。 + +```javascript +typeof 123n // 'bigint' +``` + +BigInt 可以使用负号(`-`),但是不能使用正号(`+`),因为会与 asm.js 冲突。 + +```javascript +-42n // 正确 ++42n // 报错 +``` + +### BigInt 对象 + +JavaScript 原生提供`BigInt`对象,可以用作构造函数生成 BigInt 类型的数值。转换规则基本与`Number()`一致,将其他类型的值转为 BigInt。 + +```javascript +BigInt(123) // 123n +BigInt('123') // 123n +BigInt(false) // 0n +BigInt(true) // 1n +``` + +`BigInt()`构造函数必须有参数,而且参数必须可以正常转为数值,下面的用法都会报错。 + +```javascript +new BigInt() // TypeError +BigInt(undefined) //TypeError +BigInt(null) // TypeError +BigInt('123n') // SyntaxError +BigInt('abc') // SyntaxError +``` + +上面代码中,尤其值得注意字符串`123n`无法解析成 Number 类型,所以会报错。 + +参数如果是小数,也会报错。 + +```javascript +BigInt(1.5) // RangeError +BigInt('1.5') // SyntaxError +``` + +BigInt 对象继承了 Object 提供的实例方法。 + +- `BigInt.prototype.toLocaleString()` +- `BigInt.prototype.toString()` +- `BigInt.prototype.valueOf()` + +此外,还提供了三个静态方法。 + +- `BigInt.asUintN(width, BigInt)`: 给定的 BigInt 转为 0 到 2width - 1 之间对应的值。 +- `BigInt.asIntN(width, BigInt)`:给定的 BigInt 转为 -2width - 1 到 2width - 1 - 1 之间对应的值。 +- `BigInt.parseInt(string[, radix])`:近似于`Number.parseInt()`,将一个字符串转换成指定进制的 BigInt。 + +```javascript +const max = 2n ** (64n - 1n) - 1n; + +BigInt.asIntN(64, max) +// 9223372036854775807n +BigInt.asIntN(64, max + 1n) +// -9223372036854775808n +BigInt.asUintN(64, max + 1n) +// 9223372036854775808n +``` + +上面代码中,`max`是64位带符号的 BigInt 所能表示的最大值。如果对这个值加`1n`,`BigInt.asIntN()`将会返回一个负值,因为这时新增的一位将被解释为符号位。而`BigInt.asUintN()`方法由于不存在符号位,所以可以正确返回结果。 + +如果`BigInt.asIntN()`和`BigInt.asUintN()`指定的位数,小于数值本身的位数,那么头部的位将被舍弃。 + +```javascript +const max = 2n ** (64n - 1n) - 1n; + +BigInt.asIntN(32, max) // -1n +BigInt.asUintN(32, max) // 4294967295n +``` + +上面代码中,`max`是一个64位的 BigInt,如果转为32位,前面的32位都会被舍弃。 + +下面是`BigInt.parseInt()`的例子。 + +```javascript +// Number.parseInt() 与 BigInt.parseInt() 的对比 +Number.parseInt('9007199254740993', 10) +// 9007199254740992 +BigInt.parseInt('9007199254740993', 10) +// 9007199254740993n +``` + +上面代码中,由于有效数字超出了最大限度,`Number.parseInt`方法返回的结果是不精确的,而`BigInt.parseInt`方法正确返回了对应的 BigInt。 + +对于二进制数组,BigInt 新增了两个类型`BigUint64Array`和`BigInt64Array`,这两种数据类型返回的都是64位 BigInt。`DataView`对象的实例方法`DataView.prototype.getBigInt64()`和`DataView.prototype.getBigUint64()`,返回的也是 BigInt。 + +### 转换规则 + +可以使用`Boolean()`、`Number()`和`String()`这三个方法,将 BigInt 可以转为布尔值、数值和字符串类型。 + +```javascript +Boolean(0n) // false +Boolean(1n) // true +Number(1n) // 1 +String(1n) // "1" +``` + +上面代码中,注意最后一个例子,转为字符串时后缀`n`会消失。 + +另外,取反运算符(`!`)也可以将 BigInt 转为布尔值。 + +```javascript +!0n // true +!1n // false +``` + +### 数学运算 + +数学运算方面,BigInt 类型的`+`、`-`、`*`和`**`这四个二元运算符,与 Number 类型的行为一致。除法运算`/`会舍去小数部分,返回一个整数。 + +```javascript +9n / 5n +// 1n +``` + +几乎所有的数值运算符都可以用在 BigInt,但是有两个例外。 + +- 不带符号的右移位运算符`>>>` +- 一元的求正运算符`+` + +上面两个运算符用在 BigInt 会报错。前者是因为`>>>`运算符是不带符号的,但是 BigInt 总是带有符号的,导致该运算无意义,完全等同于右移运算符`>>`。后者是因为一元运算符`+`在 asm.js 里面总是返回 Number 类型,为了不破坏 asm.js 就规定`+1n`会报错。 + +BigInt 不能与普通数值进行混合运算。 + +```javascript +1n + 1.3 // 报错 +``` + +上面代码报错是因为无论返回的是 BigInt 或 Number,都会导致丢失精度信息。比如`(2n**53n + 1n) + 0.5`这个表达式,如果返回 BigInt 类型,`0.5`这个小数部分会丢失;如果返回 Number 类型,有效精度只能保持 53 位,导致精度下降。 + +同样的原因,如果一个标准库函数的参数预期是 Number 类型,但是得到的是一个 BigInt,就会报错。 + +```javascript +// 错误的写法 +Math.sqrt(4n) // 报错 + +// 正确的写法 +Math.sqrt(Number(4n)) // 2 +``` + +上面代码中,`Math.sqrt`的参数预期是 Number 类型,如果是 BigInt 就会报错,必须先用`Number`方法转一下类型,才能进行计算。 + +asm.js 里面,`|0`跟在一个数值的后面会返回一个32位整数。根据不能与 Number 类型混合运算的规则,BigInt 如果与`|0`进行运算会报错。 + +```javascript +1n | 0 // 报错 +``` + +### 其他运算 + +BigInt 对应的布尔值,与 Number 类型一致,即`0n`会转为`false`,其他值转为`true`。 + +```javascript +if (0n) { + console.log('if'); +} else { + console.log('else'); +} +// else +``` + +上面代码中,`0n`对应`false`,所以会进入`else`子句。 + +比较运算符(比如`>`)和相等运算符(`==`)允许 BigInt 与其他类型的值混合计算,因为这样做不会损失精度。 + +```javascript +0n < 1 // true +0n < true // true +0n == 0 // true +0n == false // true +0n === 0 // false +``` + +BigInt 与字符串混合运算时,会先转为字符串,再进行运算。 + +```javascript +'' + 123n // "123" +``` + +## Math.signbit() + +`Math.sign()`用来判断一个值的正负,但是如果参数是`-0`,它会返回`-0`。 + +```javascript +Math.sign(-0) // -0 +``` + +这导致对于判断符号位的正负,`Math.sign()`不是很有用。JavaScript 内部使用 64 位浮点数(国际标准 IEEE 754)表示数值,IEEE 754 规定第一位是符号位,`0`表示正数,`1`表示负数。所以会有两种零,`+0`是符号位为`0`时的零值,`-0`是符号位为`1`时的零值。实际编程中,判断一个值是`+0`还是`-0`非常麻烦,因为它们是相等的。 + +```javascript ++0 === -0 // true +``` + +目前,有一个[提案](http://jfbastien.github.io/papers/Math.signbit.html),引入了`Math.signbit()`方法判断一个数的符号位是否设置了。 + +```javascript +Math.signbit(2) //false +Math.signbit(-2) //true +Math.signbit(0) //false +Math.signbit(-0) //true +``` + +可以看到,该方法正确返回了`-0`的符号位是设置了的。 + +该方法的算法如下。 + +- 如果参数是`NaN`,返回`false` +- 如果参数是`-0`,返回`true` +- 如果参数是负值,返回`true` +- 其他情况返回`false` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/proxy.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/proxy.md" old mode 100644 new mode 100755 similarity index 75% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/proxy.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/proxy.md" index 790bd6adc..a9b1d4ddd --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/proxy.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/proxy.md" @@ -116,70 +116,28 @@ var fproxy = new Proxy(function(x, y) { }, handler); fproxy(1, 2) // 1 -new fproxy(1,2) // {value: 2} +new fproxy(1, 2) // {value: 2} fproxy.prototype === Object.prototype // true -fproxy.foo // "Hello, foo" +fproxy.foo === "Hello, foo" // true ``` -下面是 Proxy 支持的拦截操作一览。 - 对于可以设置、但没有设置拦截的操作,则直接落在目标对象上,按照原先的方式产生结果。 -**(1)get(target, propKey, receiver)** - -拦截对象属性的读取,比如`proxy.foo`和`proxy['foo']`。 - -最后一个参数`receiver`是一个对象,可选,参见下面`Reflect.get`的部分。 - -**(2)set(target, propKey, value, receiver)** - -拦截对象属性的设置,比如`proxy.foo = v`或`proxy['foo'] = v`,返回一个布尔值。 - -**(3)has(target, propKey)** - -拦截`propKey in proxy`的操作,返回一个布尔值。 - -**(4)deleteProperty(target, propKey)** - -拦截`delete proxy[propKey]`的操作,返回一个布尔值。 - -**(5)ownKeys(target)** - -拦截`Object.getOwnPropertyNames(proxy)`、`Object.getOwnPropertySymbols(proxy)`、`Object.keys(proxy)`,返回一个数组。该方法返回目标对象所有自身的属性的属性名,而`Object.keys()`的返回结果仅包括目标对象自身的可遍历属性。 - -**(6)getOwnPropertyDescriptor(target, propKey)** - -拦截`Object.getOwnPropertyDescriptor(proxy, propKey)`,返回属性的描述对象。 - -**(7)defineProperty(target, propKey, propDesc)** - -拦截`Object.defineProperty(proxy, propKey, propDesc)`、`Object.defineProperties(proxy, propDescs)`,返回一个布尔值。 - -**(8)preventExtensions(target)** - -拦截`Object.preventExtensions(proxy)`,返回一个布尔值。 - -**(9)getPrototypeOf(target)** - -拦截`Object.getPrototypeOf(proxy)`,返回一个对象。 - -**(10)isExtensible(target)** - -拦截`Object.isExtensible(proxy)`,返回一个布尔值。 - -**(11)setPrototypeOf(target, proto)** - -拦截`Object.setPrototypeOf(proxy, proto)`,返回一个布尔值。 - -如果目标对象是函数,那么还有两种额外操作可以拦截。 - -**(12)apply(target, object, args)** - -拦截 Proxy 实例作为函数调用的操作,比如`proxy(...args)`、`proxy.call(object, ...args)`、`proxy.apply(...)`。 - -**(13)construct(target, args)** - -拦截 Proxy 实例作为构造函数调用的操作,比如`new proxy(...args)`。 +下面是 Proxy 支持的拦截操作一览,一共 13 种。 + +- **get(target, propKey, receiver)**:拦截对象属性的读取,比如`proxy.foo`和`proxy['foo']`。 +- **set(target, propKey, value, receiver)**:拦截对象属性的设置,比如`proxy.foo = v`或`proxy['foo'] = v`,返回一个布尔值。 +- **has(target, propKey)**:拦截`propKey in proxy`的操作,返回一个布尔值。 +- **deleteProperty(target, propKey)**:拦截`delete proxy[propKey]`的操作,返回一个布尔值。 +- **ownKeys(target)**:拦截`Object.getOwnPropertyNames(proxy)`、`Object.getOwnPropertySymbols(proxy)`、`Object.keys(proxy)`、`for...in`循环,返回一个数组。该方法返回目标对象所有自身的属性的属性名,而`Object.keys()`的返回结果仅包括目标对象自身的可遍历属性。 +- **getOwnPropertyDescriptor(target, propKey)**:拦截`Object.getOwnPropertyDescriptor(proxy, propKey)`,返回属性的描述对象。 +- **defineProperty(target, propKey, propDesc)**:拦截`Object.defineProperty(proxy, propKey, propDesc)`、`Object.defineProperties(proxy, propDescs)`,返回一个布尔值。 +- **preventExtensions(target)**:拦截`Object.preventExtensions(proxy)`,返回一个布尔值。 +- **getPrototypeOf(target)**:拦截`Object.getPrototypeOf(proxy)`,返回一个对象。 +- **isExtensible(target)**:拦截`Object.isExtensible(proxy)`,返回一个布尔值。 +- **setPrototypeOf(target, proto)**:拦截`Object.setPrototypeOf(proxy, proto)`,返回一个布尔值。如果目标对象是函数,那么还有两种额外操作可以拦截。 +- **apply(target, object, args)**:拦截 Proxy 实例作为函数调用的操作,比如`proxy(...args)`、`proxy.call(object, ...args)`、`proxy.apply(...)`。 +- **construct(target, args)**:拦截 Proxy 实例作为构造函数调用的操作,比如`new proxy(...args)`。 ## Proxy 实例的方法 @@ -187,7 +145,9 @@ fproxy.foo // "Hello, foo" ### get() -`get`方法用于拦截某个属性的读取操作。上文已经有一个例子,下面是另一个拦截读取操作的例子。 +`get`方法用于拦截某个属性的读取操作,可以接受三个参数,依次为目标对象、属性名和 proxy 实例本身(严格地说,是操作行为所针对的对象),其中最后一个参数可选。 + +`get`方法的用法,上文已经有一个例子,下面是另一个拦截读取操作的例子。 ```javascript var person = { @@ -215,13 +175,13 @@ proxy.age // 抛出一个错误 ```javascript let proto = new Proxy({}, { get(target, propertyKey, receiver) { - console.log('GET '+propertyKey); + console.log('GET ' + propertyKey); return target[propertyKey]; } }); let obj = Object.create(proto); -obj.xxx // "GET xxx" +obj.foo // "GET foo" ``` 上面代码中,拦截操作定义在`Prototype`对象上面,所以如果读取`obj`对象继承的属性时,拦截会生效。 @@ -249,7 +209,7 @@ let arr = createArray('a', 'b', 'c'); arr[-1] // c ``` -上面代码中,数组的位置参数是`-1`,就会输出数组的倒数最后一个成员。 +上面代码中,数组的位置参数是`-1`,就会输出数组的倒数第一个成员。 利用 Proxy,可以将读取属性的操作(`get`),转变为执行某个函数,从而实现属性的链式操作。 @@ -282,7 +242,7 @@ pipe(3).double.pow.reverseInt.get; // 63 上面代码设置 Proxy 以后,达到了将函数名链式使用的效果。 -下面的例子则是利用`get`拦截,实现一个生成各种DOM节点的通用函数`dom`。 +下面的例子则是利用`get`拦截,实现一个生成各种 DOM 节点的通用函数`dom`。 ```javascript const dom = new Proxy({}, { @@ -317,7 +277,33 @@ const el = dom.div({}, document.body.appendChild(el); ``` -如果一个属性不可配置(configurable)和不可写(writable),则该属性不能被代理,通过 Proxy 对象访问该属性会报错。 +下面是一个`get`方法的第三个参数的例子,它总是指向原始的读操作所在的那个对象,一般情况下就是 Proxy 实例。 + +```javascript +const proxy = new Proxy({}, { + get: function(target, property, receiver) { + return receiver; + } +}); +proxy.getReceiver === proxy // true +``` + +上面代码中,`proxy`对象的`getReceiver`属性是由`proxy`对象提供的,所以`receiver`指向`proxy`对象。 + +```javascript +const proxy = new Proxy({}, { + get: function(target, property, receiver) { + return receiver; + } +}); + +const d = Object.create(proxy); +d.a === d // true +``` + +上面代码中,`d`对象本身没有`a`属性,所以读取`d.a`的时候,会去`d`的原型`proxy`对象找。这时,`receiver`就指向`d`,代表原始的读操作所在的那个对象。 + +如果一个属性不可配置(configurable)且不可写(writable),则 Proxy 不能修改该属性,否则通过 Proxy 对象访问该属性会报错。 ```javascript const target = Object.defineProperties({}, { @@ -342,9 +328,9 @@ proxy.foo ### set() -`set`方法用来拦截某个属性的赋值操作。 +`set`方法用来拦截某个属性的赋值操作,可以接受四个参数,依次为目标对象、属性名、属性值和 Proxy 实例本身,其中最后一个参数可选。 -假定`Person`对象有一个`age`属性,该属性应该是一个不大于200的整数,那么可以使用`Proxy`保证`age`的属性值符合要求。 +假定`Person`对象有一个`age`属性,该属性应该是一个不大于 200 的整数,那么可以使用`Proxy`保证`age`的属性值符合要求。 ```javascript let validator = { @@ -358,7 +344,7 @@ let validator = { } } - // 对于age以外的属性,直接保存 + // 对于满足条件的 age 属性以及其他属性,直接保存 obj[prop] = value; } }; @@ -377,7 +363,7 @@ person.age = 300 // 报错 有时,我们会在对象上面设置内部属性,属性名的第一个字符使用下划线开头,表示这些属性不应该被外部使用。结合`get`和`set`方法,就可以做到防止这些内部属性被外部读写。 ```javascript -var handler = { +const handler = { get (target, key) { invariant(key, 'get'); return target[key]; @@ -393,8 +379,8 @@ function invariant (key, action) { throw new Error(`Invalid attempt to ${action} private "${key}" property`); } } -var target = {}; -var proxy = new Proxy(target, handler); +const target = {}; +const proxy = new Proxy(target, handler); proxy._prop // Error: Invalid attempt to get private "_prop" property proxy._prop = 'c' @@ -403,7 +389,76 @@ proxy._prop = 'c' 上面代码中,只要读写的属性名的第一个字符是下划线,一律抛错,从而达到禁止读写内部属性的目的。 -注意,如果目标对象自身的某个属性,不可写也不可配置,那么`set`不得改变这个属性的值,只能返回同样的值,否则报错。 +下面是`set`方法第四个参数的例子。 + +```javascript +const handler = { + set: function(obj, prop, value, receiver) { + obj[prop] = receiver; + } +}; +const proxy = new Proxy({}, handler); +proxy.foo = 'bar'; +proxy.foo === proxy // true +``` + +上面代码中,`set`方法的第四个参数`receiver`,指的是原始的操作行为所在的那个对象,一般情况下是`proxy`实例本身,请看下面的例子。 + +```javascript +const handler = { + set: function(obj, prop, value, receiver) { + obj[prop] = receiver; + } +}; +const proxy = new Proxy({}, handler); +const myObj = {}; +Object.setPrototypeOf(myObj, proxy); + +myObj.foo = 'bar'; +myObj.foo === myObj // true +``` + +上面代码中,设置`myObj.foo`属性的值时,`myObj`并没有`foo`属性,因此引擎会到`myObj`的原型链去找`foo`属性。`myObj`的原型对象`proxy`是一个 Proxy 实例,设置它的`foo`属性会触发`set`方法。这时,第四个参数`receiver`就指向原始赋值行为所在的对象`myObj`。 + +注意,如果目标对象自身的某个属性,不可写且不可配置,那么`set`方法将不起作用。 + +```javascript +const obj = {}; +Object.defineProperty(obj, 'foo', { + value: 'bar', + writable: false, +}); + +const handler = { + set: function(obj, prop, value, receiver) { + obj[prop] = 'baz'; + } +}; + +const proxy = new Proxy(obj, handler); +proxy.foo = 'baz'; +proxy.foo // "bar" +``` + +上面代码中,`obj.foo`属性不可写,Proxy 对这个属性的`set`代理将不会生效。 + +注意,严格模式下,`set`代理如果没有返回`true`,就会报错。 + +```javascript +'use strict'; +const handler = { + set: function(obj, prop, value, receiver) { + obj[prop] = receiver; + // 无论有没有下面这一行,都会报错 + return false; + } +}; +const proxy = new Proxy({}, handler); +proxy.foo = 'bar'; +// TypeError: 'set' on proxy: trap returned falsish for property 'foo' +``` + +上面代码中,严格模式下,`set`代理返回`false`或者`undefined`,都会报错。 ### apply() @@ -466,6 +521,8 @@ Reflect.apply(proxy, null, [9, 10]) // 38 `has`方法用来拦截`HasProperty`操作,即判断对象是否具有某个属性时,这个方法会生效。典型的操作就是`in`运算符。 +`has`方法可以接受两个参数,分别是目标对象、需查询的属性名。 + 下面的例子使用`has`方法隐藏某些属性,不被`in`运算符发现。 ```javascript @@ -542,7 +599,7 @@ for (let b in oproxy2) { // 99 ``` -上面代码中,`has`拦截只对`in`循环生效,对`for...in`循环不生效,导致不符合要求的属性没有被排除在`for...in`循环之外。 +上面代码中,`has`拦截只对`in`运算符生效,对`for...in`循环不生效,导致不符合要求的属性没有被`for...in`循环所排除。 ### construct() @@ -558,10 +615,9 @@ var handler = { `construct`方法可以接受两个参数。 -- `target`: 目标对象 -- `args`:构建函数的参数对象 - -下面是一个例子。 +- `target`:目标对象 +- `args`:构造函数的参数对象 +- `newTarget`:创造实例对象时,`new`命令作用的构造函数(下面例子的`p`) ```javascript var p = new Proxy(function () {}, { @@ -586,6 +642,7 @@ var p = new Proxy(function() {}, { }); new p() // 报错 +// Uncaught TypeError: 'construct' on proxy: trap returned non-object ('1') ``` ### deleteProperty() @@ -596,6 +653,7 @@ new p() // 报错 var handler = { deleteProperty (target, key) { invariant(key, 'delete'); + delete target[key]; return true; } }; @@ -627,17 +685,16 @@ var handler = { }; var target = {}; var proxy = new Proxy(target, handler); -proxy.foo = 'bar' -// TypeError: proxy defineProperty handler returned false for property '"foo"' +proxy.foo = 'bar' // 不会生效 ``` -上面代码中,`defineProperty`方法返回`false`,导致添加新属性会抛出错误。 +上面代码中,`defineProperty`方法返回`false`,导致添加新属性总是无效。 -注意,如果目标对象不可扩展(extensible),则`defineProperty`不能增加目标对象上不存在的属性,否则会报错。另外,如果目标对象的某个属性不可写(writable)或不可配置(configurable),则`defineProperty`方法不得改变这两个设置。 +注意,如果目标对象不可扩展(non-extensible),则`defineProperty`不能增加目标对象上不存在的属性,否则会报错。另外,如果目标对象的某个属性不可写(writable)或不可配置(configurable),则`defineProperty`方法不得改变这两个设置。 ### getOwnPropertyDescriptor() -`getOwnPropertyDescriptor`方法拦截`Object.getOwnPropertyDescriptor`,返回一个属性描述对象或者`undefined`。 +`getOwnPropertyDescriptor`方法拦截`Object.getOwnPropertyDescriptor()`,返回一个属性描述对象或者`undefined`。 ```javascript var handler = { @@ -662,13 +719,13 @@ Object.getOwnPropertyDescriptor(proxy, 'baz') ### getPrototypeOf() -`getPrototypeOf`方法主要用来拦截`Object.getPrototypeOf()`运算符,以及其他一些操作。 +`getPrototypeOf`方法主要用来拦截获取对象原型。具体来说,拦截下面这些操作。 - `Object.prototype.__proto__` - `Object.prototype.isPrototypeOf()` - `Object.getPrototypeOf()` - `Reflect.getPrototypeOf()` -- `instanceof`运算符 +- `instanceof` 下面是一个例子。 @@ -684,7 +741,7 @@ Object.getPrototypeOf(p) === proto // true 上面代码中,`getPrototypeOf`方法拦截`Object.getPrototypeOf()`,返回`proto`对象。 -注意,`getPrototypeOf`方法的返回值必须是对象或者`null`,否则报错。另外,如果目标对象不可扩展(extensible), `getPrototypeOf`方法必须返回目标对象的原型对象。 +注意,`getPrototypeOf`方法的返回值必须是对象或者`null`,否则报错。另外,如果目标对象不可扩展(non-extensible), `getPrototypeOf`方法必须返回目标对象的原型对象。 ### isExtensible() @@ -722,16 +779,18 @@ var p = new Proxy({}, { } }); -Object.isExtensible(p) // 报错 +Object.isExtensible(p) +// Uncaught TypeError: 'isExtensible' on proxy: trap result does not reflect extensibility of proxy target (which is 'true') ``` ### ownKeys() -`ownKeys`方法用来拦截以下操作。 +`ownKeys`方法用来拦截对象自身属性的读取操作。具体来说,拦截以下操作。 - `Object.getOwnPropertyNames()` - `Object.getOwnPropertySymbols()` - `Object.keys()` +- `for...in`循环 下面是拦截`Object.keys()`的例子。 @@ -826,6 +885,23 @@ Object.getOwnPropertyNames(p) // [ 'a', 'b', 'c' ] ``` +`for...in`循环也受到`ownKeys`方法的拦截。 + +```javascript +const obj = { hello: 'world' }; +const proxy = new Proxy(obj, { + ownKeys: function () { + return ['a', 'b']; + } +}); + +for (let key in proxy) { + console.log(key); // 没有任何输出 +} +``` + +上面代码中,`ownkeys`指定只返回`a`和`b`属性,由于`obj`没有这两个属性,因此`for...in`循环不会有任何输出。 + `ownKeys`方法返回的数组成员,只能是字符串或 Symbol 值。如果有其他类型的值,或者返回的根本不是数组,就会报错。 ```javascript @@ -865,7 +941,7 @@ Object.getOwnPropertyNames(p) 上面代码中,`obj`对象的`a`属性是不可配置的,这时`ownKeys`方法返回的数组之中,必须包含`a`,否则会报错。 -另外,如果目标对象是不可扩展的(non-extensition),这时`ownKeys`方法返回的数组之中,必须包含原对象的所有属性,且不能包含多余的属性,否则报错。 +另外,如果目标对象是不可扩展的(non-extensible),这时`ownKeys`方法返回的数组之中,必须包含原对象的所有属性,且不能包含多余的属性,否则报错。 ```javascript var obj = { @@ -884,7 +960,7 @@ Object.getOwnPropertyNames(p) // Uncaught TypeError: 'ownKeys' on proxy: trap returned extra keys but proxy target is non-extensible ``` -上面代码中,`Obj`对象是不可扩展的,这时`ownKeys`方法返回的数组之中,包含了`obj`对象的多余属性`b`,所以导致了报错。 +上面代码中,`obj`对象是不可扩展的,这时`ownKeys`方法返回的数组之中,包含了`obj`对象的多余属性`b`,所以导致了报错。 ### preventExtensions() @@ -893,13 +969,14 @@ Object.getOwnPropertyNames(p) 这个方法有一个限制,只有目标对象不可扩展时(即`Object.isExtensible(proxy)`为`false`),`proxy.preventExtensions`才能返回`true`,否则会报错。 ```javascript -var p = new Proxy({}, { +var proxy = new Proxy({}, { preventExtensions: function(target) { return true; } }); -Object.preventExtensions(p) // 报错 +Object.preventExtensions(proxy) +// Uncaught TypeError: 'preventExtensions' on proxy: trap returned truish but the proxy target is extensible ``` 上面代码中,`proxy.preventExtensions`方法返回`true`,但这时`Object.isExtensible(proxy)`会返回`true`,因此报错。 @@ -907,7 +984,7 @@ Object.preventExtensions(p) // 报错 为了防止出现这个问题,通常要在`proxy.preventExtensions`方法里面,调用一次`Object.preventExtensions`。 ```javascript -var p = new Proxy({}, { +var proxy = new Proxy({}, { preventExtensions: function(target) { console.log('called'); Object.preventExtensions(target); @@ -915,9 +992,9 @@ var p = new Proxy({}, { } }); -Object.preventExtensions(p) +Object.preventExtensions(proxy) // "called" -// true +// Proxy {} ``` ### setPrototypeOf() @@ -941,7 +1018,7 @@ Object.setPrototypeOf(proxy, proto); 上面代码中,只要修改`target`的原型对象,就会报错。 -注意,该方法只能返回布尔值,否则会被自动转为布尔值。另外,如果目标对象不可扩展(extensible),`setPrototypeOf`方法不得改变目标对象的原型。 +注意,该方法只能返回布尔值,否则会被自动转为布尔值。另外,如果目标对象不可扩展(non-extensible),`setPrototypeOf`方法不得改变目标对象的原型。 ## Proxy.revocable() @@ -1061,4 +1138,3 @@ function createWebService(baseUrl) { ``` 同理,Proxy 也可以用来实现数据库的 ORM 层。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/reference.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/reference.md" old mode 100644 new mode 100755 similarity index 68% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/reference.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/reference.md" index 1cd279d74..a2a989fe8 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/reference.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/reference.md" @@ -2,46 +2,46 @@ ## 官方文件 -- [ECMAScript® 2015 Language Specification](http://www.ecma-international.org/ecma-262/6.0/index.html): ECMAScript 2015规格 -- [ECMAScript® 2016 Language Specification](http://www.ecma-international.org/ecma-262/7.0/): ECMAScript 2016规格 -- [ECMAScript® 2017 Language Specification](https://tc39.github.io/ecma262/):ECMAScript 2017规格(草案) -- [ECMAScript Current Proposals](https://github.com/tc39/ecma262): ECMAScript当前的所有提案 +- [ECMAScript® 2015 Language Specification](http://www.ecma-international.org/ecma-262/6.0/index.html): ECMAScript 2015 规格 +- [ECMAScript® 2016 Language Specification](http://www.ecma-international.org/ecma-262/7.0/): ECMAScript 2016 规格 +- [ECMAScript® 2017 Language Specification](https://tc39.github.io/ecma262/):ECMAScript 2017 规格(草案) +- [ECMAScript Current Proposals](https://github.com/tc39/ecma262): ECMAScript 当前的所有提案 - [ECMAScript Active Proposals](https://github.com/tc39/proposals): 已经进入正式流程的提案 -- [ECMAscript proposals](https://github.com/hemanth/es-next):从阶段0到阶段4的所有提案列表 +- [ECMAScript proposals](https://github.com/hemanth/es-next):从阶段 0 到阶段 4 的所有提案列表 - [TC39 meeting agendas](https://github.com/tc39/agendas): TC39 委员会历年的会议记录 -- [ECMAScript Daily](https://ecmascript-daily.github.io/): TC39委员会的动态 +- [ECMAScript Daily](https://ecmascript-daily.github.io/): TC39 委员会的动态 - [The TC39 Process](https://tc39.github.io/process-document/): 提案进入正式规格的流程 - [TC39: A Process Sketch, Stages 0 and 1](https://thefeedbackloop.xyz/tc39-a-process-sketch-stages-0-and-1/): Stage 0 和 Stage 1 的含义 - [TC39 Process Sketch, Stage 2](https://thefeedbackloop.xyz/tc39-process-sketch-stage-2/): Stage 2 的含义 ## 综合介绍 -- Axel Rauschmayer, [Exploring ES6: Upgrade to the next version of JavaScript](http://exploringjs.com/es6/): ES6的专著,本书的许多代码实例来自该书 +- Axel Rauschmayer, [Exploring ES6: Upgrade to the next version of JavaScript](http://exploringjs.com/es6/): ES6 的专著,本书的许多代码实例来自该书 - Sayanee Basu, [Use ECMAScript 6 Today](http://net.tutsplus.com/articles/news/ecmascript-6-today/) - Ariya Hidayat, [Toward Modern Web Apps with ECMAScript 6](http://www.sencha.com/blog/toward-modern-web-apps-with-ecmascript-6/) - Dale Schouten, [10 Ecmascript-6 tricks you can perform right now](http://html5hub.com/10-ecmascript-6-tricks-you-can-perform-right-now/) -- Colin Toh, [Lightweight ES6 Features That Pack A Punch](http://colintoh.com/blog/lightweight-es6-features): ES6的一些“轻量级”的特性介绍 +- Colin Toh, [Lightweight ES6 Features That Pack A Punch](http://colintoh.com/blog/lightweight-es6-features): ES6 的一些“轻量级”的特性介绍 - Domenic Denicola, [ES6: The Awesome Parts](http://www.slideshare.net/domenicdenicola/es6-the-awesome-parts) - Nicholas C. Zakas, [Understanding ECMAScript 6](https://github.com/nzakas/understandinges6) - Justin Drake, [ECMAScript 6 in Node.JS](https://github.com/JustinDrake/node-es6-examples) - Ryan Dao, [Summary of ECMAScript 6 major features](http://ryandao.net/portal/content/summary-ecmascript-6-major-features) -- Luke Hoban, [ES6 features](https://github.com/lukehoban/es6features): ES6新语法点的罗列 -- Traceur-compiler, [Language Features](https://github.com/google/traceur-compiler/wiki/LanguageFeatures): Traceur文档列出的一些ES6例子 -- Axel Rauschmayer, [ECMAScript 6: what’s next for JavaScript?](https://speakerdeck.com/rauschma/ecmascript-6-whats-next-for-javascript-august-2014): 关于ES6新增语法的综合介绍,有很多例子 -- Axel Rauschmayer, [Getting started with ECMAScript 6](http://www.2ality.com/2015/08/getting-started-es6.html): ES6语法点的综合介绍 +- Luke Hoban, [ES6 features](https://github.com/lukehoban/es6features): ES6 新语法点的罗列 +- Traceur-compiler, [Language Features](https://github.com/google/traceur-compiler/wiki/LanguageFeatures): Traceur 文档列出的一些 ES6 例子 +- Axel Rauschmayer, [ECMAScript 6: what’s next for JavaScript?](https://speakerdeck.com/rauschma/ecmascript-6-whats-next-for-javascript-august-2014): 关于 ES6 新增语法的综合介绍,有很多例子 +- Axel Rauschmayer, [Getting started with ECMAScript 6](http://www.2ality.com/2015/08/getting-started-es6.html): ES6 语法点的综合介绍 - Toby Ho, [ES6 in io.js](http://davidwalsh.name/es6-io) - Guillermo Rauch, [ECMAScript 6](http://rauchg.com/2015/ecmascript-6/) -- Charles King, [The power of ECMAScript 6](http://charlesbking.com/power_of_es6/#/) -- Benjamin De Cock, [Frontend Guidelines](https://github.com/bendc/frontend-guidelines): ES6最佳实践 +- Benjamin De Cock, [Frontend Guidelines](https://github.com/bendc/frontend-guidelines): ES6 最佳实践 - Jani Hartikainen, [ES6: What are the benefits of the new features in practice?](http://codeutopia.net/blog/2015/01/06/es6-what-are-the-benefits-of-the-new-features-in-practice/) -- kangax, [Javascript quiz. ES6 edition](http://perfectionkills.com/javascript-quiz-es6/): ES6小测试 -- Jeremy Fairbank, [HTML5DevConf ES7 and Beyond!](https://speakerdeck.com/jfairbank/html5devconf-es7-and-beyond): ES7新增语法点介绍 +- kangax, [JavaScript quiz. ES6 edition](http://perfectionkills.com/javascript-quiz-es6/): ES6 小测试 +- Jeremy Fairbank, [HTML5DevConf ES7 and Beyond!](https://speakerdeck.com/jfairbank/html5devconf-es7-and-beyond): ES7 新增语法点介绍 +- Timothy Gu, [How to Read the ECMAScript Specification](https://timothygu.me/es-howto/): 如何读懂 ES6 规格 -## let和const +## let 和 const -- Kyle Simpson, [For and against let](http://davidwalsh.name/for-and-against-let): 讨论let命令的作用域 -- kangax, [Why typeof is no longer “safe”](http://es-discourse.com/t/why-typeof-is-no-longer-safe/15): 讨论在块级作用域内,let命令的变量声明和赋值的行为 -- Axel Rauschmayer, [Variables and scoping in ECMAScript 6](http://www.2ality.com/2015/02/es6-scoping.html): 讨论块级作用域与let和const的行为 +- Kyle Simpson, [For and against let](http://davidwalsh.name/for-and-against-let): 讨论 let 命令的作用域 +- kangax, [Why typeof is no longer “safe”](http://es-discourse.com/t/why-typeof-is-no-longer-safe/15): 讨论在块级作用域内,let 命令的变量声明和赋值的行为 +- Axel Rauschmayer, [Variables and scoping in ECMAScript 6](http://www.2ality.com/2015/02/es6-scoping.html): 讨论块级作用域与 let 和 const 的行为 - Nicolas Bevacqua, [ES6 Let, Const and the “Temporal Dead Zone” (TDZ) in Depth](http://ponyfoo.com/articles/es6-let-const-and-temporal-dead-zone-in-depth) - acorn, [Function statements in strict mode](https://github.com/ternjs/acorn/issues/118): 块级作用域对严格模式的函数声明的影响 - Axel Rauschmayer, [ES proposal: global](http://www.2ality.com/2016/09/global.html): 顶层对象`global` @@ -62,18 +62,22 @@ ## 正则 -- Mathias Bynens, [Unicode-aware regular expressions in ES6](https://mathiasbynens.be/notes/es6-unicode-regex): 详细介绍正则表达式的u修饰符 -- Axel Rauschmayer, [New regular expression features in ECMAScript 6](http://www.2ality.com/2015/07/regexp-es6.html):ES6正则特性的详细介绍 +- Mathias Bynens, [Unicode-aware regular expressions in ES6](https://mathiasbynens.be/notes/es6-unicode-regex): 详细介绍正则表达式的 u 修饰符 +- Axel Rauschmayer, [New regular expression features in ECMAScript 6](http://www.2ality.com/2015/07/regexp-es6.html):ES6 正则特性的详细介绍 - Yang Guo, [RegExp lookbehind assertions](http://v8project.blogspot.jp/2016/02/regexp-lookbehind-assertions.html):介绍后行断言 +- Axel Rauschmayer, [ES proposal: RegExp named capture groups](http://2ality.com/2017/05/regexp-named-capture-groups.html): 具名组匹配的介绍 +- Mathias Bynens, [ECMAScript regular expressions are getting better!](https://mathiasbynens.be/notes/es-regexp-proposals): 介绍 ES2018 添加的多项正则语法 ## 数值 - Nicolas Bevacqua, [ES6 Number Improvements in Depth](http://ponyfoo.com/articles/es6-number-improvements-in-depth) +- Axel Rauschmayer, [ES proposal: arbitrary precision integers](http://2ality.com/2017/03/es-integer.html) +- Mathias Bynens, [BigInt: arbitrary-precision integers in JavaScript](https://developers.google.com/web/updates/2018/05/bigint) ## 数组 -- Axel Rauschmayer, [ECMAScript 6’s new array methods](http://www.2ality.com/2014/05/es6-array-methods.html): 对ES6新增的数组方法的全面介绍 -- TC39, [Array.prototype.includes](https://github.com/tc39/Array.prototype.includes/): 数组的includes方法的规格 +- Axel Rauschmayer, [ECMAScript 6’s new array methods](http://www.2ality.com/2014/05/es6-array-methods.html): 对 ES6 新增的数组方法的全面介绍 +- TC39, [Array.prototype.includes](https://github.com/tc39/Array.prototype.includes/): 数组的 includes 方法的规格 - Axel Rauschmayer, [ECMAScript 6: holes in Arrays](http://www.2ality.com/2015/09/holes-arrays-es6.html): 数组的空位问题 ## 函数 @@ -82,47 +86,50 @@ - 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) - Dmitry Soshnikov, [ES6 Notes: Default values of parameters](http://dmitrysoshnikov.com/ecmascript/es6-notes-default-values-of-parameters/): 介绍参数的默认值 -- Ragan Wald, [Destructuring and Recursion in ES6](http://raganwald.com/2015/02/02/destructuring.html): rest参数和扩展运算符的详细介绍 -- Axel Rauschmayer, [The names of functions in ES6](http://www.2ality.com/2015/09/function-names-es6.html): 函数的name属性的详细介绍 -- Kyle Simpson, [Arrow This](http://blog.getify.com/arrow-this/): 箭头函数并没有自己的this -- Derick Bailey, [Do ES6 Arrow Functions Really Solve “this” In JavaScript?](http://derickbailey.com/2015/09/28/do-es6-arrow-functions-really-solve-this-in-javascript/):使用箭头函数处理this指向,必须非常小心 +- Ragan Wald, [Destructuring and Recursion in ES6](http://raganwald.com/2015/02/02/destructuring.html): rest 参数和扩展运算符的详细介绍 +- Axel Rauschmayer, [The names of functions in ES6](http://www.2ality.com/2015/09/function-names-es6.html): 函数的 name 属性的详细介绍 +- Kyle Simpson, [Arrow This](http://blog.getify.com/arrow-this/): 箭头函数并没有自己的 this +- Derick Bailey, [Do ES6 Arrow Functions Really Solve “this” In JavaScript?](http://derickbailey.com/2015/09/28/do-es6-arrow-functions-really-solve-this-in-javascript/):使用箭头函数处理 this 指向,必须非常小心 - Mark McDonnell, [Understanding recursion in functional JavaScript programming](http://www.integralist.co.uk/posts/js-recursion.html): 如何自己实现尾递归优化 - Nicholas C. Zakas, [The ECMAScript 2016 change you probably don't know](https://www.nczonline.net/blog/2016/10/the-ecmascript-2016-change-you-probably-dont-know/): 使用参数默认值时,不能在函数内部显式开启严格模式 +- Axel Rauschmayer, [ES proposal: optional catch binding](http://2ality.com/2017/08/optional-catch-binding.html) +- Cynthia Lee, [When you should use ES6 arrow functions — and when you shouldn’t](https://medium.freecodecamp.org/when-and-why-you-should-use-es6-arrow-functions-and-when-you-shouldnt-3d851d7f0b26): 讨论箭头函数的适用场合 ## 对象 -- Addy Osmani, [Data-binding Revolutions with Object.observe()](http://www.html5rocks.com/en/tutorials/es7/observe/): 介绍Object.observe()的概念 -- Sella Rafaeli, [Native JavaScript Data-Binding](http://www.sellarafaeli.com/blog/native_javascript_data_binding): 如何使用Object.observe方法,实现数据对象与DOM对象的双向绑定 +- Addy Osmani, [Data-binding Revolutions with Object.observe()](http://www.html5rocks.com/en/tutorials/es7/observe/): 介绍 Object.observe()的概念 +- Sella Rafaeli, [Native JavaScript Data-Binding](http://www.sellarafaeli.com/blog/native_javascript_data_binding): 如何使用 Object.observe 方法,实现数据对象与 DOM 对象的双向绑定 - Axel Rauschmayer, [`__proto__` in ECMAScript 6](http://www.2ality.com/2015/09/proto-es6.html) - Axel Rauschmayer, [Enumerability in ECMAScript 6](http://www.2ality.com/2015/10/enumerability-es6.html) - Axel Rauschmayer, [ES proposal: Object.getOwnPropertyDescriptors()](http://www.2ality.com/2016/02/object-getownpropertydescriptors.html) - TC39, [Object.getOwnPropertyDescriptors Proposal](https://github.com/tc39/proposal-object-getownpropertydescriptors) +- David Titarenco, [How Spread Syntax Breaks JavaScript](https://dvt.name/2018/06/02/spread-syntax-breaks-javascript/): 扩展运算符的一些不合理的地方 ## Symbol -- Axel Rauschmayer, [Symbols in ECMAScript 6](http://www.2ality.com/2014/12/es6-symbols.html): Symbol简介 -- MDN, [Symbol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol): Symbol类型的详细介绍 +- Axel Rauschmayer, [Symbols in ECMAScript 6](http://www.2ality.com/2014/12/es6-symbols.html): Symbol 简介 +- MDN, [Symbol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol): Symbol 类型的详细介绍 - Jason Orendorff, [ES6 In Depth: Symbols](https://hacks.mozilla.org/2015/06/es6-in-depth-symbols/) -- Keith Cirkel, [Metaprogramming in ES6: Symbols and why they're awesome](http://blog.keithcirkel.co.uk/metaprogramming-in-es6-symbols/): Symbol的深入介绍 +- Keith Cirkel, [Metaprogramming in ES6: Symbols and why they're awesome](http://blog.keithcirkel.co.uk/metaprogramming-in-es6-symbols/): Symbol 的深入介绍 - Axel Rauschmayer, [Customizing ES6 via well-known symbols](http://www.2ality.com/2015/09/well-known-symbols-es6.html) - Derick Bailey, [Creating A True Singleton In Node.js, With ES6 Symbols](https://derickbailey.com/2016/03/09/creating-a-true-singleton-in-node-js-with-es6-symbols/) - Das Surma, [How to read web specs Part IIa – Or: ECMAScript Symbols](https://dassur.ma/things/reading-specs-2/): 介绍 Symbol 的规格 -## Set和Map +## Set 和 Map -- Mozilla Developer Network, [WeakSet](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet):介绍WeakSet数据结构 -- Dwayne Charrington, [What Are Weakmaps In ES6?](http://ilikekillnerds.com/2015/02/what-are-weakmaps-in-es6/): WeakMap数据结构介绍 -- Axel Rauschmayer, [ECMAScript 6: maps and sets](http://www.2ality.com/2015/01/es6-maps-sets.html): Set和Map结构的详细介绍 -- Jason Orendorff, [ES6 In Depth: Collections](https://hacks.mozilla.org/2015/06/es6-in-depth-collections/):Set和Map结构的设计思想 -- Axel Rauschmayer, [Converting ES6 Maps to and from JSON](http://www.2ality.com/2015/08/es6-map-json.html): 如何将Map与其他数据结构互相转换 +- Mozilla Developer Network, [WeakSet](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet):介绍 WeakSet 数据结构 +- Dwayne Charrington, [What Are Weakmaps In ES6?](http://ilikekillnerds.com/2015/02/what-are-weakmaps-in-es6/): WeakMap 数据结构介绍 +- Axel Rauschmayer, [ECMAScript 6: maps and sets](http://www.2ality.com/2015/01/es6-maps-sets.html): Set 和 Map 结构的详细介绍 +- Jason Orendorff, [ES6 In Depth: Collections](https://hacks.mozilla.org/2015/06/es6-in-depth-collections/):Set 和 Map 结构的设计思想 +- Axel Rauschmayer, [Converting ES6 Maps to and from JSON](http://www.2ality.com/2015/08/es6-map-json.html): 如何将 Map 与其他数据结构互相转换 ## Proxy 和 Reflect - Nicholas C. Zakas, [Creating defensive objects with ES6 proxies](http://www.nczonline.net/blog/2014/04/22/creating-defensive-objects-with-es6-proxies/) -- Axel Rauschmayer, [Meta programming with ECMAScript 6 proxies](http://www.2ality.com/2014/12/es6-proxies.html): Proxy详解 -- Daniel Zautner, [Meta-programming JavaScript Using Proxies](http://dzautner.com/meta-programming-javascript-using-proxies/): 使用Proxy实现元编程 -- Tom Van Cutsem, [Harmony-reflect](https://github.com/tvcutsem/harmony-reflect/wiki): Reflect对象的设计目的 -- Tom Van Cutsem, [Proxy Traps](https://github.com/tvcutsem/harmony-reflect/blob/master/doc/traps.md): Proxy拦截操作一览 +- Axel Rauschmayer, [Meta programming with ECMAScript 6 proxies](http://www.2ality.com/2014/12/es6-proxies.html): Proxy 详解 +- Daniel Zautner, [Meta-programming JavaScript Using Proxies](http://dzautner.com/meta-programming-javascript-using-proxies/): 使用 Proxy 实现元编程 +- Tom Van Cutsem, [Harmony-reflect](https://github.com/tvcutsem/harmony-reflect/wiki): Reflect 对象的设计目的 +- Tom Van Cutsem, [Proxy Traps](https://github.com/tvcutsem/harmony-reflect/blob/master/doc/traps.md): Proxy 拦截操作一览 - Tom Van Cutsem, [Reflect API](https://github.com/tvcutsem/harmony-reflect/blob/master/doc/api.md) - Tom Van Cutsem, [Proxy Handler API](https://github.com/tvcutsem/harmony-reflect/blob/master/doc/handler_api.md) - Nicolas Bevacqua, [ES6 Proxies in Depth](http://ponyfoo.com/articles/es6-proxies-in-depth) @@ -135,10 +142,11 @@ ## Promise 对象 - Jake Archibald, [JavaScript Promises: There and back again](http://www.html5rocks.com/en/tutorials/es6/promises/) +- Jake Archibald, [Tasks, microtasks, queues and schedules](https://jakearchibald.com/2015/tasks-microtasks-queues-and-schedules/) - Tilde, [rsvp.js](https://github.com/tildeio/rsvp.js) -- Sandeep Panda, [An Overview of JavaScript Promises](http://www.sitepoint.com/overview-javascript-promises/): ES6 Promise入门介绍 -- Dave Atchley, [ES6 Promises](http://www.datchley.name/es6-promises/): Promise的语法介绍 -- Axel Rauschmayer, [ECMAScript 6 promises (2/2): the API](http://www.2ality.com/2014/10/es6-promises-api.html): 对ES6 Promise规格和用法的详细介绍 +- Sandeep Panda, [An Overview of JavaScript Promises](http://www.sitepoint.com/overview-javascript-promises/): ES6 Promise 入门介绍 +- Dave Atchley, [ES6 Promises](http://www.datchley.name/es6-promises/): Promise 的语法介绍 +- Axel Rauschmayer, [ECMAScript 6 promises (2/2): the API](http://www.2ality.com/2014/10/es6-promises-api.html): 对 ES6 Promise 规格和用法的详细介绍 - Jack Franklin, [Embracing Promises in JavaScript](http://javascriptplayground.com/blog/2015/02/promises/): catch 方法的例子 - Ronald Chen, [How to escape Promise Hell](https://medium.com/@pyrolistical/how-to-get-out-of-promise-hell-8c20e0ab0513#.2an1he6vf): 如何使用`Promise.all`方法的一些很好的例子 - Jordan Harband, [proposal-promise-try](https://github.com/ljharb/proposal-promise-try): Promise.try() 方法的提案 @@ -149,9 +157,9 @@ - Mozilla Developer Network, [Iterators and generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Iterators_and_Generators) - Mozilla Developer Network, [The Iterator protocol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/The_Iterator_protocol) -- Jason Orendorff, [ES6 In Depth: Iterators and the for-of loop](https://hacks.mozilla.org/2015/04/es6-in-depth-iterators-and-the-for-of-loop/): 遍历器与for...of循环的介绍 -- Axel Rauschmayer, [Iterators and generators in ECMAScript 6](http://www.2ality.com/2013/06/iterators-generators.html): 探讨Iterator和Generator的设计目的 -- Axel Rauschmayer, [Iterables and iterators in ECMAScript 6](http://www.2ality.com/2015/02/es6-iteration.html): Iterator的详细介绍 +- Jason Orendorff, [ES6 In Depth: Iterators and the for-of loop](https://hacks.mozilla.org/2015/04/es6-in-depth-iterators-and-the-for-of-loop/): 遍历器与 for...of 循环的介绍 +- Axel Rauschmayer, [Iterators and generators in ECMAScript 6](http://www.2ality.com/2013/06/iterators-generators.html): 探讨 Iterator 和 Generator 的设计目的 +- Axel Rauschmayer, [Iterables and iterators in ECMAScript 6](http://www.2ality.com/2015/02/es6-iteration.html): Iterator 的详细介绍 - Kyle Simpson, [Iterating ES6 Numbers](http://blog.getify.com/iterating-es6-numbers/): 在数值对象上部署遍历器 ## Generator @@ -159,67 +167,76 @@ - Matt Baker, [Replacing callbacks with ES6 Generators](http://flippinawesome.org/2014/02/10/replacing-callbacks-with-es6-generators/) - Steven Sanderson, [Experiments with Koa and JavaScript Generators](http://blog.stevensanderson.com/2013/12/21/experiments-with-koa-and-javascript-generators/) - jmar777, [What's the Big Deal with Generators?](http://devsmash.com/blog/whats-the-big-deal-with-generators) -- Marc Harter, [Generators in Node.js: Common Misconceptions and Three Good Use Cases](http://strongloop.com/strongblog/how-to-generators-node-js-yield-use-cases/): 讨论Generator函数的作用 -- StackOverflow, [ES6 yield : what happens to the arguments of the first call next()?](http://stackoverflow.com/questions/20977379/es6-yield-what-happens-to-the-arguments-of-the-first-call-next): 第一次使用next方法时不能带有参数 -- Kyle Simpson, [ES6 Generators: Complete Series](http://davidwalsh.name/es6-generators): 由浅入深探讨Generator的系列文章,共四篇 -- Gajus Kuizinas, [The Definitive Guide to the JavaScript Generators](http://gajus.com/blog/2/the-definetive-guide-to-the-javascript-generators): 对Generator的综合介绍 -- Jan Krems, [Generators Are Like Arrays](https://gist.github.com/jkrems/04a2b34fb9893e4c2b5c): 讨论Generator可以被当作数据结构看待 -- Harold Cooper, [Coroutine Event Loops in Javascript](http://syzygy.st/javascript-coroutines/): Generator用于实现状态机 -- Ruslan Ismagilov, [learn-generators](https://github.com/isRuslan/learn-generators): 编程练习,共6道题 -- Steven Sanderson, [Experiments with Koa and JavaScript Generators](http://blog.stevensanderson.com/2013/12/21/experiments-with-koa-and-javascript-generators/): Generator入门介绍,以Koa框架为例 -- Mahdi Dibaiee, [ES7 Array and Generator comprehensions](http://dibaiee.ir/es7-array-generator-comprehensions/):ES7的Generator推导 +- Marc Harter, [Generators in Node.js: Common Misconceptions and Three Good Use Cases](http://strongloop.com/strongblog/how-to-generators-node-js-yield-use-cases/): 讨论 Generator 函数的作用 +- StackOverflow, [ES6 yield : what happens to the arguments of the first call next()?](http://stackoverflow.com/questions/20977379/es6-yield-what-happens-to-the-arguments-of-the-first-call-next): 第一次使用 next 方法时不能带有参数 +- Kyle Simpson, [ES6 Generators: Complete Series](http://davidwalsh.name/es6-generators): 由浅入深探讨 Generator 的系列文章,共四篇 +- Gajus Kuizinas, [The Definitive Guide to the JavaScript Generators](http://gajus.com/blog/2/the-definetive-guide-to-the-javascript-generators): 对 Generator 的综合介绍 +- Jan Krems, [Generators Are Like Arrays](https://gist.github.com/jkrems/04a2b34fb9893e4c2b5c): 讨论 Generator 可以被当作数据结构看待 +- Harold Cooper, [Coroutine Event Loops in JavaScript](http://syzygy.st/javascript-coroutines/): Generator 用于实现状态机 +- Ruslan Ismagilov, [learn-generators](https://github.com/isRuslan/learn-generators): 编程练习,共 6 道题 +- Steven Sanderson, [Experiments with Koa and JavaScript Generators](http://blog.stevensanderson.com/2013/12/21/experiments-with-koa-and-javascript-generators/): Generator 入门介绍,以 Koa 框架为例 +- Mahdi Dibaiee, [ES7 Array and Generator comprehensions](http://dibaiee.ir/es7-array-generator-comprehensions/):ES7 的 Generator 推导 - Nicolas Bevacqua, [ES6 Generators in Depth](http://ponyfoo.com/articles/es6-generators-in-depth) -- Axel Rauschmayer, [ES6 generators in depth](http://www.2ality.com/2015/03/es6-generators.html): Generator规格的详尽讲解 +- Axel Rauschmayer, [ES6 generators in depth](http://www.2ality.com/2015/03/es6-generators.html): Generator 规格的详尽讲解 - Derick Bailey, [Using ES6 Generators To Short-Circuit Hierarchical Data Iteration](https://derickbailey.com/2015/10/05/using-es6-generators-to-short-circuit-hierarchical-data-iteration/):使用 for...of 循环完成预定的操作步骤 -## 异步操作和Async函数 +## 异步操作和 Async 函数 -- Luke Hoban, [Async Functions for ECMAScript](https://github.com/lukehoban/ecmascript-asyncawait): Async函数的设计思想,与Promise、Gernerator函数的关系 -- Jafar Husain, [Asynchronous Generators for ES7](https://github.com/jhusain/asyncgenerator): Async函数的深入讨论 -- Nolan Lawson, [Taming the asynchronous beast with ES7](http://pouchdb.com/2015/03/05/taming-the-async-beast-with-es7.html): async函数通俗的实例讲解 -- Jafar Husain, [Async Generators](https://docs.google.com/file/d/0B4PVbLpUIdzoMDR5dWstRllXblU/view?sle=true): 对async与Generator混合使用的一些讨论 -- Daniel Brain, [Understand promises before you start using async/await](https://medium.com/@bluepnume/learn-about-promises-before-you-start-using-async-await-eb148164a9c8): 讨论async/await与Promise的关系 +- Luke Hoban, [Async Functions for ECMAScript](https://github.com/lukehoban/ecmascript-asyncawait): Async 函数的设计思想,与 Promise、Gernerator 函数的关系 +- Jafar Husain, [Asynchronous Generators for ES7](https://github.com/jhusain/asyncgenerator): Async 函数的深入讨论 +- Nolan Lawson, [Taming the asynchronous beast with ES7](http://pouchdb.com/2015/03/05/taming-the-async-beast-with-es7.html): async 函数通俗的实例讲解 +- Jafar Husain, [Async Generators](https://docs.google.com/file/d/0B4PVbLpUIdzoMDR5dWstRllXblU/view?sle=true): 对 async 与 Generator 混合使用的一些讨论 +- Daniel Brain, [Understand promises before you start using async/await](https://medium.com/@bluepnume/learn-about-promises-before-you-start-using-async-await-eb148164a9c8): 讨论 async/await 与 Promise 的关系 - Jake Archibald, [Async functions - making promises friendly](https://developers.google.com/web/fundamentals/getting-started/primers/async-functions) - Axel Rauschmayer, [ES proposal: asynchronous iteration](http://www.2ality.com/2016/10/asynchronous-iteration.html): 异步遍历器的详细介绍 -- Dima Grossman, [How to write async await without try-catch blocks in Javascript](http://blog.grossman.io/how-to-write-async-await-without-try-catch-blocks-in-javascript/): 除了 try/catch 以外的 async 函数内部捕捉错误的方法 +- Dima Grossman, [How to write async await without try-catch blocks in JavaScript](http://blog.grossman.io/how-to-write-async-await-without-try-catch-blocks-in-javascript/): 除了 try/catch 以外的 async 函数内部捕捉错误的方法 +- Mostafa Gaafa, [6 Reasons Why JavaScript’s Async/Await Blows Promises Away](https://hackernoon.com/6-reasons-why-javascripts-async-await-blows-promises-away-tutorial-c7ec10518dd9): Async 函数的6个好处 +- Mathias Bynens, [Asynchronous stack traces: why await beats Promise#then()](https://mathiasbynens.be/notes/async-stack-traces): async 函数可以保留错误堆栈 ## Class -- Sebastian Porto, [ES6 classes and JavaScript prototypes](https://reinteractive.net/posts/235-es6-classes-and-javascript-prototypes): ES6 Class的写法与ES5 Prototype的写法对比 -- Jack Franklin, [An introduction to ES6 classes](http://javascriptplayground.com/blog/2014/07/introduction-to-es6-classes-tutorial/): ES6 class的入门介绍 +- Sebastian Porto, [ES6 classes and JavaScript prototypes](https://reinteractive.net/posts/235-es6-classes-and-javascript-prototypes): ES6 Class 的写法与 ES5 Prototype 的写法对比 +- Jack Franklin, [An introduction to ES6 classes](http://javascriptplayground.com/blog/2014/07/introduction-to-es6-classes-tutorial/): ES6 class 的入门介绍 - Axel Rauschmayer, [ECMAScript 6: new OOP features besides classes](http://www.2ality.com/2014/12/es6-oop.html) -- Axel Rauschmayer, [Classes in ECMAScript 6 (final semantics)](http://www.2ality.com/2015/02/es6-classes-final.html): Class语法的详细介绍和设计思想分析 -- Eric Faust, [ES6 In Depth: Subclassing](https://hacks.mozilla.org/2015/08/es6-in-depth-subclassing/): Class语法的深入介绍 -- Nicolás Bevacqua, [Binding Methods to Class Instance Objects](https://ponyfoo.com/articles/binding-methods-to-class-instance-objects): 如何绑定类的实例中的this +- Axel Rauschmayer, [Classes in ECMAScript 6 (final semantics)](http://www.2ality.com/2015/02/es6-classes-final.html): Class 语法的详细介绍和设计思想分析 +- Eric Faust, [ES6 In Depth: Subclassing](https://hacks.mozilla.org/2015/08/es6-in-depth-subclassing/): Class 语法的深入介绍 +- Nicolás Bevacqua, [Binding Methods to Class Instance Objects](https://ponyfoo.com/articles/binding-methods-to-class-instance-objects): 如何绑定类的实例中的 this +- Jamie Kyle, [JavaScript's new #private class fields](https://jamie.build/javascripts-new-private-class-fields.html):私有属性的介绍。 +- Mathias Bynens, [Public and private class fields](https://developers.google.com/web/updates/2018/12/class-fields):实例属性的新写法的介绍。 ## Decorator -- Maximiliano Fierro, [Declarative vs Imperative](http://elmasse.github.io/js/decorators-bindings-es7.html): Decorators和Mixin介绍 -- Justin Fagnani, ["Real" Mixins with JavaScript Classes](http://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/): 使用类的继承实现Mixin -- Addy Osmani, [Exploring ES2016 Decorators](https://medium.com/google-developers/exploring-es7-decorators-76ecb65fb841): Decorator的深入介绍 +- Maximiliano Fierro, [Declarative vs Imperative](http://elmasse.github.io/js/decorators-bindings-es7.html): Decorators 和 Mixin 介绍 +- Justin Fagnani, ["Real" Mixins with JavaScript Classes](http://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/): 使用类的继承实现 Mixin +- Addy Osmani, [Exploring ES2016 Decorators](https://medium.com/google-developers/exploring-es7-decorators-76ecb65fb841): Decorator 的深入介绍 - Sebastian McKenzie, [Allow decorators for functions as well](https://github.com/wycats/javascript-decorators/issues/4): 为什么修饰器不能用于函数 -- Maximiliano Fierro, [Traits with ES7 Decorators](http://cocktailjs.github.io/blog/traits-with-es7-decorators.html): Trait的用法介绍 +- Maximiliano Fierro, [Traits with ES7 Decorators](http://cocktailjs.github.io/blog/traits-with-es7-decorators.html): Trait 的用法介绍 - Jonathan Creamer: [Using ES2016 Decorators to Publish on an Event Bus](http://jonathancreamer.com/using-es2016-decorators-to-publish-on-an-event-bus/): 使用修饰器实现自动发布事件 ## Module -- Jack Franklin, [JavaScript Modules the ES6 Way](http://24ways.org/2014/javascript-modules-the-es6-way/): ES6模块入门 -- Axel Rauschmayer, [ECMAScript 6 modules: the final syntax](http://www.2ality.com/2014/09/es6-modules-final.html): ES6模块的介绍,以及与CommonJS规格的详细比较 -- Dave Herman, [Static module resolution](http://calculist.org/blog/2012/06/29/static-module-resolution/): ES6模块的静态化设计思想 -- Jason Orendorff, [ES6 In Depth: Modules](https://hacks.mozilla.org/2015/08/es6-in-depth-modules/): ES6模块设计思想的介绍 -- Ben Newman, [The Importance of import and export](http://benjamn.github.io/empirenode-2015/#/): ES6模块的设计思想 +- Jack Franklin, [JavaScript Modules the ES6 Way](http://24ways.org/2014/javascript-modules-the-es6-way/): ES6 模块入门 +- Axel Rauschmayer, [ECMAScript 6 modules: the final syntax](http://www.2ality.com/2014/09/es6-modules-final.html): ES6 模块的介绍,以及与 CommonJS 规格的详细比较 +- Dave Herman, [Static module resolution](http://calculist.org/blog/2012/06/29/static-module-resolution/): ES6 模块的静态化设计思想 +- Jason Orendorff, [ES6 In Depth: Modules](https://hacks.mozilla.org/2015/08/es6-in-depth-modules/): ES6 模块设计思想的介绍 +- Ben Newman, [The Importance of import and export](http://benjamn.github.io/empirenode-2015/#/): ES6 模块的设计思想 - ESDiscuss, [Why is "export default var a = 1;" invalid syntax?](https://esdiscuss.org/topic/why-is-export-default-var-a-1-invalid-syntax) - Bradley Meck, [ES6 Module Interoperability](https://github.com/nodejs/node-eps/blob/master/002-es6-modules.md): 介绍 Node 如何处理 ES6 语法加载 CommonJS 模块 - Axel Rauschmayer, [Making transpiled ES modules more spec-compliant](http://www.2ality.com/2017/01/babel-esm-spec-mode.html): ES6 模块编译成 CommonJS 模块的详细介绍 - Axel Rauschmayer, [ES proposal: import() – dynamically importing ES modules](http://www.2ality.com/2017/01/import-operator.html): import() 的用法 +- Node EPS, [ES Module Interoperability](https://github.com/nodejs/node-eps/blob/master/002-es-modules.md): Node 对 ES6 模块的处理规格 ## 二进制数组 - Ilmari Heikkinen, [Typed Arrays: Binary Data in the Browser](http://www.html5rocks.com/en/tutorials/webgl/typed_arrays/) - Khronos, [Typed Array Specification](http://www.khronos.org/registry/typedarray/specs/latest/) -- Ian Elliot, [Reading A BMP File In JavaScript](http://www.i-programmer.info/projects/36-web/6234-reading-a-bmp-file-in-javascript.html) +- Ian Elliot, [Reading A BMP File In JavaScript](http://www.i-programmer.info/projects/36-web/6234-reading-a-bmp-file-in-javascript.html) - Renato Mangini, [How to convert ArrayBuffer to and from String](http://updates.html5rocks.com/2012/06/How-to-convert-ArrayBuffer-to-and-from-String) - Axel Rauschmayer, [Typed Arrays in ECMAScript 6](http://www.2ality.com/2015/09/typed-arrays.html) +- Axel Rauschmayer, [ES proposal: Shared memory and atomics](http://2ality.com/2017/01/shared-array-buffer.html) +- Lin Clark, [Avoiding race conditions in SharedArrayBuffers with Atomics](https://hacks.mozilla.org/2017/06/avoiding-race-conditions-in-sharedarraybuffers-with-atomics/): Atomics 对象使用场景的解释 +- Lars T Hansen, [Shared memory - a brief tutorial](https://github.com/tc39/ecmascript_sharedmem/blob/master/TUTORIAL.md) +- James Milner, [The Return of SharedArrayBuffers and Atomics](https://www.sitepen.com/blog/2018/09/19/the-return-of-sharedarraybuffers-and-atomics/) ## SIMD @@ -230,16 +247,15 @@ ## 工具 -- Babel, [Babel Handbook](https://github.com/thejameskyle/babel-handbook/tree/master/translations/en): Babel的用法介绍 -- Google, [traceur-compiler](https://github.com/google/traceur-compiler): Traceur编译器 +- Babel, [Babel Handbook](https://github.com/thejameskyle/babel-handbook/tree/master/translations/en): Babel 的用法介绍 +- Google, [traceur-compiler](https://github.com/google/traceur-compiler): Traceur 编译器 - Casper Beyer, [ECMAScript 6 Features and Tools](http://caspervonb.github.io/2014/03/05/ecmascript6-features-and-tools.html) - Stoyan Stefanov, [Writing ES6 today with jstransform](http://www.phpied.com/writing-es6-today-with-jstransform/) -- ES6 Module Loader, [ES6 Module Loader Polyfill](https://github.com/ModuleLoader/es6-module-loader): 在浏览器和node.js加载ES6模块的一个库,文档里对ES6模块有详细解释 -- Paul Miller, [es6-shim](https://github.com/paulmillr/es6-shim): 一个针对老式浏览器,模拟ES6部分功能的垫片库(shim) -- army8735, [Javascript Downcast](https://github.com/army8735/jsdc): 国产的ES6到ES5的转码器 -- esnext, [ES6 Module Transpiler](https://github.com/esnext/es6-module-transpiler):基于node.js的将ES6模块转为ES5代码的命令行工具 -- Sebastian McKenzie, [BabelJS](http://babeljs.io/): ES6转译器 -- SystemJS, [SystemJS](https://github.com/systemjs/systemjs): 在浏览器中加载AMD、CJS、ES6模块的一个垫片库 -- Modernizr, [HTML5 Cross Browser Polyfills](https://github.com/Modernizr/Modernizr/wiki/HTML5-Cross-Browser-Polyfills#ecmascript-6-harmony): ES6垫片库清单 -- Facebook, [regenerator](https://github.com/facebook/regenerator): 将Generator函数转为ES5的转码器 - +- ES6 Module Loader, [ES6 Module Loader Polyfill](https://github.com/ModuleLoader/es6-module-loader): 在浏览器和 node.js 加载 ES6 模块的一个库,文档里对 ES6 模块有详细解释 +- Paul Miller, [es6-shim](https://github.com/paulmillr/es6-shim): 一个针对老式浏览器,模拟 ES6 部分功能的垫片库(shim) +- army8735, [JavaScript Downcast](https://github.com/army8735/jsdc): 国产的 ES6 到 ES5 的转码器 +- esnext, [ES6 Module Transpiler](https://github.com/esnext/es6-module-transpiler):基于 node.js 的将 ES6 模块转为 ES5 代码的命令行工具 +- Sebastian McKenzie, [BabelJS](http://babeljs.io/): ES6 转译器 +- SystemJS, [SystemJS](https://github.com/systemjs/systemjs): 在浏览器中加载 AMD、CJS、ES6 模块的一个垫片库 +- Modernizr, [HTML5 Cross Browser Polyfills](https://github.com/Modernizr/Modernizr/wiki/HTML5-Cross-Browser-Polyfills#ecmascript-6-harmony): ES6 垫片库清单 +- Facebook, [regenerator](https://github.com/facebook/regenerator): 将 Generator 函数转为 ES5 的转码器 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/reflect.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/reflect.md" old mode 100644 new mode 100755 similarity index 79% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/reflect.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/reflect.md" index ed9b028bd..0af5a1df6 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/reflect.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/reflect.md" @@ -42,7 +42,7 @@ Proxy(target, { set: function(target, name, value, receiver) { var success = Reflect.set(target,name, value, receiver); if (success) { - log('property ' + name + ' on ' + target + ' set to ' + value); + console.log('property ' + name + ' on ' + target + ' set to ' + value); } return success; } @@ -84,15 +84,15 @@ Reflect.apply(Math.floor, undefined, [1.75]) // 1 ## 静态方法 -`Reflect`对象一共有13个静态方法。 +`Reflect`对象一共有 13 个静态方法。 -- Reflect.apply(target,thisArg,args) -- Reflect.construct(target,args) -- Reflect.get(target,name,receiver) -- Reflect.set(target,name,value,receiver) -- Reflect.defineProperty(target,name,desc) -- Reflect.deleteProperty(target,name) -- Reflect.has(target,name) +- Reflect.apply(target, thisArg, args) +- Reflect.construct(target, args) +- Reflect.get(target, name, receiver) +- Reflect.set(target, name, value, receiver) +- Reflect.defineProperty(target, name, desc) +- Reflect.deleteProperty(target, name) +- Reflect.has(target, name) - Reflect.ownKeys(target) - Reflect.isExtensible(target) - Reflect.preventExtensions(target) @@ -186,6 +186,53 @@ myObject.foo // 4 myReceiverObject.foo // 1 ``` +注意,如果 `Proxy`对象和 `Reflect`对象联合使用,前者拦截赋值操作,后者完成赋值的默认行为,而且传入了`receiver`,那么`Reflect.set`会触发`Proxy.defineProperty`拦截。 + +```javascript +let p = { + a: 'a' +}; + +let handler = { + set(target, key, value, receiver) { + console.log('set'); + Reflect.set(target, key, value, receiver) + }, + defineProperty(target, key, attribute) { + console.log('defineProperty'); + Reflect.defineProperty(target, key, attribute); + } +}; + +let obj = new Proxy(p, handler); +obj.a = 'A'; +// set +// defineProperty +``` + +上面代码中,`Proxy.set`拦截里面使用了`Reflect.set`,而且传入了`receiver`,导致触发`Proxy.defineProperty`拦截。这是因为`Proxy.set`的`receiver`参数总是指向当前的 `Proxy`实例(即上例的`obj`),而`Reflect.set`一旦传入`receiver`,就会将属性赋值到`receiver`上面(即`obj`),导致触发`defineProperty`拦截。如果`Reflect.set`没有传入`receiver`,那么就不会触发`defineProperty`拦截。 + +```javascript +let p = { + a: 'a' +}; + +let handler = { + set(target, key, value, receiver) { + console.log('set'); + Reflect.set(target, key, value) + }, + defineProperty(target, key, attribute) { + console.log('defineProperty'); + Reflect.defineProperty(target, key, attribute); + } +}; + +let obj = new Proxy(p, handler); +obj.a = 'A'; +// set +``` + 如果第一个参数不是对象,`Reflect.set`会报错。 ```javascript @@ -266,16 +313,27 @@ Reflect.getPrototypeOf(1) // 报错 ### Reflect.setPrototypeOf(obj, newProto) -`Reflect.setPrototypeOf`方法用于设置对象的`__proto__`属性,返回第一个参数对象,对应`Object.setPrototypeOf(obj, newProto)`。 +`Reflect.setPrototypeOf`方法用于设置目标对象的原型(prototype),对应`Object.setPrototypeOf(obj, newProto)`方法。它返回一个布尔值,表示是否设置成功。 ```javascript -const myObj = new FancyThing(); +const myObj = {}; // 旧写法 -Object.setPrototypeOf(myObj, OtherThing.prototype); +Object.setPrototypeOf(myObj, Array.prototype); // 新写法 -Reflect.setPrototypeOf(myObj, OtherThing.prototype); +Reflect.setPrototypeOf(myObj, Array.prototype); + +myObj.length // 0 +``` + +如果无法设置目标对象的原型(比如,目标对象禁止扩展),`Reflect.setPrototypeOf`方法返回`false`。 + +```javascript +Reflect.setPrototypeOf({}, null) +// true +Reflect.setPrototypeOf(Object.freeze({}), null) +// false ``` 如果第一个参数不是对象,`Object.setPrototypeOf`会返回第一个参数本身,而`Reflect.setPrototypeOf`会报错。 @@ -315,7 +373,7 @@ const type = Object.prototype.toString.call(youngest); // 新写法 const youngest = Reflect.apply(Math.min, Math, ages); const oldest = Reflect.apply(Math.max, Math, ages); -const type = Reflect.apply(Object.prototype.toString, youngest); +const type = Reflect.apply(Object.prototype.toString, youngest, []); ``` ### Reflect.defineProperty(target, propertyKey, attributes) @@ -329,17 +387,35 @@ function MyDate() { // 旧写法 Object.defineProperty(MyDate, 'now', { - value: () => new Date.now() + value: () => Date.now() }); // 新写法 Reflect.defineProperty(MyDate, 'now', { - value: () => new Date.now() + value: () => Date.now() }); ``` 如果`Reflect.defineProperty`的第一个参数不是对象,就会抛出错误,比如`Reflect.defineProperty(1, 'foo')`。 +这个方法可以与`Proxy.defineProperty`配合使用。 + +```javascript +const p = new Proxy({}, { + defineProperty(target, prop, descriptor) { + console.log(descriptor); + return Reflect.defineProperty(target, prop, descriptor); + } +}); + +p.foo = 'bar'; +// {value: "bar", writable: true, enumerable: true, configurable: true} + +p.foo // "bar" +``` + +上面代码中,`Proxy.defineProperty`对属性赋值设置了拦截,然后使用`Reflect.defineProperty`完成了赋值。 + ### Reflect.getOwnPropertyDescriptor(target, propertyKey) `Reflect.getOwnPropertyDescriptor`基本等同于`Object.getOwnPropertyDescriptor`,用于得到指定属性的描述对象,将来会替代掉后者。 @@ -389,19 +465,19 @@ Reflect.isExtensible(1) // 报错 var myObject = {}; // 旧写法 -Object.isExtensible(myObject) // true +Object.preventExtensions(myObject) // Object {} // 新写法 Reflect.preventExtensions(myObject) // true ``` -如果参数不是对象,`Object.isExtensible`在 ES5 环境报错,在 ES6 环境返回这个参数,而`Reflect.preventExtensions`会报错。 +如果参数不是对象,`Object.preventExtensions`在 ES5 环境报错,在 ES6 环境返回传入的参数,而`Reflect.preventExtensions`会报错。 ```javascript -// ES5 +// ES5 环境 Object.preventExtensions(1) // 报错 -// ES6 +// ES6 环境 Object.preventExtensions(1) // 1 // 新写法 @@ -425,11 +501,11 @@ Object.getOwnPropertyNames(myObject) // ['foo', 'bar'] Object.getOwnPropertySymbols(myObject) -//[Symbol.for('baz'), Symbol.for('bing')] +//[Symbol(baz), Symbol(bing)] // 新写法 Reflect.ownKeys(myObject) -// ['foo', 'bar', Symbol.for('baz'), Symbol.for('bing')] +// ['foo', 'bar', Symbol(baz), Symbol(bing)] ``` ## 实例:使用 Proxy 实现观察者模式 @@ -470,4 +546,3 @@ function set(target, key, value, receiver) { ``` 上面代码中,先定义了一个`Set`集合,所有观察者函数都放进这个集合。然后,`observable`函数返回原始对象的代理,拦截赋值操作。拦截函数`set`之中,会自动执行所有观察者。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/regex.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/regex.md" new file mode 100755 index 000000000..9fa854fa2 --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/regex.md" @@ -0,0 +1,636 @@ +# 正则的扩展 + +## RegExp 构造函数 + +在 ES5 中,`RegExp`构造函数的参数有两种情况。 + +第一种情况是,参数是字符串,这时第二个参数表示正则表达式的修饰符(flag)。 + +```javascript +var regex = new RegExp('xyz', 'i'); +// 等价于 +var regex = /xyz/i; +``` + +第二种情况是,参数是一个正则表示式,这时会返回一个原有正则表达式的拷贝。 + +```javascript +var regex = new RegExp(/xyz/i); +// 等价于 +var regex = /xyz/i; +``` + +但是,ES5 不允许此时使用第二个参数添加修饰符,否则会报错。 + +```javascript +var regex = new RegExp(/xyz/, 'i'); +// Uncaught TypeError: Cannot supply flags when constructing one RegExp from another +``` + +ES6 改变了这种行为。如果`RegExp`构造函数第一个参数是一个正则对象,那么可以使用第二个参数指定修饰符。而且,返回的正则表达式会忽略原有的正则表达式的修饰符,只使用新指定的修饰符。 + +```javascript +new RegExp(/abc/ig, 'i').flags +// "i" +``` + +上面代码中,原有正则对象的修饰符是`ig`,它会被第二个参数`i`覆盖。 + +## 字符串的正则方法 + +字符串对象共有 4 个方法,可以使用正则表达式:`match()`、`replace()`、`search()`和`split()`。 + +ES6 将这 4 个方法,在语言内部全部调用`RegExp`的实例方法,从而做到所有与正则相关的方法,全都定义在`RegExp`对象上。 + +- `String.prototype.match` 调用 `RegExp.prototype[Symbol.match]` +- `String.prototype.replace` 调用 `RegExp.prototype[Symbol.replace]` +- `String.prototype.search` 调用 `RegExp.prototype[Symbol.search]` +- `String.prototype.split` 调用 `RegExp.prototype[Symbol.split]` + +## u 修饰符 + +ES6 对正则表达式添加了`u`修饰符,含义为“Unicode 模式”,用来正确处理大于`\uFFFF`的 Unicode 字符。也就是说,会正确处理四个字节的 UTF-16 编码。 + +```javascript +/^\uD83D/u.test('\uD83D\uDC2A') // false +/^\uD83D/.test('\uD83D\uDC2A') // true +``` + +上面代码中,`\uD83D\uDC2A`是一个四个字节的 UTF-16 编码,代表一个字符。但是,ES5 不支持四个字节的 UTF-16 编码,会将其识别为两个字符,导致第二行代码结果为`true`。加了`u`修饰符以后,ES6 就会识别其为一个字符,所以第一行代码结果为`false`。 + +一旦加上`u`修饰符号,就会修改下面这些正则表达式的行为。 + +**(1)点字符** + +点(`.`)字符在正则表达式中,含义是除了换行符以外的任意单个字符。对于码点大于`0xFFFF`的 Unicode 字符,点字符不能识别,必须加上`u`修饰符。 + +```javascript +var s = '𠮷'; + +/^.$/.test(s) // false +/^.$/u.test(s) // true +``` + +上面代码表示,如果不添加`u`修饰符,正则表达式就会认为字符串为两个字符,从而匹配失败。 + +**(2)Unicode 字符表示法** + +ES6 新增了使用大括号表示 Unicode 字符,这种表示法在正则表达式中必须加上`u`修饰符,才能识别当中的大括号,否则会被解读为量词。 + +```javascript +/\u{61}/.test('a') // false +/\u{61}/u.test('a') // true +/\u{20BB7}/u.test('𠮷') // true +``` + +上面代码表示,如果不加`u`修饰符,正则表达式无法识别`\u{61}`这种表示法,只会认为这匹配 61 个连续的`u`。 + +**(3)量词** + +使用`u`修饰符后,所有量词都会正确识别码点大于`0xFFFF`的 Unicode 字符。 + +```javascript +/a{2}/.test('aa') // true +/a{2}/u.test('aa') // true +/𠮷{2}/.test('𠮷𠮷') // false +/𠮷{2}/u.test('𠮷𠮷') // true +``` + +**(4)预定义模式** + +`u`修饰符也影响到预定义模式,能否正确识别码点大于`0xFFFF`的 Unicode 字符。 + +```javascript +/^\S$/.test('𠮷') // false +/^\S$/u.test('𠮷') // true +``` + +上面代码的`\S`是预定义模式,匹配所有非空白字符。只有加了`u`修饰符,它才能正确匹配码点大于`0xFFFF`的 Unicode 字符。 + +利用这一点,可以写出一个正确返回字符串长度的函数。 + +```javascript +function codePointLength(text) { + var result = text.match(/[\s\S]/gu); + return result ? result.length : 0; +} + +var s = '𠮷𠮷'; + +s.length // 4 +codePointLength(s) // 2 +``` + +**(5)i 修饰符** + +有些 Unicode 字符的编码不同,但是字型很相近,比如,`\u004B`与`\u212A`都是大写的`K`。 + +```javascript +/[a-z]/i.test('\u212A') // false +/[a-z]/iu.test('\u212A') // true +``` + +上面代码中,不加`u`修饰符,就无法识别非规范的`K`字符。 + +## RegExp.prototype.unicode 属性 + +正则实例对象新增`unicode`属性,表示是否设置了`u`修饰符。 + +```javascript +const r1 = /hello/; +const r2 = /hello/u; + +r1.unicode // false +r2.unicode // true +``` + +上面代码中,正则表达式是否设置了`u`修饰符,可以从`unicode`属性看出来。 + +## y 修饰符 + +除了`u`修饰符,ES6 还为正则表达式添加了`y`修饰符,叫做“粘连”(sticky)修饰符。 + +`y`修饰符的作用与`g`修饰符类似,也是全局匹配,后一次匹配都从上一次匹配成功的下一个位置开始。不同之处在于,`g`修饰符只要剩余位置中存在匹配就可,而`y`修饰符确保匹配必须从剩余的第一个位置开始,这也就是“粘连”的涵义。 + +```javascript +var s = 'aaa_aa_a'; +var r1 = /a+/g; +var r2 = /a+/y; + +r1.exec(s) // ["aaa"] +r2.exec(s) // ["aaa"] + +r1.exec(s) // ["aa"] +r2.exec(s) // null +``` + +上面代码有两个正则表达式,一个使用`g`修饰符,另一个使用`y`修饰符。这两个正则表达式各执行了两次,第一次执行的时候,两者行为相同,剩余字符串都是`_aa_a`。由于`g`修饰没有位置要求,所以第二次执行会返回结果,而`y`修饰符要求匹配必须从头部开始,所以返回`null`。 + +如果改一下正则表达式,保证每次都能头部匹配,`y`修饰符就会返回结果了。 + +```javascript +var s = 'aaa_aa_a'; +var r = /a+_/y; + +r.exec(s) // ["aaa_"] +r.exec(s) // ["aa_"] +``` + +上面代码每次匹配,都是从剩余字符串的头部开始。 + +使用`lastIndex`属性,可以更好地说明`y`修饰符。 + +```javascript +const REGEX = /a/g; + +// 指定从2号位置(y)开始匹配 +REGEX.lastIndex = 2; + +// 匹配成功 +const match = REGEX.exec('xaya'); + +// 在3号位置匹配成功 +match.index // 3 + +// 下一次匹配从4号位开始 +REGEX.lastIndex // 4 + +// 4号位开始匹配失败 +REGEX.exec('xaya') // null +``` + +上面代码中,`lastIndex`属性指定每次搜索的开始位置,`g`修饰符从这个位置开始向后搜索,直到发现匹配为止。 + +`y`修饰符同样遵守`lastIndex`属性,但是要求必须在`lastIndex`指定的位置发现匹配。 + +```javascript +const REGEX = /a/y; + +// 指定从2号位置开始匹配 +REGEX.lastIndex = 2; + +// 不是粘连,匹配失败 +REGEX.exec('xaya') // null + +// 指定从3号位置开始匹配 +REGEX.lastIndex = 3; + +// 3号位置是粘连,匹配成功 +const match = REGEX.exec('xaya'); +match.index // 3 +REGEX.lastIndex // 4 +``` + +实际上,`y`修饰符号隐含了头部匹配的标志`^`。 + +```javascript +/b/y.exec('aba') +// null +``` + +上面代码由于不能保证头部匹配,所以返回`null`。`y`修饰符的设计本意,就是让头部匹配的标志`^`在全局匹配中都有效。 + +下面是字符串对象的`replace`方法的例子。 + +```javascript +const REGEX = /a/gy; +'aaxa'.replace(REGEX, '-') // '--xa' +``` + +上面代码中,最后一个`a`因为不是出现在下一次匹配的头部,所以不会被替换。 + +单单一个`y`修饰符对`match`方法,只能返回第一个匹配,必须与`g`修饰符联用,才能返回所有匹配。 + +```javascript +'a1a2a3'.match(/a\d/y) // ["a1"] +'a1a2a3'.match(/a\d/gy) // ["a1", "a2", "a3"] +``` + +`y`修饰符的一个应用,是从字符串提取 token(词元),`y`修饰符确保了匹配之间不会有漏掉的字符。 + +```javascript +const TOKEN_Y = /\s*(\+|[0-9]+)\s*/y; +const TOKEN_G = /\s*(\+|[0-9]+)\s*/g; + +tokenize(TOKEN_Y, '3 + 4') +// [ '3', '+', '4' ] +tokenize(TOKEN_G, '3 + 4') +// [ '3', '+', '4' ] + +function tokenize(TOKEN_REGEX, str) { + let result = []; + let match; + while (match = TOKEN_REGEX.exec(str)) { + result.push(match[1]); + } + return result; +} +``` + +上面代码中,如果字符串里面没有非法字符,`y`修饰符与`g`修饰符的提取结果是一样的。但是,一旦出现非法字符,两者的行为就不一样了。 + +```javascript +tokenize(TOKEN_Y, '3x + 4') +// [ '3' ] +tokenize(TOKEN_G, '3x + 4') +// [ '3', '+', '4' ] +``` + +上面代码中,`g`修饰符会忽略非法字符,而`y`修饰符不会,这样就很容易发现错误。 + +## RegExp.prototype.sticky 属性 + +与`y`修饰符相匹配,ES6 的正则实例对象多了`sticky`属性,表示是否设置了`y`修饰符。 + +```javascript +var r = /hello\d/y; +r.sticky // true +``` + +## RegExp.prototype.flags 属性 + +ES6 为正则表达式新增了`flags`属性,会返回正则表达式的修饰符。 + +```javascript +// ES5 的 source 属性 +// 返回正则表达式的正文 +/abc/ig.source +// "abc" + +// ES6 的 flags 属性 +// 返回正则表达式的修饰符 +/abc/ig.flags +// 'gi' +``` + +## s 修饰符:dotAll 模式 + +正则表达式中,点(`.`)是一个特殊字符,代表任意的单个字符,但是有两个例外。一个是四个字节的 UTF-16 字符,这个可以用`u`修饰符解决;另一个是行终止符(line terminator character)。 + +所谓行终止符,就是该字符表示一行的终结。以下四个字符属于“行终止符”。 + +- U+000A 换行符(`\n`) +- U+000D 回车符(`\r`) +- U+2028 行分隔符(line separator) +- U+2029 段分隔符(paragraph separator) + +```javascript +/foo.bar/.test('foo\nbar') +// false +``` + +上面代码中,因为`.`不匹配`\n`,所以正则表达式返回`false`。 + +但是,很多时候我们希望匹配的是任意单个字符,这时有一种变通的写法。 + +```javascript +/foo[^]bar/.test('foo\nbar') +// true +``` + +这种解决方案毕竟不太符合直觉,ES2018 [引入](https://github.com/tc39/proposal-regexp-dotall-flag)`s`修饰符,使得`.`可以匹配任意单个字符。 + +```javascript +/foo.bar/s.test('foo\nbar') // true +``` + +这被称为`dotAll`模式,即点(dot)代表一切字符。所以,正则表达式还引入了一个`dotAll`属性,返回一个布尔值,表示该正则表达式是否处在`dotAll`模式。 + +```javascript +const re = /foo.bar/s; +// 另一种写法 +// const re = new RegExp('foo.bar', 's'); + +re.test('foo\nbar') // true +re.dotAll // true +re.flags // 's' +``` + +`/s`修饰符和多行修饰符`/m`不冲突,两者一起使用的情况下,`.`匹配所有字符,而`^`和`$`匹配每一行的行首和行尾。 + +## 后行断言 + +JavaScript 语言的正则表达式,只支持先行断言(lookahead)和先行否定断言(negative lookahead),不支持后行断言(lookbehind)和后行否定断言(negative lookbehind)。ES2018 引入[后行断言](https://github.com/tc39/proposal-regexp-lookbehind),V8 引擎 4.9 版(Chrome 62)已经支持。 + +“先行断言”指的是,`x`只有在`y`前面才匹配,必须写成`/x(?=y)/`。比如,只匹配百分号之前的数字,要写成`/\d+(?=%)/`。“先行否定断言”指的是,`x`只有不在`y`前面才匹配,必须写成`/x(?!y)/`。比如,只匹配不在百分号之前的数字,要写成`/\d+(?!%)/`。 + +```javascript +/\d+(?=%)/.exec('100% of US presidents have been male') // ["100"] +/\d+(?!%)/.exec('that’s all 44 of them') // ["44"] +``` + +上面两个字符串,如果互换正则表达式,就不会得到相同结果。另外,还可以看到,“先行断言”括号之中的部分(`(?=%)`),是不计入返回结果的。 + +“后行断言”正好与“先行断言”相反,`x`只有在`y`后面才匹配,必须写成`/(?<=y)x/`。比如,只匹配美元符号之后的数字,要写成`/(?<=\$)\d+/`。“后行否定断言”则与“先行否定断言”相反,`x`只有不在`y`后面才匹配,必须写成`/(?\d{4})-(?\d{2})-(?\d{2})/; + +const matchObj = RE_DATE.exec('1999-12-31'); +const year = matchObj.groups.year; // 1999 +const month = matchObj.groups.month; // 12 +const day = matchObj.groups.day; // 31 +``` + +上面代码中,“具名组匹配”在圆括号内部,模式的头部添加“问号 + 尖括号 + 组名”(`?`),然后就可以在`exec`方法返回结果的`groups`属性上引用该组名。同时,数字序号(`matchObj[1]`)依然有效。 + +具名组匹配等于为每一组匹配加上了 ID,便于描述匹配的目的。如果组的顺序变了,也不用改变匹配后的处理代码。 + +如果具名组没有匹配,那么对应的`groups`对象属性会是`undefined`。 + +```javascript +const RE_OPT_A = /^(?a+)?$/; +const matchObj = RE_OPT_A.exec(''); + +matchObj.groups.as // undefined +'as' in matchObj.groups // true +``` + +上面代码中,具名组`as`没有找到匹配,那么`matchObj.groups.as`属性值就是`undefined`,并且`as`这个键名在`groups`是始终存在的。 + +### 解构赋值和替换 + +有了具名组匹配以后,可以使用解构赋值直接从匹配结果上为变量赋值。 + +```javascript +let {groups: {one, two}} = /^(?.*):(?.*)$/u.exec('foo:bar'); +one // foo +two // bar +``` + +字符串替换时,使用`$<组名>`引用具名组。 + +```javascript +let re = /(?\d{4})-(?\d{2})-(?\d{2})/u; + +'2015-01-02'.replace(re, '$/$/$') +// '02/01/2015' +``` + +上面代码中,`replace`方法的第二个参数是一个字符串,而不是正则表达式。 + +`replace`方法的第二个参数也可以是函数,该函数的参数序列如下。 + +```javascript +'2015-01-02'.replace(re, ( + matched, // 整个匹配结果 2015-01-02 + capture1, // 第一个组匹配 2015 + capture2, // 第二个组匹配 01 + capture3, // 第三个组匹配 02 + position, // 匹配开始的位置 0 + S, // 原字符串 2015-01-02 + groups // 具名组构成的一个对象 {year, month, day} + ) => { + let {day, month, year} = groups; + return `${day}/${month}/${year}`; +}); +``` + +具名组匹配在原来的基础上,新增了最后一个函数参数:具名组构成的一个对象。函数内部可以直接对这个对象进行解构赋值。 + +### 引用 + +如果要在正则表达式内部引用某个“具名组匹配”,可以使用`\k<组名>`的写法。 + +```javascript +const RE_TWICE = /^(?[a-z]+)!\k$/; +RE_TWICE.test('abc!abc') // true +RE_TWICE.test('abc!ab') // false +``` + +数字引用(`\1`)依然有效。 + +```javascript +const RE_TWICE = /^(?[a-z]+)!\1$/; +RE_TWICE.test('abc!abc') // true +RE_TWICE.test('abc!ab') // false +``` + +这两种引用语法还可以同时使用。 + +```javascript +const RE_TWICE = /^(?[a-z]+)!\k!\1$/; +RE_TWICE.test('abc!abc!abc') // true +RE_TWICE.test('abc!abc!ab') // false +``` + +## String.prototype.matchAll + +如果一个正则表达式在字符串里面有多个匹配,现在一般使用`g`修饰符或`y`修饰符,在循环里面逐一取出。 + +```javascript +var regex = /t(e)(st(\d?))/g; +var string = 'test1test2test3'; + +var matches = []; +var match; +while (match = regex.exec(string)) { + matches.push(match); +} + +matches +// [ +// ["test1", "e", "st1", "1", index: 0, input: "test1test2test3"], +// ["test2", "e", "st2", "2", index: 5, input: "test1test2test3"], +// ["test3", "e", "st3", "3", index: 10, input: "test1test2test3"] +// ] +``` + +上面代码中,`while`循环取出每一轮的正则匹配,一共三轮。 + +目前有一个[提案](https://github.com/tc39/proposal-string-matchall),增加了`String.prototype.matchAll`方法,可以一次性取出所有匹配。不过,它返回的是一个遍历器(Iterator),而不是数组。 + +```javascript +const string = 'test1test2test3'; + +// g 修饰符加不加都可以 +const regex = /t(e)(st(\d?))/g; + +for (const match of string.matchAll(regex)) { + console.log(match); +} +// ["test1", "e", "st1", "1", index: 0, input: "test1test2test3"] +// ["test2", "e", "st2", "2", index: 5, input: "test1test2test3"] +// ["test3", "e", "st3", "3", index: 10, input: "test1test2test3"] +``` + +上面代码中,由于`string.matchAll(regex)`返回的是遍历器,所以可以用`for...of`循环取出。相对于返回数组,返回遍历器的好处在于,如果匹配结果是一个很大的数组,那么遍历器比较节省资源。 + +遍历器转为数组是非常简单的,使用`...`运算符和`Array.from`方法就可以了。 + +```javascript +// 转为数组方法一 +[...string.matchAll(regex)] + +// 转为数组方法二 +Array.from(string.matchAll(regex)); +``` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/set-map.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/set-map.md" new file mode 100755 index 000000000..29afcc7da --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/set-map.md" @@ -0,0 +1,1128 @@ +# Set 和 Map 数据结构 + +## Set + +### 基本用法 + +ES6 提供了新的数据结构 Set。它类似于数组,但是成员的值都是唯一的,没有重复的值。 + +`Set`本身是一个构造函数,用来生成 Set 数据结构。 + +```javascript +const s = new Set(); + +[2, 3, 5, 4, 5, 2, 2].forEach(x => s.add(x)); + +for (let i of s) { + console.log(i); +} +// 2 3 5 4 +``` + +上面代码通过`add()`方法向 Set 结构加入成员,结果表明 Set 结构不会添加重复的值。 + +`Set`函数可以接受一个数组(或者具有 iterable 接口的其他数据结构)作为参数,用来初始化。 + +```javascript +// 例一 +const set = new Set([1, 2, 3, 4, 4]); +[...set] +// [1, 2, 3, 4] + +// 例二 +const items = new Set([1, 2, 3, 4, 5, 5, 5, 5]); +items.size // 5 + +// 例三 +const set = new Set(document.querySelectorAll('div')); +set.size // 56 + +// 类似于 +const set = new Set(); +document + .querySelectorAll('div') + .forEach(div => set.add(div)); +set.size // 56 +``` + +上面代码中,例一和例二都是`Set`函数接受数组作为参数,例三是接受类似数组的对象作为参数。 + +上面代码也展示了一种去除数组重复成员的方法。 + +```javascript +// 去除数组的重复成员 +[...new Set(array)] +``` + +上面的方法也可以用于,去除字符串里面的重复字符。 + +```javascript +[...new Set('ababbc')].join('') +// "abc" +``` + +向 Set 加入值的时候,不会发生类型转换,所以`5`和`"5"`是两个不同的值。Set 内部判断两个值是否不同,使用的算法叫做“Same-value-zero equality”,它类似于精确相等运算符(`===`),主要的区别是`NaN`等于自身,而精确相等运算符认为`NaN`不等于自身。 + +```javascript +let set = new Set(); +let a = NaN; +let b = NaN; +set.add(a); +set.add(b); +set // Set {NaN} +``` + +上面代码向 Set 实例添加了两个`NaN`,但是只能加入一个。这表明,在 Set 内部,两个`NaN`是相等。 + +另外,两个对象总是不相等的。 + +```javascript +let set = new Set(); + +set.add({}); +set.size // 1 + +set.add({}); +set.size // 2 +``` + +上面代码表示,由于两个空对象不相等,所以它们被视为两个值。 + +### Set 实例的属性和方法 + +Set 结构的实例有以下属性。 + +- `Set.prototype.constructor`:构造函数,默认就是`Set`函数。 +- `Set.prototype.size`:返回`Set`实例的成员总数。 + +Set 实例的方法分为两大类:操作方法(用于操作数据)和遍历方法(用于遍历成员)。下面先介绍四个操作方法。 + +- `add(value)`:添加某个值,返回 Set 结构本身。 +- `delete(value)`:删除某个值,返回一个布尔值,表示删除是否成功。 +- `has(value)`:返回一个布尔值,表示该值是否为`Set`的成员。 +- `clear()`:清除所有成员,没有返回值。 + +上面这些属性和方法的实例如下。 + +```javascript +s.add(1).add(2).add(2); +// 注意2被加入了两次 + +s.size // 2 + +s.has(1) // true +s.has(2) // true +s.has(3) // false + +s.delete(2); +s.has(2) // false +``` + +下面是一个对比,看看在判断是否包括一个键上面,`Object`结构和`Set`结构的写法不同。 + +```javascript +// 对象的写法 +const properties = { + 'width': 1, + 'height': 1 +}; + +if (properties[someName]) { + // do something +} + +// Set的写法 +const properties = new Set(); + +properties.add('width'); +properties.add('height'); + +if (properties.has(someName)) { + // do something +} +``` + +`Array.from`方法可以将 Set 结构转为数组。 + +```javascript +const items = new Set([1, 2, 3, 4, 5]); +const array = Array.from(items); +``` + +这就提供了去除数组重复成员的另一种方法。 + +```javascript +function dedupe(array) { + return Array.from(new Set(array)); +} + +dedupe([1, 1, 2, 3]) // [1, 2, 3] +``` + +### 遍历操作 + +Set 结构的实例有四个遍历方法,可以用于遍历成员。 + +- `keys()`:返回键名的遍历器 +- `values()`:返回键值的遍历器 +- `entries()`:返回键值对的遍历器 +- `forEach()`:使用回调函数遍历每个成员 + +需要特别指出的是,`Set`的遍历顺序就是插入顺序。这个特性有时非常有用,比如使用 Set 保存一个回调函数列表,调用时就能保证按照添加顺序调用。 + +**(1)`keys()`,`values()`,`entries()`** + +`keys`方法、`values`方法、`entries`方法返回的都是遍历器对象(详见《Iterator 对象》一章)。由于 Set 结构没有键名,只有键值(或者说键名和键值是同一个值),所以`keys`方法和`values`方法的行为完全一致。 + +```javascript +let set = new Set(['red', 'green', 'blue']); + +for (let item of set.keys()) { + console.log(item); +} +// red +// green +// blue + +for (let item of set.values()) { + console.log(item); +} +// red +// green +// blue + +for (let item of set.entries()) { + console.log(item); +} +// ["red", "red"] +// ["green", "green"] +// ["blue", "blue"] +``` + +上面代码中,`entries`方法返回的遍历器,同时包括键名和键值,所以每次输出一个数组,它的两个成员完全相等。 + +Set 结构的实例默认可遍历,它的默认遍历器生成函数就是它的`values`方法。 + +```javascript +Set.prototype[Symbol.iterator] === Set.prototype.values +// true +``` + +这意味着,可以省略`values`方法,直接用`for...of`循环遍历 Set。 + +```javascript +let set = new Set(['red', 'green', 'blue']); + +for (let x of set) { + console.log(x); +} +// red +// green +// blue +``` + +**(2)`forEach()`** + +Set 结构的实例与数组一样,也拥有`forEach`方法,用于对每个成员执行某种操作,没有返回值。 + +```javascript +let set = new Set([1, 4, 9]); +set.forEach((value, key) => console.log(key + ' : ' + value)) +// 1 : 1 +// 4 : 4 +// 9 : 9 +``` + +上面代码说明,`forEach`方法的参数就是一个处理函数。该函数的参数与数组的`forEach`一致,依次为键值、键名、集合本身(上例省略了该参数)。这里需要注意,Set 结构的键名就是键值(两者是同一个值),因此第一个参数与第二个参数的值永远都是一样的。 + +另外,`forEach`方法还可以有第二个参数,表示绑定处理函数内部的`this`对象。 + +**(3)遍历的应用** + +扩展运算符(`...`)内部使用`for...of`循环,所以也可以用于 Set 结构。 + +```javascript +let set = new Set(['red', 'green', 'blue']); +let arr = [...set]; +// ['red', 'green', 'blue'] +``` + +扩展运算符和 Set 结构相结合,就可以去除数组的重复成员。 + +```javascript +let arr = [3, 5, 2, 2, 5, 5]; +let unique = [...new Set(arr)]; +// [3, 5, 2] +``` + +而且,数组的`map`和`filter`方法也可以间接用于 Set 了。 + +```javascript +let set = new Set([1, 2, 3]); +set = new Set([...set].map(x => x * 2)); +// 返回Set结构:{2, 4, 6} + +let set = new Set([1, 2, 3, 4, 5]); +set = new Set([...set].filter(x => (x % 2) == 0)); +// 返回Set结构:{2, 4} +``` + +因此使用 Set 可以很容易地实现并集(Union)、交集(Intersect)和差集(Difference)。 + +```javascript +let a = new Set([1, 2, 3]); +let b = new Set([4, 3, 2]); + +// 并集 +let union = new Set([...a, ...b]); +// Set {1, 2, 3, 4} + +// 交集 +let intersect = new Set([...a].filter(x => b.has(x))); +// set {2, 3} + +// 差集 +let difference = new Set([...a].filter(x => !b.has(x))); +// Set {1} +``` + +如果想在遍历操作中,同步改变原来的 Set 结构,目前没有直接的方法,但有两种变通方法。一种是利用原 Set 结构映射出一个新的结构,然后赋值给原来的 Set 结构;另一种是利用`Array.from`方法。 + +```javascript +// 方法一 +let set = new Set([1, 2, 3]); +set = new Set([...set].map(val => val * 2)); +// set的值是2, 4, 6 + +// 方法二 +let set = new Set([1, 2, 3]); +set = new Set(Array.from(set, val => val * 2)); +// set的值是2, 4, 6 +``` + +上面代码提供了两种方法,直接在遍历操作中改变原来的 Set 结构。 + +## WeakSet + +### 含义 + +WeakSet 结构与 Set 类似,也是不重复的值的集合。但是,它与 Set 有两个区别。 + +首先,WeakSet 的成员只能是对象,而不能是其他类型的值。 + +```javascript +const ws = new WeakSet(); +ws.add(1) +// TypeError: Invalid value used in weak set +ws.add(Symbol()) +// TypeError: invalid value used in weak set +``` + +上面代码试图向 WeakSet 添加一个数值和`Symbol`值,结果报错,因为 WeakSet 只能放置对象。 + +其次,WeakSet 中的对象都是弱引用,即垃圾回收机制不考虑 WeakSet 对该对象的引用,也就是说,如果其他对象都不再引用该对象,那么垃圾回收机制会自动回收该对象所占用的内存,不考虑该对象还存在于 WeakSet 之中。 + +这是因为垃圾回收机制依赖引用计数,如果一个值的引用次数不为`0`,垃圾回收机制就不会释放这块内存。结束使用该值之后,有时会忘记取消引用,导致内存无法释放,进而可能会引发内存泄漏。WeakSet 里面的引用,都不计入垃圾回收机制,所以就不存在这个问题。因此,WeakSet 适合临时存放一组对象,以及存放跟对象绑定的信息。只要这些对象在外部消失,它在 WeakSet 里面的引用就会自动消失。 + +由于上面这个特点,WeakSet 的成员是不适合引用的,因为它会随时消失。另外,由于 WeakSet 内部有多少个成员,取决于垃圾回收机制有没有运行,运行前后很可能成员个数是不一样的,而垃圾回收机制何时运行是不可预测的,因此 ES6 规定 WeakSet 不可遍历。 + +这些特点同样适用于本章后面要介绍的 WeakMap 结构。 + +### 语法 + +WeakSet 是一个构造函数,可以使用`new`命令,创建 WeakSet 数据结构。 + +```javascript +const ws = new WeakSet(); +``` + +作为构造函数,WeakSet 可以接受一个数组或类似数组的对象作为参数。(实际上,任何具有 Iterable 接口的对象,都可以作为 WeakSet 的参数。)该数组的所有成员,都会自动成为 WeakSet 实例对象的成员。 + +```javascript +const a = [[1, 2], [3, 4]]; +const ws = new WeakSet(a); +// WeakSet {[1, 2], [3, 4]} +``` + +上面代码中,`a`是一个数组,它有两个成员,也都是数组。将`a`作为 WeakSet 构造函数的参数,`a`的成员会自动成为 WeakSet 的成员。 + +注意,是`a`数组的成员成为 WeakSet 的成员,而不是`a`数组本身。这意味着,数组的成员只能是对象。 + +```javascript +const b = [3, 4]; +const ws = new WeakSet(b); +// Uncaught TypeError: Invalid value used in weak set(…) +``` + +上面代码中,数组`b`的成员不是对象,加入 WeaKSet 就会报错。 + +WeakSet 结构有以下三个方法。 + +- **WeakSet.prototype.add(value)**:向 WeakSet 实例添加一个新成员。 +- **WeakSet.prototype.delete(value)**:清除 WeakSet 实例的指定成员。 +- **WeakSet.prototype.has(value)**:返回一个布尔值,表示某个值是否在 WeakSet 实例之中。 + +下面是一个例子。 + +```javascript +const ws = new WeakSet(); +const obj = {}; +const foo = {}; + +ws.add(window); +ws.add(obj); + +ws.has(window); // true +ws.has(foo); // false + +ws.delete(window); +ws.has(window); // false +``` + +WeakSet 没有`size`属性,没有办法遍历它的成员。 + +```javascript +ws.size // undefined +ws.forEach // undefined + +ws.forEach(function(item){ console.log('WeakSet has ' + item)}) +// TypeError: undefined is not a function +``` + +上面代码试图获取`size`和`forEach`属性,结果都不能成功。 + +WeakSet 不能遍历,是因为成员都是弱引用,随时可能消失,遍历机制无法保证成员的存在,很可能刚刚遍历结束,成员就取不到了。WeakSet 的一个用处,是储存 DOM 节点,而不用担心这些节点从文档移除时,会引发内存泄漏。 + +下面是 WeakSet 的另一个例子。 + +```javascript +const foos = new WeakSet() +class Foo { + constructor() { + foos.add(this) + } + method () { + if (!foos.has(this)) { + throw new TypeError('Foo.prototype.method 只能在Foo的实例上调用!'); + } + } +} +``` + +上面代码保证了`Foo`的实例方法,只能在`Foo`的实例上调用。这里使用 WeakSet 的好处是,`foos`对实例的引用,不会被计入内存回收机制,所以删除实例的时候,不用考虑`foos`,也不会出现内存泄漏。 + +## Map + +### 含义和基本用法 + +JavaScript 的对象(Object),本质上是键值对的集合(Hash 结构),但是传统上只能用字符串当作键。这给它的使用带来了很大的限制。 + +```javascript +const data = {}; +const element = document.getElementById('myDiv'); + +data[element] = 'metadata'; +data['[object HTMLDivElement]'] // "metadata" +``` + +上面代码原意是将一个 DOM 节点作为对象`data`的键,但是由于对象只接受字符串作为键名,所以`element`被自动转为字符串`[object HTMLDivElement]`。 + +为了解决这个问题,ES6 提供了 Map 数据结构。它类似于对象,也是键值对的集合,但是“键”的范围不限于字符串,各种类型的值(包括对象)都可以当作键。也就是说,Object 结构提供了“字符串—值”的对应,Map 结构提供了“值—值”的对应,是一种更完善的 Hash 结构实现。如果你需要“键值对”的数据结构,Map 比 Object 更合适。 + +```javascript +const m = new Map(); +const o = {p: 'Hello World'}; + +m.set(o, 'content') +m.get(o) // "content" + +m.has(o) // true +m.delete(o) // true +m.has(o) // false +``` + +上面代码使用 Map 结构的`set`方法,将对象`o`当作`m`的一个键,然后又使用`get`方法读取这个键,接着使用`delete`方法删除了这个键。 + +上面的例子展示了如何向 Map 添加成员。作为构造函数,Map 也可以接受一个数组作为参数。该数组的成员是一个个表示键值对的数组。 + +```javascript +const map = new Map([ + ['name', '张三'], + ['title', 'Author'] +]); + +map.size // 2 +map.has('name') // true +map.get('name') // "张三" +map.has('title') // true +map.get('title') // "Author" +``` + +上面代码在新建 Map 实例时,就指定了两个键`name`和`title`。 + +`Map`构造函数接受数组作为参数,实际上执行的是下面的算法。 + +```javascript +const items = [ + ['name', '张三'], + ['title', 'Author'] +]; + +const map = new Map(); + +items.forEach( + ([key, value]) => map.set(key, value) +); +``` + +事实上,不仅仅是数组,任何具有 Iterator 接口、且每个成员都是一个双元素的数组的数据结构(详见《Iterator》一章)都可以当作`Map`构造函数的参数。这就是说,`Set`和`Map`都可以用来生成新的 Map。 + +```javascript +const set = new Set([ + ['foo', 1], + ['bar', 2] +]); +const m1 = new Map(set); +m1.get('foo') // 1 + +const m2 = new Map([['baz', 3]]); +const m3 = new Map(m2); +m3.get('baz') // 3 +``` + +上面代码中,我们分别使用 Set 对象和 Map 对象,当作`Map`构造函数的参数,结果都生成了新的 Map 对象。 + +如果对同一个键多次赋值,后面的值将覆盖前面的值。 + +```javascript +const map = new Map(); + +map +.set(1, 'aaa') +.set(1, 'bbb'); + +map.get(1) // "bbb" +``` + +上面代码对键`1`连续赋值两次,后一次的值覆盖前一次的值。 + +如果读取一个未知的键,则返回`undefined`。 + +```javascript +new Map().get('asfddfsasadf') +// undefined +``` + +注意,只有对同一个对象的引用,Map 结构才将其视为同一个键。这一点要非常小心。 + +```javascript +const map = new Map(); + +map.set(['a'], 555); +map.get(['a']) // undefined +``` + +上面代码的`set`和`get`方法,表面是针对同一个键,但实际上这是两个值,内存地址是不一样的,因此`get`方法无法读取该键,返回`undefined`。 + +同理,同样的值的两个实例,在 Map 结构中被视为两个键。 + +```javascript +const map = new Map(); + +const k1 = ['a']; +const k2 = ['a']; + +map +.set(k1, 111) +.set(k2, 222); + +map.get(k1) // 111 +map.get(k2) // 222 +``` + +上面代码中,变量`k1`和`k2`的值是一样的,但是它们在 Map 结构中被视为两个键。 + +由上可知,Map 的键实际上是跟内存地址绑定的,只要内存地址不一样,就视为两个键。这就解决了同名属性碰撞(clash)的问题,我们扩展别人的库的时候,如果使用对象作为键名,就不用担心自己的属性与原作者的属性同名。 + +如果 Map 的键是一个简单类型的值(数字、字符串、布尔值),则只要两个值严格相等,Map 将其视为一个键,比如`0`和`-0`就是一个键,布尔值`true`和字符串`true`则是两个不同的键。另外,`undefined`和`null`也是两个不同的键。虽然`NaN`不严格相等于自身,但 Map 将其视为同一个键。 + +```javascript +let map = new Map(); + +map.set(-0, 123); +map.get(+0) // 123 + +map.set(true, 1); +map.set('true', 2); +map.get(true) // 1 + +map.set(undefined, 3); +map.set(null, 4); +map.get(undefined) // 3 + +map.set(NaN, 123); +map.get(NaN) // 123 +``` + +### 实例的属性和操作方法 + +Map 结构的实例有以下属性和操作方法。 + +**(1)size 属性** + +`size`属性返回 Map 结构的成员总数。 + +```javascript +const map = new Map(); +map.set('foo', true); +map.set('bar', false); + +map.size // 2 +``` + +**(2)set(key, value)** + +`set`方法设置键名`key`对应的键值为`value`,然后返回整个 Map 结构。如果`key`已经有值,则键值会被更新,否则就新生成该键。 + +```javascript +const m = new Map(); + +m.set('edition', 6) // 键是字符串 +m.set(262, 'standard') // 键是数值 +m.set(undefined, 'nah') // 键是 undefined +``` + +`set`方法返回的是当前的`Map`对象,因此可以采用链式写法。 + +```javascript +let map = new Map() + .set(1, 'a') + .set(2, 'b') + .set(3, 'c'); +``` + +**(3)get(key)** + +`get`方法读取`key`对应的键值,如果找不到`key`,返回`undefined`。 + +```javascript +const m = new Map(); + +const hello = function() {console.log('hello');}; +m.set(hello, 'Hello ES6!') // 键是函数 + +m.get(hello) // Hello ES6! +``` + +**(4)has(key)** + +`has`方法返回一个布尔值,表示某个键是否在当前 Map 对象之中。 + +```javascript +const m = new Map(); + +m.set('edition', 6); +m.set(262, 'standard'); +m.set(undefined, 'nah'); + +m.has('edition') // true +m.has('years') // false +m.has(262) // true +m.has(undefined) // true +``` + +**(5)delete(key)** + +`delete`方法删除某个键,返回`true`。如果删除失败,返回`false`。 + +```javascript +const m = new Map(); +m.set(undefined, 'nah'); +m.has(undefined) // true + +m.delete(undefined) +m.has(undefined) // false +``` + +**(6)clear()** + +`clear`方法清除所有成员,没有返回值。 + +```javascript +let map = new Map(); +map.set('foo', true); +map.set('bar', false); + +map.size // 2 +map.clear() +map.size // 0 +``` + +### 遍历方法 + +Map 结构原生提供三个遍历器生成函数和一个遍历方法。 + +- `keys()`:返回键名的遍历器。 +- `values()`:返回键值的遍历器。 +- `entries()`:返回所有成员的遍历器。 +- `forEach()`:遍历 Map 的所有成员。 + +需要特别注意的是,Map 的遍历顺序就是插入顺序。 + +```javascript +const map = new Map([ + ['F', 'no'], + ['T', 'yes'], +]); + +for (let key of map.keys()) { + console.log(key); +} +// "F" +// "T" + +for (let value of map.values()) { + console.log(value); +} +// "no" +// "yes" + +for (let item of map.entries()) { + console.log(item[0], item[1]); +} +// "F" "no" +// "T" "yes" + +// 或者 +for (let [key, value] of map.entries()) { + console.log(key, value); +} +// "F" "no" +// "T" "yes" + +// 等同于使用map.entries() +for (let [key, value] of map) { + console.log(key, value); +} +// "F" "no" +// "T" "yes" +``` + +上面代码最后的那个例子,表示 Map 结构的默认遍历器接口(`Symbol.iterator`属性),就是`entries`方法。 + +```javascript +map[Symbol.iterator] === map.entries +// true +``` + +Map 结构转为数组结构,比较快速的方法是使用扩展运算符(`...`)。 + +```javascript +const map = new Map([ + [1, 'one'], + [2, 'two'], + [3, 'three'], +]); + +[...map.keys()] +// [1, 2, 3] + +[...map.values()] +// ['one', 'two', 'three'] + +[...map.entries()] +// [[1,'one'], [2, 'two'], [3, 'three']] + +[...map] +// [[1,'one'], [2, 'two'], [3, 'three']] +``` + +结合数组的`map`方法、`filter`方法,可以实现 Map 的遍历和过滤(Map 本身没有`map`和`filter`方法)。 + +```javascript +const map0 = new Map() + .set(1, 'a') + .set(2, 'b') + .set(3, 'c'); + +const map1 = new Map( + [...map0].filter(([k, v]) => k < 3) +); +// 产生 Map 结构 {1 => 'a', 2 => 'b'} + +const map2 = new Map( + [...map0].map(([k, v]) => [k * 2, '_' + v]) + ); +// 产生 Map 结构 {2 => '_a', 4 => '_b', 6 => '_c'} +``` + +此外,Map 还有一个`forEach`方法,与数组的`forEach`方法类似,也可以实现遍历。 + +```javascript +map.forEach(function(value, key, map) { + console.log("Key: %s, Value: %s", key, value); +}); +``` + +`forEach`方法还可以接受第二个参数,用来绑定`this`。 + +```javascript +const reporter = { + report: function(key, value) { + console.log("Key: %s, Value: %s", key, value); + } +}; + +map.forEach(function(value, key, map) { + this.report(key, value); +}, reporter); +``` + +上面代码中,`forEach`方法的回调函数的`this`,就指向`reporter`。 + +### 与其他数据结构的互相转换 + +**(1)Map 转为数组** + +前面已经提过,Map 转为数组最方便的方法,就是使用扩展运算符(`...`)。 + +```javascript +const myMap = new Map() + .set(true, 7) + .set({foo: 3}, ['abc']); +[...myMap] +// [ [ true, 7 ], [ { foo: 3 }, [ 'abc' ] ] ] +``` + +**(2)数组 转为 Map** + +将数组传入 Map 构造函数,就可以转为 Map。 + +```javascript +new Map([ + [true, 7], + [{foo: 3}, ['abc']] +]) +// Map { +// true => 7, +// Object {foo: 3} => ['abc'] +// } +``` + +**(3)Map 转为对象** + +如果所有 Map 的键都是字符串,它可以无损地转为对象。 + +```javascript +function strMapToObj(strMap) { + let obj = Object.create(null); + for (let [k,v] of strMap) { + obj[k] = v; + } + return obj; +} + +const myMap = new Map() + .set('yes', true) + .set('no', false); +strMapToObj(myMap) +// { yes: true, no: false } +``` + +如果有非字符串的键名,那么这个键名会被转成字符串,再作为对象的键名。 + +**(4)对象转为 Map** + +```javascript +function objToStrMap(obj) { + let strMap = new Map(); + for (let k of Object.keys(obj)) { + strMap.set(k, obj[k]); + } + return strMap; +} + +objToStrMap({yes: true, no: false}) +// Map {"yes" => true, "no" => false} +``` + +**(5)Map 转为 JSON** + +Map 转为 JSON 要区分两种情况。一种情况是,Map 的键名都是字符串,这时可以选择转为对象 JSON。 + +```javascript +function strMapToJson(strMap) { + return JSON.stringify(strMapToObj(strMap)); +} + +let myMap = new Map().set('yes', true).set('no', false); +strMapToJson(myMap) +// '{"yes":true,"no":false}' +``` + +另一种情况是,Map 的键名有非字符串,这时可以选择转为数组 JSON。 + +```javascript +function mapToArrayJson(map) { + return JSON.stringify([...map]); +} + +let myMap = new Map().set(true, 7).set({foo: 3}, ['abc']); +mapToArrayJson(myMap) +// '[[true,7],[{"foo":3},["abc"]]]' +``` + +**(6)JSON 转为 Map** + +JSON 转为 Map,正常情况下,所有键名都是字符串。 + +```javascript +function jsonToStrMap(jsonStr) { + return objToStrMap(JSON.parse(jsonStr)); +} + +jsonToStrMap('{"yes": true, "no": false}') +// Map {'yes' => true, 'no' => false} +``` + +但是,有一种特殊情况,整个 JSON 就是一个数组,且每个数组成员本身,又是一个有两个成员的数组。这时,它可以一一对应地转为 Map。这往往是 Map 转为数组 JSON 的逆操作。 + +```javascript +function jsonToMap(jsonStr) { + return new Map(JSON.parse(jsonStr)); +} + +jsonToMap('[[true,7],[{"foo":3},["abc"]]]') +// Map {true => 7, Object {foo: 3} => ['abc']} +``` + +## WeakMap + +### 含义 + +`WeakMap`结构与`Map`结构类似,也是用于生成键值对的集合。 + +```javascript +// WeakMap 可以使用 set 方法添加成员 +const wm1 = new WeakMap(); +const key = {foo: 1}; +wm1.set(key, 2); +wm1.get(key) // 2 + +// WeakMap 也可以接受一个数组, +// 作为构造函数的参数 +const k1 = [1, 2, 3]; +const k2 = [4, 5, 6]; +const wm2 = new WeakMap([[k1, 'foo'], [k2, 'bar']]); +wm2.get(k2) // "bar" +``` + +`WeakMap`与`Map`的区别有两点。 + +首先,`WeakMap`只接受对象作为键名(`null`除外),不接受其他类型的值作为键名。 + +```javascript +const map = new WeakMap(); +map.set(1, 2) +// TypeError: 1 is not an object! +map.set(Symbol(), 2) +// TypeError: Invalid value used as weak map key +map.set(null, 2) +// TypeError: Invalid value used as weak map key +``` + +上面代码中,如果将数值`1`和`Symbol`值作为 WeakMap 的键名,都会报错。 + +其次,`WeakMap`的键名所指向的对象,不计入垃圾回收机制。 + +`WeakMap`的设计目的在于,有时我们想在某个对象上面存放一些数据,但是这会形成对于这个对象的引用。请看下面的例子。 + +```javascript +const e1 = document.getElementById('foo'); +const e2 = document.getElementById('bar'); +const arr = [ + [e1, 'foo 元素'], + [e2, 'bar 元素'], +]; +``` + +上面代码中,`e1`和`e2`是两个对象,我们通过`arr`数组对这两个对象添加一些文字说明。这就形成了`arr`对`e1`和`e2`的引用。 + +一旦不再需要这两个对象,我们就必须手动删除这个引用,否则垃圾回收机制就不会释放`e1`和`e2`占用的内存。 + +```javascript +// 不需要 e1 和 e2 的时候 +// 必须手动删除引用 +arr [0] = null; +arr [1] = null; +``` + +上面这样的写法显然很不方便。一旦忘了写,就会造成内存泄露。 + +WeakMap 就是为了解决这个问题而诞生的,它的键名所引用的对象都是弱引用,即垃圾回收机制不将该引用考虑在内。因此,只要所引用的对象的其他引用都被清除,垃圾回收机制就会释放该对象所占用的内存。也就是说,一旦不再需要,WeakMap 里面的键名对象和所对应的键值对会自动消失,不用手动删除引用。 + +基本上,如果你要往对象上添加数据,又不想干扰垃圾回收机制,就可以使用 WeakMap。一个典型应用场景是,在网页的 DOM 元素上添加数据,就可以使用`WeakMap`结构。当该 DOM 元素被清除,其所对应的`WeakMap`记录就会自动被移除。 + +```javascript +const wm = new WeakMap(); + +const element = document.getElementById('example'); + +wm.set(element, 'some information'); +wm.get(element) // "some information" +``` + +上面代码中,先新建一个 Weakmap 实例。然后,将一个 DOM 节点作为键名存入该实例,并将一些附加信息作为键值,一起存放在 WeakMap 里面。这时,WeakMap 里面对`element`的引用就是弱引用,不会被计入垃圾回收机制。 + +也就是说,上面的 DOM 节点对象的引用计数是`1`,而不是`2`。这时,一旦消除对该节点的引用,它占用的内存就会被垃圾回收机制释放。Weakmap 保存的这个键值对,也会自动消失。 + +总之,`WeakMap`的专用场合就是,它的键所对应的对象,可能会在将来消失。`WeakMap`结构有助于防止内存泄漏。 + +注意,WeakMap 弱引用的只是键名,而不是键值。键值依然是正常引用。 + +```javascript +const wm = new WeakMap(); +let key = {}; +let obj = {foo: 1}; + +wm.set(key, obj); +obj = null; +wm.get(key) +// Object {foo: 1} +``` + +上面代码中,键值`obj`是正常引用。所以,即使在 WeakMap 外部消除了`obj`的引用,WeakMap 内部的引用依然存在。 + +### WeakMap 的语法 + +WeakMap 与 Map 在 API 上的区别主要是两个,一是没有遍历操作(即没有`keys()`、`values()`和`entries()`方法),也没有`size`属性。因为没有办法列出所有键名,某个键名是否存在完全不可预测,跟垃圾回收机制是否运行相关。这一刻可以取到键名,下一刻垃圾回收机制突然运行了,这个键名就没了,为了防止出现不确定性,就统一规定不能取到键名。二是无法清空,即不支持`clear`方法。因此,`WeakMap`只有四个方法可用:`get()`、`set()`、`has()`、`delete()`。 + +```javascript +const wm = new WeakMap(); + +// size、forEach、clear 方法都不存在 +wm.size // undefined +wm.forEach // undefined +wm.clear // undefined +``` + +### WeakMap 的示例 + +WeakMap 的例子很难演示,因为无法观察它里面的引用会自动消失。此时,其他引用都解除了,已经没有引用指向 WeakMap 的键名了,导致无法证实那个键名是不是存在。 + +贺师俊老师[提示](https://github.com/ruanyf/es6tutorial/issues/362#issuecomment-292109104),如果引用所指向的值占用特别多的内存,就可以通过 Node 的`process.memoryUsage`方法看出来。根据这个思路,网友[vtxf](https://github.com/ruanyf/es6tutorial/issues/362#issuecomment-292451925)补充了下面的例子。 + +首先,打开 Node 命令行。 + +```bash +$ node --expose-gc +``` + +上面代码中,`--expose-gc`参数表示允许手动执行垃圾回收机制。 + +然后,执行下面的代码。 + +```javascript +// 手动执行一次垃圾回收,保证获取的内存使用状态准确 +> global.gc(); +undefined + +// 查看内存占用的初始状态,heapUsed 为 4M 左右 +> process.memoryUsage(); +{ rss: 21106688, + heapTotal: 7376896, + heapUsed: 4153936, + external: 9059 } + +> let wm = new WeakMap(); +undefined + +// 新建一个变量 key,指向一个 5*1024*1024 的数组 +> let key = new Array(5 * 1024 * 1024); +undefined + +// 设置 WeakMap 实例的键名,也指向 key 数组 +// 这时,key 数组实际被引用了两次, +// 变量 key 引用一次,WeakMap 的键名引用了第二次 +// 但是,WeakMap 是弱引用,对于引擎来说,引用计数还是1 +> wm.set(key, 1); +WeakMap {} + +> global.gc(); +undefined + +// 这时内存占用 heapUsed 增加到 45M 了 +> process.memoryUsage(); +{ rss: 67538944, + heapTotal: 7376896, + heapUsed: 45782816, + external: 8945 } + +// 清除变量 key 对数组的引用, +// 但没有手动清除 WeakMap 实例的键名对数组的引用 +> key = null; +null + +// 再次执行垃圾回收 +> global.gc(); +undefined + +// 内存占用 heapUsed 变回 4M 左右, +// 可以看到 WeakMap 的键名引用没有阻止 gc 对内存的回收 +> process.memoryUsage(); +{ rss: 20639744, + heapTotal: 8425472, + heapUsed: 3979792, + external: 8956 } +``` + +上面代码中,只要外部的引用消失,WeakMap 内部的引用,就会自动被垃圾回收清除。由此可见,有了 WeakMap 的帮助,解决内存泄漏就会简单很多。 + +### WeakMap 的用途 + +前文说过,WeakMap 应用的典型场合就是 DOM 节点作为键名。下面是一个例子。 + +```javascript +let myElement = document.getElementById('logo'); +let myWeakmap = new WeakMap(); + +myWeakmap.set(myElement, {timesClicked: 0}); + +myElement.addEventListener('click', function() { + let logoData = myWeakmap.get(myElement); + logoData.timesClicked++; +}, false); +``` + +上面代码中,`myElement`是一个 DOM 节点,每当发生`click`事件,就更新一下状态。我们将这个状态作为键值放在 WeakMap 里,对应的键名就是`myElement`。一旦这个 DOM 节点删除,该状态就会自动消失,不存在内存泄漏风险。 + +WeakMap 的另一个用处是部署私有属性。 + +```javascript +const _counter = new WeakMap(); +const _action = new WeakMap(); + +class Countdown { + constructor(counter, action) { + _counter.set(this, counter); + _action.set(this, action); + } + dec() { + let counter = _counter.get(this); + if (counter < 1) return; + counter--; + _counter.set(this, counter); + if (counter === 0) { + _action.get(this)(); + } + } +} + +const c = new Countdown(2, () => console.log('DONE')); + +c.dec() +c.dec() +// DONE +``` + +上面代码中,`Countdown`类的两个内部属性`_counter`和`_action`,是实例的弱引用,所以如果删除实例,它们也就随之消失,不会造成内存泄漏。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/simd.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/simd.md" old mode 100644 new mode 100755 similarity index 67% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/simd.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/simd.md" index 65e0f64c3..c52d5c2c7 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/simd.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/simd.md" @@ -4,9 +4,9 @@ SIMD(发音`/sim-dee/`)是“Single Instruction/Multiple Data”的缩写,意为“单指令,多数据”。它是 JavaScript 操作 CPU 对应指令的接口,你可以看做这是一种不同的运算执行模式。与它相对的是 SISD(“Single Instruction/Single Data”),即“单指令,单数据”。 -SIMD 的含义是使用一个指令,完成多个数据的运算;SISD 的含义是使用一个指令,完成单个数据的运算,这是 JavaScript 的默认运算模式。显而易见,SIMD 的执行效率要高于 SISD,所以被广泛用于3D图形运算、物理模拟等运算量超大的项目之中。 +SIMD 的含义是使用一个指令,完成多个数据的运算;SISD 的含义是使用一个指令,完成单个数据的运算,这是 JavaScript 的默认运算模式。显而易见,SIMD 的执行效率要高于 SISD,所以被广泛用于 3D 图形运算、物理模拟等运算量超大的项目之中。 -为了理解SIMD,请看下面的例子。 +为了理解 SIMD,请看下面的例子。 ```javascript var a = [1, 2, 3, 4]; @@ -20,7 +20,7 @@ c[3] = a[3] + b[3]; c // Array[6, 8, 10, 12] ``` -上面代码中,数组`a`和`b`的对应成员相加,结果放入数组`c`。它的运算模式是依次处理每个数组成员,一共有四个数组成员,所以需要运算4次。 +上面代码中,数组`a`和`b`的对应成员相加,结果放入数组`c`。它的运算模式是依次处理每个数组成员,一共有四个数组成员,所以需要运算 4 次。 如果采用 SIMD 模式,只要运算一次就够了。 @@ -30,45 +30,45 @@ var b = SIMD.Float32x4(5, 6, 7, 8); var c = SIMD.Float32x4.add(a, b); // Float32x4[6, 8, 10, 12] ``` -上面代码之中,数组`a`和`b`的四个成员的各自相加,只用一条指令就完成了。因此,速度比上一种写法提高了4倍。 +上面代码之中,数组`a`和`b`的四个成员的各自相加,只用一条指令就完成了。因此,速度比上一种写法提高了 4 倍。 一次 SIMD 运算,可以处理多个数据,这些数据被称为“通道”(lane)。上面代码中,一次运算了四个数据,因此就是四个通道。 SIMD 通常用于矢量运算。 ```javascript -v + w = 〈v1, …, vn〉+ 〈w1, …, wn〉 +v + w = 〈v1, …, vn〉+ 〈w1, …, wn〉 = 〈v1+w1, …, vn+wn〉 ``` -上面代码中,`v`和`w`是两个多元矢量。它们的加运算,在 SIMD 下是一个指令、而不是 n 个指令完成的,这就大大提高了效率。这对于3D动画、图像处理、信号处理、数值处理、加密等运算是非常重要的。比如,Canvas的`getImageData()`会将图像文件读成一个二进制数组,SIMD 就很适合对于这种数组的处理。 +上面代码中,`v`和`w`是两个多元矢量。它们的加运算,在 SIMD 下是一个指令、而不是 n 个指令完成的,这就大大提高了效率。这对于 3D 动画、图像处理、信号处理、数值处理、加密等运算是非常重要的。比如,Canvas 的`getImageData()`会将图像文件读成一个二进制数组,SIMD 就很适合对于这种数组的处理。 总的来说,SIMD 是数据并行处理(parallelism)的一种手段,可以加速一些运算密集型操作的速度。将来与 WebAssembly 结合以后,可以让 JavaScript 达到二进制代码的运行速度。 ## 数据类型 -SIMD 提供12种数据类型,总长度都是128个二进制位。 +SIMD 提供 12 种数据类型,总长度都是 128 个二进制位。 -- Float32x4:四个32位浮点数 -- Float64x2:两个64位浮点数 -- Int32x4:四个32位整数 -- Int16x8:八个16位整数 -- Int8x16:十六个8位整数 -- Uint32x4:四个无符号的32位整数 -- Uint16x8:八个无符号的16位整数 -- Uint8x16:十六个无符号的8位整数 -- Bool32x4:四个32位布尔值 -- Bool16x8:八个16位布尔值 -- Bool8x16:十六个8位布尔值 -- Bool64x2:两个64位布尔值 +- Float32x4:四个 32 位浮点数 +- Float64x2:两个 64 位浮点数 +- Int32x4:四个 32 位整数 +- Int16x8:八个 16 位整数 +- Int8x16:十六个 8 位整数 +- Uint32x4:四个无符号的 32 位整数 +- Uint16x8:八个无符号的 16 位整数 +- Uint8x16:十六个无符号的 8 位整数 +- Bool32x4:四个 32 位布尔值 +- Bool16x8:八个 16 位布尔值 +- Bool8x16:十六个 8 位布尔值 +- Bool64x2:两个 64 位布尔值 -每种数据类型被`x`符号分隔成两部分,后面的部分表示通道数,前面的部分表示每个通道的宽度和类型。比如,`Float32x4`就表示这个值有4个通道,每个通道是一个32位浮点数。 +每种数据类型被`x`符号分隔成两部分,后面的部分表示通道数,前面的部分表示每个通道的宽度和类型。比如,`Float32x4`就表示这个值有 4 个通道,每个通道是一个 32 位浮点数。 每个通道之中,可以放置四种数据。 -- 浮点数(float,比如1.0) +- 浮点数(float,比如 1.0) - 带符号的整数(Int,比如-1) -- 无符号的整数(Uint,比如1) +- 无符号的整数(Uint,比如 1) - 布尔值(Bool,包含`true`和`false`两种值) 每种 SIMD 的数据类型都是一个函数方法,可以传入参数,生成对应的值。 @@ -77,7 +77,7 @@ SIMD 提供12种数据类型,总长度都是128个二进制位。 var a = SIMD.Float32x4(1.0, 2.0, 3.0, 4.0); ``` -上面代码中,变量`a`就是一个128位、包含四个32位浮点数(即四个通道)的值。 +上面代码中,变量`a`就是一个 128 位、包含四个 32 位浮点数(即四个通道)的值。 注意,这些数据类型方法都不是构造函数,前面不能加`new`,否则会报错。 @@ -92,7 +92,7 @@ var v = new SIMD.Float32x4(0, 1, 2, 3); ### SIMD.%type%.abs(),SIMD.%type%.neg() -`abs`方法接受一个SIMD值作为参数,将它的每个通道都转成绝对值,作为一个新的SIMD值返回。 +`abs`方法接受一个 SIMD 值作为参数,将它的每个通道都转成绝对值,作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(-1, -2, 0, NaN); @@ -100,7 +100,7 @@ SIMD.Float32x4.abs(a) // Float32x4[1, 2, 0, NaN] ``` -`neg`方法接受一个SIMD值作为参数,将它的每个通道都转成负值,作为一个新的SIMD值返回。 +`neg`方法接受一个 SIMD 值作为参数,将它的每个通道都转成负值,作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(-1, -2, 3, 0); @@ -114,7 +114,7 @@ SIMD.Float64x2.neg(b) ### SIMD.%type%.add(),SIMD.%type%.addSaturate() -`add`方法接受两个SIMD值作为参数,将它们的每个通道相加,作为一个新的SIMD值返回。 +`add`方法接受两个 SIMD 值作为参数,将它们的每个通道相加,作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(1.0, 2.0, 3.0, 4.0); @@ -122,7 +122,7 @@ var b = SIMD.Float32x4(5.0, 10.0, 15.0, 20.0); var c = SIMD.Float32x4.add(a, b); ``` -上面代码中,经过加法运算,新的SIMD值为`(6.0, 12.0, 18.0. 24.0)`。 +上面代码中,经过加法运算,新的 SIMD 值为`(6.0, 12.0, 18.0. 24.0)`。 `addSaturate`方法跟`add`方法的作用相同,都是两个通道相加,但是溢出的处理不一致。对于`add`方法,如果两个值相加发生溢出,溢出的二进制位会被丢弃; `addSaturate`方法则是返回该数据类型的最大值。 @@ -138,13 +138,13 @@ SIMD.Int16x8.addSaturate(c, d); // Int16x8[32766, 32767, 32767, 32767, 2, 2, 2, 2] ``` -上面代码中,`Uint16`的最大值是65535,`Int16`的最大值是32767。一旦发生溢出,就返回这两个值。 +上面代码中,`Uint16`的最大值是 65535,`Int16`的最大值是 32767。一旦发生溢出,就返回这两个值。 注意,`Uint32x4`和`Int32x4`这两种数据类型没有`addSaturate`方法。 ### SIMD.%type%.sub(),SIMD.%type%.subSaturate() -`sub`方法接受两个SIMD值作为参数,将它们的每个通道相减,作为一个新的SIMD值返回。 +`sub`方法接受两个 SIMD 值作为参数,将它们的每个通道相减,作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(-1, -2, 3, 4); @@ -167,11 +167,11 @@ SIMD.Int16x8.subSaturate(c, d) // Int16x8[-32768, 0, 0, 0, 0, 0, 0, 0, 0] ``` -上面代码中,`Uint16`的最小值是`0`,`subSaturate`的最小值是`-32678`。一旦运算发生溢出,就返回最小值。 +上面代码中,`Uint16`的最小值是`0`,`Int16`的最小值是`-32678`。一旦运算发生溢出,就返回最小值。 ### SIMD.%type%.mul(),SIMD.%type%.div(),SIMD.%type%.sqrt() -`mul`方法接受两个SIMD值作为参数,将它们的每个通道相乘,作为一个新的SIMD值返回。 +`mul`方法接受两个 SIMD 值作为参数,将它们的每个通道相乘,作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(-1, -2, 3, 4); @@ -180,7 +180,7 @@ SIMD.Float32x4.mul(a, b) // Float32x4[-3, -6, 9, 12] ``` -`div`方法接受两个SIMD值作为参数,将它们的每个通道相除,作为一个新的SIMD值返回。 +`div`方法接受两个 SIMD 值作为参数,将它们的每个通道相除,作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(2, 2, 2, 2); @@ -189,7 +189,7 @@ SIMD.Float32x4.div(a, b) // Float32x4[0.5, 0.5, 0.5, 0.5] ``` -`sqrt`方法接受一个SIMD值作为参数,求出每个通道的平方根,作为一个新的SIMD值返回。 +`sqrt`方法接受一个 SIMD 值作为参数,求出每个通道的平方根,作为一个新的 SIMD 值返回。 ```javascript var b = SIMD.Float64x2(4, 8); @@ -199,7 +199,7 @@ SIMD.Float64x2.sqrt(b) ### SIMD.%FloatType%.reciprocalApproximation(),SIMD.%type%.reciprocalSqrtApproximation() -`reciprocalApproximation`方法接受一个SIMD值作为参数,求出每个通道的倒数(`1 / x`),作为一个新的SIMD值返回。 +`reciprocalApproximation`方法接受一个 SIMD 值作为参数,求出每个通道的倒数(`1 / x`),作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(1, 2, 3, 4); @@ -207,7 +207,7 @@ SIMD.Float32x4.reciprocalApproximation(a); // Float32x4[1, 0.5, 0.3333333432674408, 0.25] ``` -`reciprocalSqrtApproximation`方法接受一个SIMD值作为参数,求出每个通道的平方根的倒数(`1 / (x^0.5)`),作为一个新的SIMD值返回。 +`reciprocalSqrtApproximation`方法接受一个 SIMD 值作为参数,求出每个通道的平方根的倒数(`1 / (x^0.5)`),作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(1, 2, 3, 4); @@ -219,7 +219,7 @@ SIMD.Float32x4.reciprocalSqrtApproximation(a) ### SIMD.%IntegerType%.shiftLeftByScalar() -`shiftLeftByScalar`方法接受一个SIMD值作为参数,然后将每个通道的值左移指定的位数,作为一个新的SIMD值返回。 +`shiftLeftByScalar`方法接受一个 SIMD 值作为参数,然后将每个通道的值左移指定的位数,作为一个新的 SIMD 值返回。 ```javascript var a = SIMD.Int32x4(1, 2, 4, 8); @@ -239,7 +239,7 @@ var jx4 = SIMD.Int32x4.shiftLeftByScalar(ix4, 32); ### SIMD.%IntegerType%.shiftRightByScalar() -`shiftRightByScalar`方法接受一个SIMD值作为参数,然后将每个通道的值右移指定的位数,返回一个新的SIMD值。 +`shiftRightByScalar`方法接受一个 SIMD 值作为参数,然后将每个通道的值右移指定的位数,返回一个新的 SIMD 值。 ```javascript var a = SIMD.Int32x4(1, 2, 4, -8); @@ -255,7 +255,7 @@ SIMD.Uint32x4.shiftRightByScalar(a, 1); // Uint32x4[0, 1, 2, 2147483644] ``` -上面代码中,`-8`右移一位变成了`2147483644`,是因为对于32位无符号整数来说,`-8`的二进制形式是`11111111111111111111111111111000`,右移一位就变成了`01111111111111111111111111111100`,相当于`2147483644`。 +上面代码中,`-8`右移一位变成了`2147483644`,是因为对于 32 位无符号整数来说,`-8`的二进制形式是`11111111111111111111111111111000`,右移一位就变成了`01111111111111111111111111111100`,相当于`2147483644`。 注意,只有整数的数据类型才有这个方法。 @@ -263,7 +263,7 @@ SIMD.Uint32x4.shiftRightByScalar(a, 1); ### SIMD.%type%.check() -`check`方法用于检查一个值是否为当前类型的SIMD值。如果是的,就返回这个值,否则就报错。 +`check`方法用于检查一个值是否为当前类型的 SIMD 值。如果是的,就返回这个值,否则就报错。 ```javascript var a = SIMD.Float32x4(1, 2, 3, 9); @@ -278,14 +278,14 @@ SIMD.Int32x4.check('hello world') // 报错 ### SIMD.%type%.extractLane(),SIMD.%type%.replaceLane() -`extractLane`方法用于返回给定通道的值。它接受两个参数,分别是SIMD值和通道编号。 +`extractLane`方法用于返回给定通道的值。它接受两个参数,分别是 SIMD 值和通道编号。 ```javascript var t = SIMD.Float32x4(1, 2, 3, 4); SIMD.Float32x4.extractLane(t, 2) // 3 ``` -`replaceLane`方法用于替换指定通道的值,并返回一个新的SIMD值。它接受三个参数,分别是原来的SIMD值、通道编号和新的通道值。 +`replaceLane`方法用于替换指定通道的值,并返回一个新的 SIMD 值。它接受三个参数,分别是原来的 SIMD 值、通道编号和新的通道值。 ```javascript var t = SIMD.Float32x4(1, 2, 3, 4); @@ -295,7 +295,7 @@ SIMD.Float32x4.replaceLane(t, 2, 42) ### SIMD.%type%.load() -`load`方法用于从二进制数组读入数据,生成一个新的SIMD值。 +`load`方法用于从二进制数组读入数据,生成一个新的 SIMD 值。 ```javascript var a = new Int32Array([1,2,3,4,5,6,7,8]); @@ -307,7 +307,7 @@ SIMD.Int32x4.load(a, 2); // Int32x4[3, 4, 5, 6] ``` -`load`方法接受两个参数:一个二进制数组和开始读取的位置(从0开始)。如果位置不合法(比如`-1`或者超出二进制数组的大小),就会抛出一个错误。 +`load`方法接受两个参数:一个二进制数组和开始读取的位置(从 0 开始)。如果位置不合法(比如`-1`或者超出二进制数组的大小),就会抛出一个错误。 这个方法还有三个变种`load1()`、`load2()`、`load3()`,表示从指定位置开始,只加载一个通道、二个通道、三个通道的值。 @@ -330,7 +330,7 @@ SIMD.Int32x4.load3(a, 0); ### SIMD.%type%.store() -`store`方法用于将一个SIMD值,写入一个二进制数组。它接受三个参数,分别是二进制数组、开始写入的数组位置、SIMD值。它返回写入值以后的二进制数组。 +`store`方法用于将一个 SIMD 值,写入一个二进制数组。它接受三个参数,分别是二进制数组、开始写入的数组位置、SIMD 值。它返回写入值以后的二进制数组。 ```javascript var t1 = new Int32Array(8); @@ -344,7 +344,7 @@ SIMD.Int32x4.store(t2, 2, v2) // Int32Array[0, 0, 1, 2, 3, 4, 0, 0] ``` -上面代码中,`t1`是一个二进制数组,`v1`是一个SIMD值,只有四个通道。所以写入`t1`以后,只有前四个位置有值,后四个位置都是0。而`t2`是从2号位置开始写入,所以前两个位置和后两个位置都是0。 +上面代码中,`t1`是一个二进制数组,`v1`是一个 SIMD 值,只有四个通道。所以写入`t1`以后,只有前四个位置有值,后四个位置都是 0。而`t2`是从 2 号位置开始写入,所以前两个位置和后两个位置都是 0。 这个方法还有三个变种`store1()`、`store2()`和`store3()`,表示只写入一个通道、二个通道和三个通道的值。 @@ -357,7 +357,7 @@ SIMD.Int32x4.store1(tarray, 0, value); ### SIMD.%type%.splat() -`splat`方法返回一个新的SIMD值,该值的所有通道都会设成同一个预先给定的值。 +`splat`方法返回一个新的 SIMD 值,该值的所有通道都会设成同一个预先给定的值。 ```javascript SIMD.Float32x4.splat(3); @@ -366,11 +366,11 @@ SIMD.Float64x2.splat(3); // Float64x2[3, 3] ``` -如果省略参数,所有整数型的SIMD值都会设定`0`,浮点型的SIMD值都会设成`NaN`。 +如果省略参数,所有整数型的 SIMD 值都会设定`0`,浮点型的 SIMD 值都会设成`NaN`。 ### SIMD.%type%.swizzle() -`swizzle`方法返回一个新的SIMD值,重新排列原有的SIMD值的通道顺序。 +`swizzle`方法返回一个新的 SIMD 值,重新排列原有的 SIMD 值的通道顺序。 ```javascript var t = SIMD.Float32x4(1, 2, 3, 4); @@ -378,7 +378,7 @@ SIMD.Float32x4.swizzle(t, 1, 2, 0, 3); // Float32x4[2,3,1,4] ``` -上面代码中,`swizzle`方法的第一个参数是原有的SIMD值,后面的参数对应将要返回的SIMD值的四个通道。它的意思是新的SIMD的四个通道,依次是原来SIMD值的1号通道、2号通道、0号通道、3号通道。由于SIMD值最多可以有16个通道,所以`swizzle`方法除了第一个参数以外,最多还可以接受16个参数。 +上面代码中,`swizzle`方法的第一个参数是原有的 SIMD 值,后面的参数对应将要返回的 SIMD 值的四个通道。它的意思是新的 SIMD 的四个通道,依次是原来 SIMD 值的 1 号通道、2 号通道、0 号通道、3 号通道。由于 SIMD 值最多可以有 16 个通道,所以`swizzle`方法除了第一个参数以外,最多还可以接受 16 个参数。 下面是另一个例子。 @@ -398,7 +398,7 @@ var d = SIMD.Float32x4.swizzle(a, 3, 2, 1, 0); ### SIMD.%type%.shuffle() -`shuffle`方法从两个SIMD值之中取出指定通道,返回一个新的SIMD值。 +`shuffle`方法从两个 SIMD 值之中取出指定通道,返回一个新的 SIMD 值。 ```javascript var a = SIMD.Float32x4(1, 2, 3, 4); @@ -408,13 +408,13 @@ SIMD.Float32x4.shuffle(a, b, 1, 5, 7, 2); // Float32x4[2, 6, 8, 3] ``` -上面代码中,`a`和`b`一共有8个通道,依次编号为0到7。`shuffle`根据编号,取出相应的通道,返回一个新的SIMD值。 +上面代码中,`a`和`b`一共有 8 个通道,依次编号为 0 到 7。`shuffle`根据编号,取出相应的通道,返回一个新的 SIMD 值。 ## 静态方法:比较运算 ### SIMD.%type%.equal(),SIMD.%type%.notEqual() -`equal`方法用来比较两个SIMD值`a`和`b`的每一个通道,根据两者是否精确相等(`a === b`),得到一个布尔值。最后,所有通道的比较结果,组成一个新的SIMD值,作为掩码返回。`notEqual`方法则是比较两个通道是否不相等(`a !== b`)。 +`equal`方法用来比较两个 SIMD 值`a`和`b`的每一个通道,根据两者是否精确相等(`a === b`),得到一个布尔值。最后,所有通道的比较结果,组成一个新的 SIMD 值,作为掩码返回。`notEqual`方法则是比较两个通道是否不相等(`a !== b`)。 ```javascript var a = SIMD.Float32x4(1, 2, 3, 9); @@ -429,7 +429,7 @@ SIMD.Float32x4.notEqual(a,b); ### SIMD.%type%.greaterThan(),SIMD.%type%.greaterThanOrEqual() -`greatThan`方法用来比较两个SIMD值`a`和`b`的每一个通道,如果在该通道中,`a`较大就得到`true`,否则得到`false`。最后,所有通道的比较结果,组成一个新的SIMD值,作为掩码返回。`greaterThanOrEqual`则是比较`a`是否大于等于`b`。 +`greatThan`方法用来比较两个 SIMD 值`a`和`b`的每一个通道,如果在该通道中,`a`较大就得到`true`,否则得到`false`。最后,所有通道的比较结果,组成一个新的 SIMD 值,作为掩码返回。`greaterThanOrEqual`则是比较`a`是否大于等于`b`。 ```javascript var a = SIMD.Float32x4(1, 6, 3, 11); @@ -444,7 +444,7 @@ SIMD.Float32x4.greaterThanOrEqual(a, b) ### SIMD.%type%.lessThan(),SIMD.%type%.lessThanOrEqual() -`lessThan`方法用来比较两个SIMD值`a`和`b`的每一个通道,如果在该通道中,`a`较小就得到`true`,否则得到`false`。最后,所有通道的比较结果,会组成一个新的SIMD值,作为掩码返回。`lessThanOrEqual`方法则是比较`a`是否等于`b`。 +`lessThan`方法用来比较两个 SIMD 值`a`和`b`的每一个通道,如果在该通道中,`a`较小就得到`true`,否则得到`false`。最后,所有通道的比较结果,会组成一个新的 SIMD 值,作为掩码返回。`lessThanOrEqual`方法则是比较`a`是否等于`b`。 ```javascript var a = SIMD.Float32x4(1, 2, 3, 11); @@ -459,7 +459,7 @@ SIMD.Float32x4.lessThanOrEqual(a, b) ### SIMD.%type%.select() -`select`方法通过掩码生成一个新的SIMD值。它接受三个参数,分别是掩码和两个SIMD值。 +`select`方法通过掩码生成一个新的 SIMD 值。它接受三个参数,分别是掩码和两个 SIMD 值。 ```javascript var a = SIMD.Float32x4(1, 2, 3, 4); @@ -471,7 +471,7 @@ SIMD.Float32x4.select(mask, a, b); // Float32x4[1, 6, 7, 4] ``` -上面代码中,`select`方法接受掩码和两个SIMD值作为参数。当某个通道对应的掩码为`true`时,会选择第一个SIMD值的对应通道,否则选择第二个SIMD值的对应通道。 +上面代码中,`select`方法接受掩码和两个 SIMD 值作为参数。当某个通道对应的掩码为`true`时,会选择第一个 SIMD 值的对应通道,否则选择第二个 SIMD 值的对应通道。 这个方法通常与比较运算符结合使用。 @@ -486,11 +486,11 @@ var result = SIMD.Float32x4.select(mask, a, b); // Float32x4[0, 6, 3, 4] ``` -上面代码中,先通过`lessThan`方法生成一个掩码,然后通过`select`方法生成一个由每个通道的较小值组成的新的SIMD值。 +上面代码中,先通过`lessThan`方法生成一个掩码,然后通过`select`方法生成一个由每个通道的较小值组成的新的 SIMD 值。 ### SIMD.%BooleanType%.allTrue(),SIMD.%BooleanType%.anyTrue() -`allTrue`方法接受一个SIMD值作为参数,然后返回一个布尔值,表示该SIMD值的所有通道是否都为`true`。 +`allTrue`方法接受一个 SIMD 值作为参数,然后返回一个布尔值,表示该 SIMD 值的所有通道是否都为`true`。 ```javascript var a = SIMD.Bool32x4(true, true, true, true); @@ -524,7 +524,7 @@ var b2 = SIMD.Int32x4.anyTrue(ix4); // true ### SIMD.%type%.min(),SIMD.%type%.minNum() -`min`方法接受两个SIMD值作为参数,将两者的对应通道的较小值,组成一个新的SIMD值返回。 +`min`方法接受两个 SIMD 值作为参数,将两者的对应通道的较小值,组成一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(-1, -2, 3, 5.2); @@ -555,7 +555,7 @@ var dx4 = SIMD.Float32x4.minNum(ax4, bx4); ### SIMD.%type%.max(),SIMD.%type%.maxNum() -`max`方法接受两个SIMD值作为参数,将两者的对应通道的较大值,组成一个新的SIMD值返回。 +`max`方法接受两个 SIMD 值作为参数,将两者的对应通道的较大值,组成一个新的 SIMD 值返回。 ```javascript var a = SIMD.Float32x4(-1, -2, 3, 5.2); @@ -586,7 +586,7 @@ SIMD.Float64x2.maxNum(c, d) ### SIMD.%type%.and(),SIMD.%type%.or(),SIMD.%type%.xor(),SIMD.%type%.not() -`and`方法接受两个SIMD值作为参数,返回两者对应的通道进行二进制`AND`运算(`&`)后得到的新的SIMD值。 +`and`方法接受两个 SIMD 值作为参数,返回两者对应的通道进行二进制`AND`运算(`&`)后得到的新的 SIMD 值。 ```javascript var a = SIMD.Int32x4(1, 2, 4, 8); @@ -597,7 +597,7 @@ SIMD.Int32x4.and(a, b) 上面代码中,以通道`0`为例,`1`的二进制形式是`0001`,`5`的二进制形式是`01001`,所以进行`AND`运算以后,得到`0001`。 -`or`方法接受两个SIMD值作为参数,返回两者对应的通道进行二进制`OR`运算(`|`)后得到的新的SIMD值。 +`or`方法接受两个 SIMD 值作为参数,返回两者对应的通道进行二进制`OR`运算(`|`)后得到的新的 SIMD 值。 ```javascript var a = SIMD.Int32x4(1, 2, 4, 8); @@ -606,7 +606,7 @@ SIMD.Int32x4.or(a, b) // Int32x4[5, 7, 5, 13] ``` -`xor`方法接受两个SIMD值作为参数,返回两者对应的通道进行二进制”异或“运算(`^`)后得到的新的SIMD值。 +`xor`方法接受两个 SIMD 值作为参数,返回两者对应的通道进行二进制“异或”运算(`^`)后得到的新的 SIMD 值。 ```javascript var a = SIMD.Int32x4(1, 2, 4, 8); @@ -615,7 +615,7 @@ SIMD.Int32x4.xor(a, b) // Int32x4[4, 7, 1, 13] ``` -`not`方法接受一个SIMD值作为参数,返回每个通道进行二进制”否“运算(`~`)后得到的新的SIMD值。 +`not`方法接受一个 SIMD 值作为参数,返回每个通道进行二进制“否”运算(`~`)后得到的新的 SIMD 值。 ```javascript var a = SIMD.Int32x4(1, 2, 4, 8); @@ -623,11 +623,11 @@ SIMD.Int32x4.not(a) // Int32x4[-2, -3, -5, -9] ``` -上面代码中,`1`的否运算之所以得到`-2`,是因为在计算机内部,负数采用”2的补码“这种形式进行表示。也就是说,整数`n`的负数形式`-n`,是对每一个二进制位取反以后,再加上1。因此,直接取反就相当于负数形式再减去1,比如`1`的负数形式是`-1`,再减去1,就得到了`-2`。 +上面代码中,`1`的否运算之所以得到`-2`,是因为在计算机内部,负数采用”2 的补码“这种形式进行表示。也就是说,整数`n`的负数形式`-n`,是对每一个二进制位取反以后,再加上 1。因此,直接取反就相当于负数形式再减去 1,比如`1`的负数形式是`-1`,再减去 1,就得到了`-2`。 ## 静态方法:数据类型转换 -SIMD提供以下方法,用来将一种数据类型转为另一种数据类型。 +SIMD 提供以下方法,用来将一种数据类型转为另一种数据类型。 - `SIMD.%type%.fromFloat32x4()` - `SIMD.%type%.fromFloat32x4Bits()` @@ -662,7 +662,7 @@ SIMD.Int16x8.fromFloat32x4Bits(t); // Int16x8[0, 16256, 0, 16384, 0, 16448, 0, 16512] ``` -上面代码中,原始SIMD值`t`是4通道的,而目标值是8通道的。 +上面代码中,原始 SIMD 值`t`是 4 通道的,而目标值是 8 通道的。 如果数据转换时,原通道的数据大小,超过了目标通道的最大宽度,就会报错。 @@ -670,7 +670,7 @@ SIMD.Int16x8.fromFloat32x4Bits(t); ### SIMD.%type%.prototype.toString() -`toString`方法返回一个SIMD值的字符串形式。 +`toString`方法返回一个 SIMD 值的字符串形式。 ```javascript var a = SIMD.Float32x4(11, 22, 33, 44); @@ -692,7 +692,7 @@ function average(list) { } ``` -使用SIMD,可以将计算次数减少到`n`次的四分之一。 +使用 SIMD,可以将计算次数减少到`n`次的四分之一。 ```javascript function average(list) { @@ -713,4 +713,3 @@ function average(list) { ``` 上面代码先是每隔四位,将所有的值读入一个 SIMD,然后立刻累加。然后,得到累加值四个通道的总和,再除以`n`就可以了。 - diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/spec.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/spec.md" new file mode 100755 index 000000000..f1c1e0eee --- /dev/null +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/spec.md" @@ -0,0 +1,313 @@ +# 读懂 ECMAScript 规格 + +## 概述 + +规格文件是计算机语言的官方标准,详细描述语法规则和实现方法。 + +一般来说,没有必要阅读规格,除非你要写编译器。因为规格写得非常抽象和精炼,又缺乏实例,不容易理解,而且对于解决实际的应用问题,帮助不大。但是,如果你遇到疑难的语法问题,实在找不到答案,这时可以去查看规格文件,了解语言标准是怎么说的。规格是解决问题的“最后一招”。 + +这对 JavaScript 语言很有必要。因为它的使用场景复杂,语法规则不统一,例外很多,各种运行环境的行为不一致,导致奇怪的语法问题层出不穷,任何语法书都不可能囊括所有情况。查看规格,不失为一种解决语法问题的最可靠、最权威的终极方法。 + +本章介绍如何读懂 ECMAScript 6 的规格文件。 + +ECMAScript 6 的规格,可以在 ECMA 国际标准组织的官方网站([www.ecma-international.org/ecma-262/6.0/](http://www.ecma-international.org/ecma-262/6.0/))免费下载和在线阅读。 + +这个规格文件相当庞大,一共有 26 章,A4 打印的话,足足有 545 页。它的特点就是规定得非常细致,每一个语法行为、每一个函数的实现都做了详尽的清晰的描述。基本上,编译器作者只要把每一步翻译成代码就可以了。这很大程度上,保证了所有 ES6 实现都有一致的行为。 + +ECMAScript 6 规格的 26 章之中,第 1 章到第 3 章是对文件本身的介绍,与语言关系不大。第 4 章是对这门语言总体设计的描述,有兴趣的读者可以读一下。第 5 章到第 8 章是语言宏观层面的描述。第 5 章是规格的名词解释和写法的介绍,第 6 章介绍数据类型,第 7 章介绍语言内部用到的抽象操作,第 8 章介绍代码如何运行。第 9 章到第 26 章介绍具体的语法。 + +对于一般用户来说,除了第 4 章,其他章节都涉及某一方面的细节,不用通读,只要在用到的时候,查阅相关章节即可。 + +## 术语 + +ES6 规格使用了一些专门的术语,了解这些术语,可以帮助你读懂规格。本节介绍其中的几个。 + +### 抽象操作 + +所谓“抽象操作”(abstract operations)就是引擎的一些内部方法,外部不能调用。规格定义了一系列的抽象操作,规定了它们的行为,留给各种引擎自己去实现。 + +举例来说,`Boolean(value)`的算法,第一步是这样的。 + +> 1. Let `b` be `ToBoolean(value)`. + +这里的`ToBoolean`就是一个抽象操作,是引擎内部求出布尔值的算法。 + +许多函数的算法都会多次用到同样的步骤,所以 ES6 规格将它们抽出来,定义成“抽象操作”,方便描述。 + +### Record 和 field + +ES6 规格将键值对(key-value map)的数据结构称为 Record,其中的每一组键值对称为 field。这就是说,一个 Record 由多个 field 组成,而每个 field 都包含一个键名(key)和一个键值(value)。 + +### [[Notation]] + +ES6 规格大量使用`[[Notation]]`这种书写法,比如`[[Value]]`、`[[Writable]]`、`[[Get]]`、`[[Set]]`等等。它用来指代 field 的键名。 + +举例来说,`obj`是一个 Record,它有一个`Prototype`属性。ES6 规格不会写`obj.Prototype`,而是写`obj.[[Prototype]]`。一般来说,使用`[[Notation]]`这种书写法的属性,都是对象的内部属性。 + +所有的 JavaScript 函数都有一个内部属性`[[Call]]`,用来运行该函数。 + +```javascript +F.[[Call]](V, argumentsList) +``` + +上面代码中,`F`是一个函数对象,`[[Call]]`是它的内部方法,`F.[[call]]()`表示运行该函数,`V`表示`[[Call]]`运行时`this`的值,`argumentsList`则是调用时传入函数的参数。 + +### Completion Record + +每一个语句都会返回一个 Completion Record,表示运行结果。每个 Completion Record 有一个`[[Type]]`属性,表示运行结果的类型。 + +`[[Type]]`属性有五种可能的值。 + +- normal +- return +- throw +- break +- continue + +如果`[[Type]]`的值是`normal`,就称为 normal completion,表示运行正常。其他的值,都称为 abrupt completion。其中,开发者只需要关注`[[Type]]`为`throw`的情况,即运行出错;`break`、`continue`、`return`这三个值都只出现在特定场景,可以不用考虑。 + +## 抽象操作的标准流程 + +抽象操作的运行流程,一般是下面这样。 + +> 1. Let `resultCompletionRecord` be `AbstractOp()`. +> 1. If `resultCompletionRecord` is an abrupt completion, return `resultCompletionRecord`. +> 1. Let `result` be `resultCompletionRecord.[[Value]]`. +> 1. return `result`. + +上面的第一步是调用抽象操作`AbstractOp()`,得到`resultCompletionRecord`,这是一个 Completion Record。第二步,如果这个 Record 属于 abrupt completion,就将`resultCompletionRecord`返回给用户。如果此处没有返回,就表示运行结果正常,所得的值存放在`resultCompletionRecord.[[Value]]`属性。第三步,将这个值记为`result`。第四步,将`result`返回给用户。 + +ES6 规格将这个标准流程,使用简写的方式表达。 + +> 1. Let `result` be `AbstractOp()`. +> 1. `ReturnIfAbrupt(result)`. +> 1. return `result`. + +这个简写方式里面的`ReturnIfAbrupt(result)`,就代表了上面的第二步和第三步,即如果有报错,就返回错误,否则取出值。 + +甚至还有进一步的简写格式。 + +> 1. Let `result` be `? AbstractOp()`. +> 1. return `result`. + +上面流程的`?`,就代表`AbstractOp()`可能会报错。一旦报错,就返回错误,否则取出值。 + +除了`?`,ES 6 规格还使用另一个简写符号`!`。 + +> 1. Let `result` be `! AbstractOp()`. +> 1. return `result`. + +上面流程的`!`,代表`AbstractOp()`不会报错,返回的一定是 normal completion,总是可以取出值。 + +## 相等运算符 + +下面通过一些例子,介绍如何使用这份规格。 + +相等运算符(`==`)是一个很让人头痛的运算符,它的语法行为多变,不符合直觉。这个小节就看看规格怎么规定它的行为。 + +请看下面这个表达式,请问它的值是多少。 + +```javascript +0 == null +``` + +如果你不确定答案,或者想知道语言内部怎么处理,就可以去查看规格,[7.2.12 小节](http://www.ecma-international.org/ecma-262/6.0/#sec-abstract-equality-comparison)是对相等运算符(`==`)的描述。 + +规格对每一种语法行为的描述,都分成两部分:先是总体的行为描述,然后是实现的算法细节。相等运算符的总体描述,只有一句话。 + +> “The comparison `x == y`, where `x` and `y` are values, produces `true` or `false`.” + +上面这句话的意思是,相等运算符用于比较两个值,返回`true`或`false`。 + +下面是算法细节。 + +> 1. ReturnIfAbrupt(x). +> 1. ReturnIfAbrupt(y). +> 1. If `Type(x)` is the same as `Type(y)`, then +> 1. Return the result of performing Strict Equality Comparison `x === y`. +> 1. If `x` is `null` and `y` is `undefined`, return `true`. +> 1. If `x` is `undefined` and `y` is `null`, return `true`. +> 1. If `Type(x)` is Number and `Type(y)` is String, +> return the result of the comparison `x == ToNumber(y)`. +> 1. If `Type(x)` is String and `Type(y)` is Number, +> return the result of the comparison `ToNumber(x) == y`. +> 1. If `Type(x)` is Boolean, return the result of the comparison `ToNumber(x) == y`. +> 1. If `Type(y)` is Boolean, return the result of the comparison `x == ToNumber(y)`. +> 1. If `Type(x)` is either String, Number, or Symbol and `Type(y)` is Object, then +> return the result of the comparison `x == ToPrimitive(y)`. +> 1. If `Type(x)` is Object and `Type(y)` is either String, Number, or Symbol, then +> return the result of the comparison `ToPrimitive(x) == y`. +> 1. Return `false`. + +上面这段算法,一共有 12 步,翻译如下。 + +> 1. 如果`x`不是正常值(比如抛出一个错误),中断执行。 +> 1. 如果`y`不是正常值,中断执行。 +> 1. 如果`Type(x)`与`Type(y)`相同,执行严格相等运算`x === y`。 +> 1. 如果`x`是`null`,`y`是`undefined`,返回`true`。 +> 1. 如果`x`是`undefined`,`y`是`null`,返回`true`。 +> 1. 如果`Type(x)`是数值,`Type(y)`是字符串,返回`x == ToNumber(y)`的结果。 +> 1. 如果`Type(x)`是字符串,`Type(y)`是数值,返回`ToNumber(x) == y`的结果。 +> 1. 如果`Type(x)`是布尔值,返回`ToNumber(x) == y`的结果。 +> 1. 如果`Type(y)`是布尔值,返回`x == ToNumber(y)`的结果。 +> 1. 如果`Type(x)`是字符串或数值或`Symbol`值,`Type(y)`是对象,返回`x == ToPrimitive(y)`的结果。 +> 1. 如果`Type(x)`是对象,`Type(y)`是字符串或数值或`Symbol`值,返回`ToPrimitive(x) == y`的结果。 +> 1. 返回`false`。 + +由于`0`的类型是数值,`null`的类型是 Null(这是规格[4.3.13 小节](http://www.ecma-international.org/ecma-262/6.0/#sec-terms-and-definitions-null-type)的规定,是内部 Type 运算的结果,跟`typeof`运算符无关)。因此上面的前 11 步都得不到结果,要到第 12 步才能得到`false`。 + +```javascript +0 == null // false +``` + +## 数组的空位 + +下面再看另一个例子。 + +```javascript +const a1 = [undefined, undefined, undefined]; +const a2 = [, , ,]; + +a1.length // 3 +a2.length // 3 + +a1[0] // undefined +a2[0] // undefined + +a1[0] === a2[0] // true +``` + +上面代码中,数组`a1`的成员是三个`undefined`,数组`a2`的成员是三个空位。这两个数组很相似,长度都是 3,每个位置的成员读取出来都是`undefined`。 + +但是,它们实际上存在重大差异。 + +```javascript +0 in a1 // true +0 in a2 // false + +a1.hasOwnProperty(0) // true +a2.hasOwnProperty(0) // false + +Object.keys(a1) // ["0", "1", "2"] +Object.keys(a2) // [] + +a1.map(n => 1) // [1, 1, 1] +a2.map(n => 1) // [, , ,] +``` + +上面代码一共列出了四种运算,数组`a1`和`a2`的结果都不一样。前三种运算(`in`运算符、数组的`hasOwnProperty`方法、`Object.keys`方法)都说明,数组`a2`取不到属性名。最后一种运算(数组的`map`方法)说明,数组`a2`没有发生遍历。 + +为什么`a1`与`a2`成员的行为不一致?数组的成员是`undefined`或空位,到底有什么不同? + +规格的[12.2.5 小节《数组的初始化》](http://www.ecma-international.org/ecma-262/6.0/#sec-array-initializer)给出了答案。 + +> “Array elements may be elided at the beginning, middle or end of the element list. Whenever a comma in the element list is not preceded by an AssignmentExpression (i.e., a comma at the beginning or after another comma), the missing array element contributes to the length of the Array and increases the index of subsequent elements. Elided array elements are not defined. If an element is elided at the end of an array, that element does not contribute to the length of the Array.” + +翻译如下。 + +> "数组成员可以省略。只要逗号前面没有任何表达式,数组的`length`属性就会加 1,并且相应增加其后成员的位置索引。被省略的成员不会被定义。如果被省略的成员是数组最后一个成员,则不会导致数组`length`属性增加。” + +上面的规格说得很清楚,数组的空位会反映在`length`属性,也就是说空位有自己的位置,但是这个位置的值是未定义,即这个值是不存在的。如果一定要读取,结果就是`undefined`(因为`undefined`在 JavaScript 语言中表示不存在)。 + +这就解释了为什么`in`运算符、数组的`hasOwnProperty`方法、`Object.keys`方法,都取不到空位的属性名。因为这个属性名根本就不存在,规格里面没说要为空位分配属性名(位置索引),只说要为下一个元素的位置索引加 1。 + +至于为什么数组的`map`方法会跳过空位,请看下一节。 + +## 数组的 map 方法 + +规格的[22.1.3.15 小节](http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.map)定义了数组的`map`方法。该小节先是总体描述`map`方法的行为,里面没有提到数组空位。 + +后面的算法描述是这样的。 + +> 1. Let `O` be `ToObject(this value)`. +> 1. `ReturnIfAbrupt(O)`. +> 1. Let `len` be `ToLength(Get(O, "length"))`. +> 1. `ReturnIfAbrupt(len)`. +> 1. If `IsCallable(callbackfn)` is `false`, throw a TypeError exception. +> 1. If `thisArg` was supplied, let `T` be `thisArg`; else let `T` be `undefined`. +> 1. Let `A` be `ArraySpeciesCreate(O, len)`. +> 1. `ReturnIfAbrupt(A)`. +> 1. Let `k` be 0. +> 1. Repeat, while `k` < `len` +> 1. Let `Pk` be `ToString(k)`. +> 1. Let `kPresent` be `HasProperty(O, Pk)`. +> 1. `ReturnIfAbrupt(kPresent)`. +> 1. If `kPresent` is `true`, then +> 1. Let `kValue` be `Get(O, Pk)`. +> 1. `ReturnIfAbrupt(kValue)`. +> 1. Let `mappedValue` be `Call(callbackfn, T, «kValue, k, O»)`. +> 1. `ReturnIfAbrupt(mappedValue)`. +> 1. Let `status` be `CreateDataPropertyOrThrow (A, Pk, mappedValue)`. +> 1. `ReturnIfAbrupt(status)`. +> 1. Increase `k` by 1. +> 1. Return `A`. + +翻译如下。 + +> 1. 得到当前数组的`this`对象 +> 1. 如果报错就返回 +> 1. 求出当前数组的`length`属性 +> 1. 如果报错就返回 +> 1. 如果 map 方法的参数`callbackfn`不可执行,就报错 +> 1. 如果 map 方法的参数之中,指定了`this`,就让`T`等于该参数,否则`T`为`undefined` +> 1. 生成一个新的数组`A`,跟当前数组的`length`属性保持一致 +> 1. 如果报错就返回 +> 1. 设定`k`等于 0 +> 1. 只要`k`小于当前数组的`length`属性,就重复下面步骤 +> 1. 设定`Pk`等于`ToString(k)`,即将`K`转为字符串 +> 1. 设定`kPresent`等于`HasProperty(O, Pk)`,即求当前数组有没有指定属性 +> 1. 如果报错就返回 +> 1. 如果`kPresent`等于`true`,则进行下面步骤 +> 1. 设定`kValue`等于`Get(O, Pk)`,取出当前数组的指定属性 +> 1. 如果报错就返回 +> 1. 设定`mappedValue`等于`Call(callbackfn, T, «kValue, k, O»)`,即执行回调函数 +> 1. 如果报错就返回 +> 1. 设定`status`等于`CreateDataPropertyOrThrow (A, Pk, mappedValue)`,即将回调函数的值放入`A`数组的指定位置 +> 1. 如果报错就返回 +> 1. `k`增加 1 +> 1. 返回`A` + +仔细查看上面的算法,可以发现,当处理一个全是空位的数组时,前面步骤都没有问题。进入第 10 步中第 2 步时,`kPresent`会报错,因为空位对应的属性名,对于数组来说是不存在的,因此就会返回,不会进行后面的步骤。 + +```javascript +const arr = [, , ,]; +arr.map(n => { + console.log(n); + return 1; +}) // [, , ,] +``` + +上面代码中,`arr`是一个全是空位的数组,`map`方法遍历成员时,发现是空位,就直接跳过,不会进入回调函数。因此,回调函数里面的`console.log`语句根本不会执行,整个`map`方法返回一个全是空位的新数组。 + +V8 引擎对`map`方法的[实现](https://github.com/v8/v8/blob/44c44521ae11859478b42004f57ea93df52526ee/src/js/array.js#L1347)如下,可以看到跟规格的算法描述完全一致。 + +```javascript +function ArrayMap(f, receiver) { + CHECK_OBJECT_COERCIBLE(this, "Array.prototype.map"); + + // Pull out the length so that modifications to the length in the + // loop will not affect the looping and side effects are visible. + var array = TO_OBJECT(this); + var length = TO_LENGTH_OR_UINT32(array.length); + return InnerArrayMap(f, receiver, array, length); +} + +function InnerArrayMap(f, receiver, array, length) { + if (!IS_CALLABLE(f)) throw MakeTypeError(kCalledNonCallable, f); + + var accumulator = new InternalArray(length); + var is_array = IS_ARRAY(array); + var stepping = DEBUG_IS_STEPPING(f); + for (var i = 0; i < length; i++) { + if (HAS_INDEX(array, i, is_array)) { + var element = array[i]; + // Prepare break slots for debugger step in. + if (stepping) %DebugPrepareStepInIfStepping(f); + accumulator[i] = %_Call(f, receiver, element, i, array); + } + } + var result = new GlobalArray(); + %MoveArrayContents(accumulator, result); + return result; +} +``` diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/string.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/string.md" old mode 100644 new mode 100755 similarity index 69% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/string.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/string.md" index 735c5a1b8..22540184b --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/string.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/string.md" @@ -21,7 +21,7 @@ JavaScript 允许采用`\uxxxx`形式表示一个字符,其中`xxxx`表示字 // " 7" ``` -上面代码表示,如果直接在`\u`后面跟上超过`0xFFFF`的数值(比如`\u20BB7`),JavaScript会理解成`\u20BB+7`。由于`\u20BB`是一个不可打印字符,所以只会显示一个空格,后面跟着一个`7`。 +上面代码表示,如果直接在`\u`后面跟上超过`0xFFFF`的数值(比如`\u20BB7`),JavaScript 会理解成`\u20BB+7`。由于`\u20BB`是一个不可打印字符,所以只会显示一个空格,后面跟着一个`7`。 ES6 对这一点做出了改进,只要将码点放入大括号,就能正确解读该字符。 @@ -41,7 +41,7 @@ hell\u{6F} // 123 上面代码中,最后一个例子表明,大括号表示法与四字节的 UTF-16 编码是等价的。 -有了这种表示法之后,JavaScript 共有6种方法可以表示一个字符。 +有了这种表示法之后,JavaScript 共有 6 种方法可以表示一个字符。 ```javascript '\z' === 'z' // true @@ -53,7 +53,7 @@ hell\u{6F} // 123 ## codePointAt() -JavaScript内部,字符以UTF-16的格式储存,每个字符固定为`2`个字节。对于那些需要`4`个字节储存的字符(Unicode码点大于`0xFFFF`的字符),JavaScript会认为它们是两个字符。 +JavaScript 内部,字符以 UTF-16 的格式储存,每个字符固定为`2`个字节。对于那些需要`4`个字节储存的字符(Unicode 码点大于`0xFFFF`的字符),JavaScript 会认为它们是两个字符。 ```javascript var s = "𠮷"; @@ -65,12 +65,12 @@ s.charCodeAt(0) // 55362 s.charCodeAt(1) // 57271 ``` -上面代码中,汉字“𠮷”(注意,这个字不是”吉祥“的”吉“)的码点是`0x20BB7`,UTF-16编码为`0xD842 0xDFB7`(十进制为`55362 57271`),需要`4`个字节储存。对于这种`4`个字节的字符,JavaScript不能正确处理,字符串长度会误判为`2`,而且`charAt`方法无法读取整个字符,`charCodeAt`方法只能分别返回前两个字节和后两个字节的值。 +上面代码中,汉字“𠮷”(注意,这个字不是“吉祥”的“吉”)的码点是`0x20BB7`,UTF-16 编码为`0xD842 0xDFB7`(十进制为`55362 57271`),需要`4`个字节储存。对于这种`4`个字节的字符,JavaScript 不能正确处理,字符串长度会误判为`2`,而且`charAt`方法无法读取整个字符,`charCodeAt`方法只能分别返回前两个字节和后两个字节的值。 -ES6提供了`codePointAt`方法,能够正确处理4个字节储存的字符,返回一个字符的码点。 +ES6 提供了`codePointAt`方法,能够正确处理 4 个字节储存的字符,返回一个字符的码点。 ```javascript -var s = '𠮷a'; +let s = '𠮷a'; s.codePointAt(0) // 134071 s.codePointAt(1) // 57271 @@ -78,23 +78,23 @@ s.codePointAt(1) // 57271 s.codePointAt(2) // 97 ``` -`codePointAt`方法的参数,是字符在字符串中的位置(从0开始)。上面代码中,JavaScript将“𠮷a”视为三个字符,codePointAt方法在第一个字符上,正确地识别了“𠮷”,返回了它的十进制码点134071(即十六进制的`20BB7`)。在第二个字符(即“𠮷”的后两个字节)和第三个字符“a”上,`codePointAt`方法的结果与`charCodeAt`方法相同。 +`codePointAt`方法的参数,是字符在字符串中的位置(从 0 开始)。上面代码中,JavaScript 将“𠮷a”视为三个字符,codePointAt 方法在第一个字符上,正确地识别了“𠮷”,返回了它的十进制码点 134071(即十六进制的`20BB7`)。在第二个字符(即“𠮷”的后两个字节)和第三个字符“a”上,`codePointAt`方法的结果与`charCodeAt`方法相同。 -总之,`codePointAt`方法会正确返回32位的UTF-16字符的码点。对于那些两个字节储存的常规字符,它的返回结果与`charCodeAt`方法相同。 +总之,`codePointAt`方法会正确返回 32 位的 UTF-16 字符的码点。对于那些两个字节储存的常规字符,它的返回结果与`charCodeAt`方法相同。 `codePointAt`方法返回的是码点的十进制值,如果想要十六进制的值,可以使用`toString`方法转换一下。 ```javascript -var s = '𠮷a'; +let s = '𠮷a'; s.codePointAt(0).toString(16) // "20bb7" s.codePointAt(2).toString(16) // "61" ``` -你可能注意到了,`codePointAt`方法的参数,仍然是不正确的。比如,上面代码中,字符`a`在字符串`s`的正确位置序号应该是1,但是必须向`codePointAt`方法传入2。解决这个问题的一个办法是使用`for...of`循环,因为它会正确识别32位的UTF-16字符。 +你可能注意到了,`codePointAt`方法的参数,仍然是不正确的。比如,上面代码中,字符`a`在字符串`s`的正确位置序号应该是 1,但是必须向`codePointAt`方法传入 2。解决这个问题的一个办法是使用`for...of`循环,因为它会正确识别 32 位的 UTF-16 字符。 ```javascript -var s = '𠮷a'; +let s = '𠮷a'; for (let ch of s) { console.log(ch.codePointAt(0).toString(16)); } @@ -115,7 +115,7 @@ is32Bit("a") // false ## String.fromCodePoint() -ES5提供`String.fromCharCode`方法,用于从码点返回对应字符,但是这个方法不能识别32位的UTF-16字符(Unicode编号大于`0xFFFF`)。 +ES5 提供`String.fromCharCode`方法,用于从码点返回对应字符,但是这个方法不能识别 32 位的 UTF-16 字符(Unicode 编号大于`0xFFFF`)。 ```javascript String.fromCharCode(0x20BB7) @@ -124,7 +124,7 @@ String.fromCharCode(0x20BB7) 上面代码中,`String.fromCharCode`不能识别大于`0xFFFF`的码点,所以`0x20BB7`就发生了溢出,最高位`2`被舍弃了,最后返回码点`U+0BB7`对应的字符,而不是码点`U+20BB7`对应的字符。 -ES6提供了`String.fromCodePoint`方法,可以识别`0xFFFF`的字符,弥补了`String.fromCharCode`方法的不足。在作用上,正好与`codePointAt`方法相反。 +ES6 提供了`String.fromCodePoint`方法,可以识别大于`0xFFFF`的字符,弥补了`String.fromCharCode`方法的不足。在作用上,正好与`codePointAt`方法相反。 ```javascript String.fromCodePoint(0x20BB7) @@ -139,7 +139,7 @@ String.fromCodePoint(0x78, 0x1f680, 0x79) === 'x\uD83D\uDE80y' ## 字符串的遍历器接口 -ES6为字符串添加了遍历器接口(详见《Iterator》一章),使得字符串可以被`for...of`循环遍历。 +ES6 为字符串添加了遍历器接口(详见《Iterator》一章),使得字符串可以被`for...of`循环遍历。 ```javascript for (let codePoint of 'foo') { @@ -153,7 +153,7 @@ for (let codePoint of 'foo') { 除了遍历字符串,这个遍历器最大的优点是可以识别大于`0xFFFF`的码点,传统的`for`循环无法识别这样的码点。 ```javascript -var text = String.fromCodePoint(0x20BB7); +let text = String.fromCodePoint(0x20BB7); for (let i = 0; i < text.length; i++) { console.log(text[i]); @@ -169,31 +169,11 @@ for (let i of text) { 上面代码中,字符串`text`只有一个字符,但是`for`循环会认为它包含两个字符(都不可打印),而`for...of`循环会正确识别出这一个字符。 -## at() - -ES5对字符串对象提供`charAt`方法,返回字符串给定位置的字符。该方法不能识别码点大于`0xFFFF`的字符。 - -```javascript -'abc'.charAt(0) // "a" -'𠮷'.charAt(0) // "\uD842" -``` - -上面代码中,`charAt`方法返回的是UTF-16编码的第一个字节,实际上是无法显示的。 - -目前,有一个提案,提出字符串实例的`at`方法,可以识别Unicode编号大于`0xFFFF`的字符,返回正确的字符。 - -```javascript -'abc'.at(0) // "a" -'𠮷'.at(0) // "𠮷" -``` - -这个方法可以通过[垫片库](https://github.com/es-shims/String.prototype.at)实现。 - ## normalize() -许多欧洲语言有语调符号和重音符号。为了表示它们,Unicode提供了两种方法。一种是直接提供带重音符号的字符,比如`Ǒ`(\u01D1)。另一种是提供合成符号(combining character),即原字符与重音符号的合成,两个字符合成一个字符,比如`O`(\u004F)和`ˇ`(\u030C)合成`Ǒ`(\u004F\u030C)。 +许多欧洲语言有语调符号和重音符号。为了表示它们,Unicode 提供了两种方法。一种是直接提供带重音符号的字符,比如`Ǒ`(\u01D1)。另一种是提供合成符号(combining character),即原字符与重音符号的合成,两个字符合成一个字符,比如`O`(\u004F)和`ˇ`(\u030C)合成`Ǒ`(\u004F\u030C)。 -这两种表示方法,在视觉和语义上都等价,但是JavaScript不能识别。 +这两种表示方法,在视觉和语义上都等价,但是 JavaScript 不能识别。 ```javascript '\u01D1'==='\u004F\u030C' //false @@ -202,9 +182,9 @@ ES5对字符串对象提供`charAt`方法,返回字符串给定位置的字符 '\u004F\u030C'.length // 2 ``` -上面代码表示,JavaScript将合成字符视为两个字符,导致两种表示方法不相等。 +上面代码表示,JavaScript 将合成字符视为两个字符,导致两种表示方法不相等。 -ES6提供字符串实例的`normalize()`方法,用来将字符的不同表示方法统一为同样的形式,这称为Unicode正规化。 +ES6 提供字符串实例的`normalize()`方法,用来将字符的不同表示方法统一为同样的形式,这称为 Unicode 正规化。 ```javascript '\u01D1'.normalize() === '\u004F\u030C'.normalize() @@ -225,18 +205,18 @@ ES6提供字符串实例的`normalize()`方法,用来将字符的不同表示 上面代码表示,`NFC`参数返回字符的合成形式,`NFD`参数返回字符的分解形式。 -不过,`normalize`方法目前不能识别三个或三个以上字符的合成。这种情况下,还是只能使用正则表达式,通过Unicode编号区间判断。 +不过,`normalize`方法目前不能识别三个或三个以上字符的合成。这种情况下,还是只能使用正则表达式,通过 Unicode 编号区间判断。 ## includes(), startsWith(), endsWith() -传统上,JavaScript只有`indexOf`方法,可以用来确定一个字符串是否包含在另一个字符串中。ES6又提供了三种新方法。 +传统上,JavaScript 只有`indexOf`方法,可以用来确定一个字符串是否包含在另一个字符串中。ES6 又提供了三种新方法。 - **includes()**:返回布尔值,表示是否找到了参数字符串。 -- **startsWith()**:返回布尔值,表示参数字符串是否在源字符串的头部。 -- **endsWith()**:返回布尔值,表示参数字符串是否在源字符串的尾部。 +- **startsWith()**:返回布尔值,表示参数字符串是否在原字符串的头部。 +- **endsWith()**:返回布尔值,表示参数字符串是否在原字符串的尾部。 ```javascript -var s = 'Hello world!'; +let s = 'Hello world!'; s.startsWith('Hello') // true s.endsWith('!') // true @@ -246,7 +226,7 @@ s.includes('o') // true 这三个方法都支持第二个参数,表示开始搜索的位置。 ```javascript -var s = 'Hello world!'; +let s = 'Hello world!'; s.startsWith('world', 6) // true s.endsWith('Hello', 5) // true @@ -280,13 +260,13 @@ s.includes('Hello', 6) // false // RangeError ``` -但是,如果参数是0到-1之间的小数,则等同于0,这是因为会先进行取整运算。0到-1之间的小数,取整以后等于`-0`,`repeat`视同为0。 +但是,如果参数是 0 到-1 之间的小数,则等同于 0,这是因为会先进行取整运算。0 到-1 之间的小数,取整以后等于`-0`,`repeat`视同为 0。 ```javascript 'na'.repeat(-0.9) // "" ``` -参数`NaN`等同于0。 +参数`NaN`等同于 0。 ```javascript 'na'.repeat(NaN) // "" @@ -311,16 +291,16 @@ ES2017 引入了字符串补全长度的功能。如果某个字符串不够指 'x'.padEnd(4, 'ab') // 'xaba' ``` -上面代码中,`padStart`和`padEnd`一共接受两个参数,第一个参数用来指定字符串的最小长度,第二个参数是用来补全的字符串。 +上面代码中,`padStart()`和`padEnd()`一共接受两个参数,第一个参数是字符串补全生效的最大长度,第二个参数是用来补全的字符串。 -如果原字符串的长度,等于或大于指定的最小长度,则返回原字符串。 +如果原字符串的长度,等于或大于最大长度,则字符串补全不生效,返回原字符串。 ```javascript 'xxx'.padStart(2, 'ab') // 'xxx' 'xxx'.padEnd(2, 'ab') // 'xxx' ``` -如果用来补全的字符串与原字符串,两者的长度之和超过了指定的最小长度,则会截去超出位数的补全字符串。 +如果用来补全的字符串与原字符串,两者的长度之和超过了最大长度,则会截去超出位数的补全字符串。 ```javascript 'abc'.padStart(10, '0123456789') @@ -334,7 +314,7 @@ ES2017 引入了字符串补全长度的功能。如果某个字符串不够指 'x'.padEnd(4) // 'x ' ``` -`padStart`的常见用途是为数值补全指定位数。下面代码生成10位的数值字符串。 +`padStart()`的常见用途是为数值补全指定位数。下面代码生成 10 位的数值字符串。 ```javascript '1'.padStart(10, '0') // "0000000001" @@ -349,9 +329,13 @@ ES2017 引入了字符串补全长度的功能。如果某个字符串不够指 '09-12'.padStart(10, 'YYYY-MM-DD') // "YYYY-09-12" ``` +## matchAll() + +`matchAll`方法返回一个正则表达式在当前字符串的所有匹配,详见《正则的扩展》的一章。 + ## 模板字符串 -传统的JavaScript语言,输出模板通常是这样写的。 +传统的 JavaScript 语言,输出模板通常是这样写的(下面使用了 jQuery 的方法)。 ```javascript $('#result').append( @@ -362,7 +346,7 @@ $('#result').append( ); ``` -上面这种写法相当繁琐不方便,ES6引入了模板字符串解决这个问题。 +上面这种写法相当繁琐不方便,ES6 引入了模板字符串解决这个问题。 ```javascript $('#result').append(` @@ -386,14 +370,14 @@ console.log(`string text line 1 string text line 2`); // 字符串中嵌入变量 -var name = "Bob", time = "today"; +let name = "Bob", time = "today"; `Hello ${name}, how are you ${time}?` ``` 上面代码中的模板字符串,都是用反引号表示。如果在模板字符串中需要使用反引号,则前面要用反斜杠转义。 ```javascript -var greeting = `\`Yo\` World!`; +let greeting = `\`Yo\` World!`; ``` 如果使用模板字符串表示多行字符串,所有的空格和缩进都会被保留在输出之中。 @@ -409,7 +393,6 @@ $('#list').html(` 上面代码中,所有模板字符串的空格和换行,都是被保留的,比如`
    `标签前面会有一个换行。如果你不想要这个换行,可以使用`trim`方法消除它。 - ```javascript $('#list').html(`
      @@ -436,11 +419,11 @@ function authorize(user, action) { } ``` -大括号内部可以放入任意的JavaScript表达式,可以进行运算,以及引用对象属性。 +大括号内部可以放入任意的 JavaScript 表达式,可以进行运算,以及引用对象属性。 ```javascript -var x = 1; -var y = 2; +let x = 1; +let y = 2; `${x} + ${y} = ${x + y}` // "1 + 2 = 3" @@ -448,9 +431,9 @@ var y = 2; `${x} + ${y * 2} = ${x + y * 2}` // "1 + 4 = 5" -var obj = {x: 1, y: 2}; +let obj = {x: 1, y: 2}; `${obj.x + obj.y}` -// 3 +// "3" ``` 模板字符串之中还能调用函数。 @@ -470,11 +453,11 @@ function fn() { ```javascript // 变量place没有声明 -var msg = `Hello, ${place}`; +let msg = `Hello, ${place}`; // 报错 ``` -由于模板字符串的大括号内部,就是执行JavaScript代码,因此如果大括号内部是一个字符串,将会原样输出。 +由于模板字符串的大括号内部,就是执行 JavaScript 代码,因此如果大括号内部是一个字符串,将会原样输出。 ```javascript `Hello ${'World'}` @@ -533,24 +516,24 @@ func('Jack') // "Hello Jack!" 下面,我们来看一个通过模板字符串,生成正式模板的实例。 ```javascript -var template = ` +let template = `
        - <% for(var i=0; i < data.supplies.length; i++) { %> + <% for(let i=0; i < data.supplies.length; i++) { %>
      • <%= data.supplies[i] %>
      • <% } %>
      `; ``` -上面代码在模板字符串之中,放置了一个常规模板。该模板使用`<%...%>`放置JavaScript代码,使用`<%= ... %>`输出JavaScript表达式。 +上面代码在模板字符串之中,放置了一个常规模板。该模板使用`<%...%>`放置 JavaScript 代码,使用`<%= ... %>`输出 JavaScript 表达式。 怎么编译这个模板字符串呢? -一种思路是将其转换为JavaScript表达式字符串。 +一种思路是将其转换为 JavaScript 表达式字符串。 ```javascript echo('
        '); -for(var i=0; i < data.supplies.length; i++) { +for(let i=0; i < data.supplies.length; i++) { echo('
      • '); echo(data.supplies[i]); echo('
      • '); @@ -561,8 +544,8 @@ echo('
      '); 这个转换使用正则表达式就行了。 ```javascript -var evalExpr = /<%=(.+?)%>/g; -var expr = /<%([\s\S]+?)%>/g; +let evalExpr = /<%=(.+?)%>/g; +let expr = /<%([\s\S]+?)%>/g; template = template .replace(evalExpr, '`); \n echo( $1 ); \n echo(`') @@ -574,9 +557,9 @@ template = 'echo(`' + template + '`);'; 然后,将`template`封装在一个函数里面返回,就可以了。 ```javascript -var script = +let script = `(function parse(data){ - var output = ""; + let output = ""; function echo(html){ output += html; @@ -594,8 +577,8 @@ return script; ```javascript function compile(template){ - var evalExpr = /<%=(.+?)%>/g; - var expr = /<%([\s\S]+?)%>/g; + const evalExpr = /<%=(.+?)%>/g; + const expr = /<%([\s\S]+?)%>/g; template = template .replace(evalExpr, '`); \n echo( $1 ); \n echo(`') @@ -603,9 +586,9 @@ function compile(template){ template = 'echo(`' + template + '`);'; - var script = + let script = `(function parse(data){ - var output = ""; + let output = ""; function echo(html){ output += html; @@ -623,7 +606,7 @@ function compile(template){ `compile`函数的用法如下。 ```javascript -var parse = eval(compile(template)); +let parse = eval(compile(template)); div.innerHTML = parse({ supplies: [ "broom", "mop", "cleaner" ] }); //
        //
      • broom
      • @@ -647,8 +630,8 @@ alert(123) 但是,如果模板字符里面有变量,就不是简单的调用了,而是会将模板字符串先处理成多个参数,再调用函数。 ```javascript -var a = 5; -var b = 10; +let a = 5; +let b = 10; tag`Hello ${ a + b } world ${ a * b }`; // 等同于 @@ -690,8 +673,8 @@ tag(['Hello ', ' world ', ''], 15, 50) 我们可以按照需要编写`tag`函数的代码。下面是`tag`函数的一种写法,以及运行结果。 ```javascript -var a = 5; -var b = 10; +let a = 5; +let b = 10; function tag(s, v1, v2) { console.log(s[0]); @@ -715,12 +698,12 @@ tag`Hello ${ a + b } world ${ a * b}`; 下面是一个更复杂的例子。 ```javascript -var total = 30; -var msg = passthru`The total is ${total} (${total*1.05} with tax)`; +let total = 30; +let msg = passthru`The total is ${total} (${total*1.05} with tax)`; function passthru(literals) { - var result = ''; - var i = 0; + let result = ''; + let i = 0; while (i < literals.length) { result += literals[i++]; @@ -737,12 +720,13 @@ msg // "The total is 30 (31.5 with tax)" 上面这个例子展示了,如何将各个参数按照原来的位置拼合回去。 -`passthru`函数采用rest参数的写法如下。 +`passthru`函数采用 rest 参数的写法如下。 ```javascript function passthru(literals, ...values) { - var output = ""; - for (var index = 0; index < values.length; index++) { + let output = ""; + let index; + for (index = 0; index < values.length; index++) { output += literals[index] + values[index]; } @@ -751,16 +735,16 @@ function passthru(literals, ...values) { } ``` -“标签模板”的一个重要应用,就是过滤HTML字符串,防止用户输入恶意内容。 +“标签模板”的一个重要应用,就是过滤 HTML 字符串,防止用户输入恶意内容。 ```javascript -var message = +let message = SaferHTML`

        ${sender} has sent you a message.

        `; function SaferHTML(templateData) { - var s = templateData[0]; - for (var i = 1; i < arguments.length; i++) { - var arg = String(arguments[i]); + let s = templateData[0]; + for (let i = 1; i < arguments.length; i++) { + let arg = String(arguments[i]); // Escape special characters in the substitution. s += arg.replace(/&/g, "&") @@ -777,14 +761,13 @@ function SaferHTML(templateData) { 上面代码中,`sender`变量往往是用户提供的,经过`SaferHTML`函数处理,里面的特殊字符都会被转义。 ```javascript -var sender = ''; // 恶意代码 -var message = SaferHTML`

        ${sender} has sent you a message.

        `; +let sender = ''; // 恶意代码 +let message = SaferHTML`

        ${sender} has sent you a message.

        `; message //

        <script>alert("abc")</script> has sent you a message.

        ``` - 标签模板的另一个应用,就是多语言转换(国际化处理)。 ```javascript @@ -792,12 +775,12 @@ i18n`Welcome to ${siteName}, you are visitor number ${visitorNumber}!` // "欢迎访问xxx,您是第xxxx位访问者!" ``` -模板字符串本身并不能取代Mustache之类的模板库,因为没有条件判断和循环处理功能,但是通过标签函数,你可以自己添加这些功能。 +模板字符串本身并不能取代 Mustache 之类的模板库,因为没有条件判断和循环处理功能,但是通过标签函数,你可以自己添加这些功能。 ```javascript // 下面的hashTemplate函数 // 是一个自定义的模板处理函数 -var libraryHtml = hashTemplate` +let libraryHtml = hashTemplate`
          #for book in ${myBooks}
        • #{book.title} by #{book.author}
        • @@ -806,7 +789,7 @@ var libraryHtml = hashTemplate` `; ``` -除此之外,你甚至可以使用标签模板,在JavaScript语言之中嵌入其他语言。 +除此之外,你甚至可以使用标签模板,在 JavaScript 语言之中嵌入其他语言。 ```javascript jsx` @@ -820,15 +803,15 @@ jsx` ` ``` -上面的代码通过`jsx`函数,将一个DOM字符串转为React对象。你可以在Github找到`jsx`函数的[具体实现](https://gist.github.com/lygaret/a68220defa69174bdec5)。 +上面的代码通过`jsx`函数,将一个 DOM 字符串转为 React 对象。你可以在 GitHub 找到`jsx`函数的[具体实现](https://gist.github.com/lygaret/a68220defa69174bdec5)。 -下面则是一个假想的例子,通过`java`函数,在JavaScript代码之中运行Java代码。 +下面则是一个假想的例子,通过`java`函数,在 JavaScript 代码之中运行 Java 代码。 ```javascript java` class HelloWorldApp { public static void main(String[] args) { - System.out.println(“Hello World!”); // Display the string. + System.out.println("Hello World!"); // Display the string. } } ` @@ -851,45 +834,32 @@ tag`First line\nSecond line` function tag(strings) { console.log(strings.raw[0]); - // "First line\\nSecond line" + // strings.raw[0] 为 "First line\\nSecond line" + // 打印输出 "First line\nSecond line" } ``` -上面代码中,`tag`函数的第一个参数`strings`,有一个`raw`属性,也指向一个数组。该数组的成员与`strings`数组完全一致。比如,`strings`数组是`["First line\nSecond line"]`,那么`strings.raw`数组就是`["First line\\nSecond line"]`。两者唯一的区别,就是字符串里面的斜杠都被转义了。比如,strings.raw数组会将`\n`视为`\\`和`n`两个字符,而不是换行符。这是为了方便取得转义之前的原始模板而设计的。 +上面代码中,`tag`函数的第一个参数`strings`,有一个`raw`属性,也指向一个数组。该数组的成员与`strings`数组完全一致。比如,`strings`数组是`["First line\nSecond line"]`,那么`strings.raw`数组就是`["First line\\nSecond line"]`。两者唯一的区别,就是字符串里面的斜杠都被转义了。比如,strings.raw 数组会将`\n`视为`\\`和`n`两个字符,而不是换行符。这是为了方便取得转义之前的原始模板而设计的。 ## String.raw() -ES6还为原生的String对象,提供了一个`raw`方法。 +ES6 还为原生的 String 对象,提供了一个`raw`方法。 `String.raw`方法,往往用来充当模板字符串的处理函数,返回一个斜杠都被转义(即斜杠前面再加一个斜杠)的字符串,对应于替换变量后的模板字符串。 ```javascript String.raw`Hi\n${2+3}!`; -// "Hi\\n5!" +// 返回 "Hi\\n5!" String.raw`Hi\u000A!`; -// 'Hi\\u000A!' +// 返回 "Hi\\u000A!" ``` -如果原字符串的斜杠已经转义,那么`String.raw`不会做任何处理。 +如果原字符串的斜杠已经转义,那么`String.raw`会进行再次转义。 ```javascript String.raw`Hi\\n` -// "Hi\\n" -``` - -`String.raw`的代码基本如下。 - -```javascript -String.raw = function (strings, ...values) { - var output = ""; - for (var index = 0; index < values.length; index++) { - output += strings.raw[index] + values[index]; - } - - output += strings.raw[index] - return output; -} +// 返回 "Hi\\\\n" ``` `String.raw`方法可以作为处理模板字符串的基本方法,它会将所有变量替换,而且对斜杠进行转义,方便下一步作为字符串来使用。 @@ -904,11 +874,26 @@ String.raw({ raw: 'test' }, 0, 1, 2); String.raw({ raw: ['t','e','s','t'] }, 0, 1, 2); ``` +作为函数,`String.raw`的代码实现基本如下。 + +```javascript +String.raw = function (strings, ...values) { + let output = ''; + let index; + for (index = 0; index < values.length; index++) { + output += strings.raw[index] + values[index]; + } + + output += strings.raw[index] + return output; +} +``` + ## 模板字符串的限制 -前面提到标签模板里面,可以内嵌其他语言。但是,模板字符串默认会将字符串转义,因此导致了无法嵌入其他语言。 +前面提到标签模板里面,可以内嵌其他语言。但是,模板字符串默认会将字符串转义,导致无法嵌入其他语言。 -举例来说,在标签模板里面可以嵌入Latex语言。 +举例来说,标签模板里面可以嵌入 LaTEX 语言。 ```javascript function latex(strings) { @@ -924,11 +909,11 @@ Breve over the h goes \u{h}ere // 报错 ` ``` -上面代码中,变量`document`内嵌的模板字符串,对于Latex语言来说完全是合法的,但是JavaScript引擎会报错。原因就在于字符串的转义。 +上面代码中,变量`document`内嵌的模板字符串,对于 LaTEX 语言来说完全是合法的,但是 JavaScript 引擎会报错。原因就在于字符串的转义。 -模板字符串会将`\u00FF`和`\u{42}`当作Unicode字符进行转义,所以`\unicode`解析时报错;而`\x56`会被当作十六进制字符串转义,所以`\xerxes`会报错。 +模板字符串会将`\u00FF`和`\u{42}`当作 Unicode 字符进行转义,所以`\unicode`解析时报错;而`\x56`会被当作十六进制字符串转义,所以`\xerxes`会报错。也就是说,`\u`和`\x`在 LaTEX 里面有特殊含义,但是 JavaScript 将它们转义了。 -为了解决这个问题,现在有一个[提案](https://tc39.github.io/proposal-template-literal-revision/),放松对标签模板里面的字符串转义的限制。如果遇到不合法的字符串转义,就返回`undefined`,而不是报错,并且从`raw`属性上面可以得到原始字符串。 +为了解决这个问题,ES2018 [放松](https://tc39.github.io/proposal-template-literal-revision/)了对标签模板里面的字符串转义的限制。如果遇到不合法的字符串转义,就返回`undefined`,而不是报错,并且从`raw`属性上面可以得到原始字符串。 ```javascript function tag(strs) { @@ -938,7 +923,7 @@ function tag(strs) { tag`\unicode and \u{55}` ``` -上面代码中,模板字符串原本是应该报错的,但是由于放松了对字符串转义的限制,所以不报错了,JavaScript引擎将第一个字符设置为`undefined`,但是`raw`属性依然可以得到原始字符串,因此`tag`函数还是可以对原字符串进行处理。 +上面代码中,模板字符串原本是应该报错的,但是由于放松了对字符串转义的限制,所以不报错了,JavaScript 引擎将第一个字符设置为`undefined`,但是`raw`属性依然可以得到原始字符串,因此`tag`函数还是可以对原字符串进行处理。 注意,这种对字符串转义的放松,只在标签模板解析字符串时生效,不是标签模板的场合,依然会报错。 diff --git "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/style.md" "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/style.md" old mode 100644 new mode 100755 similarity index 76% rename from "02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/style.md" rename to "02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/style.md" index 37f1ae4d7..14d4aece0 --- "a/02-ES\346\226\260\347\211\271\346\200\247/ES6/es6tutorial-gh-pages/docs/style.md" +++ "b/02-ES\346\226\260\347\211\271\346\200\247/es6tutorial-gh-pages/docs/style.md" @@ -1,14 +1,14 @@ # 编程风格 -本章探讨如何将ES6的新语法,运用到编码实践之中,与传统的JavaScript语法结合在一起,写出合理的、易于阅读和维护的代码。 +本章探讨如何将 ES6 的新语法,运用到编码实践之中,与传统的 JavaScript 语法结合在一起,写出合理的、易于阅读和维护的代码。 -多家公司和组织已经公开了它们的风格规范,具体可参阅[jscs.info](http://jscs.info/),下面的内容主要参考了[Airbnb](https://github.com/airbnb/javascript)的JavaScript风格规范。 +多家公司和组织已经公开了它们的风格规范,下面的内容主要参考了 [Airbnb](https://github.com/airbnb/javascript) 公司的 JavaScript 风格规范。 ## 块级作用域 **(1)let 取代 var** -ES6提出了两个新的声明变量的命令:`let`和`const`。其中,`let`完全可以取代`var`,因为两者语义相同,而且`let`没有副作用。 +ES6 提出了两个新的声明变量的命令:`let`和`const`。其中,`let`完全可以取代`var`,因为两者语义相同,而且`let`没有副作用。 ```javascript 'use strict'; @@ -29,7 +29,7 @@ for (let i = 0; i < 10; i++) { ```javascript 'use strict'; -if(true) { +if (true) { console.log(x); // ReferenceError let x = 'hello'; } @@ -43,7 +43,7 @@ if(true) { 在`let`和`const`之间,建议优先使用`const`,尤其是在全局环境,不应该设置变量,只应设置常量。 -`const`优于`let`有几个原因。一个是`const`可以提醒阅读程序的人,这个变量不应该改变;另一个是`const`比较符合函数式编程思想,运算不改变值,只是新建值,而且这样也有利于将来的分布式运算;最后一个原因是 JavaScript 编译器会对`const`进行优化,所以多使用`const`,有利于提供程序的运行效率,也就是说`let`和`const`的本质区别,其实是编译器内部的处理不同。 +`const`优于`let`有几个原因。一个是`const`可以提醒阅读程序的人,这个变量不应该改变;另一个是`const`比较符合函数式编程思想,运算不改变值,只是新建值,而且这样也有利于将来的分布式运算;最后一个原因是 JavaScript 编译器会对`const`进行优化,所以多使用`const`,有利于提高程序的运行效率,也就是说`let`和`const`的本质区别,其实是编译器内部的处理不同。 ```javascript // bad @@ -62,7 +62,7 @@ const [a, b, c] = [1, 2, 3]; 所有的函数都应该设置为常量。 -长远来看,JavaScript可能会有多线程的实现(比如Intel的River Trail那一类的项目),这时`let`表示的变量,只应出现在单线程运行的代码中,不能是多线程共享的,这样有利于保证线程安全。 +长远来看,JavaScript 可能会有多线程的实现(比如 Intel 公司的 River Trail 那一类的项目),这时`let`表示的变量,只应出现在单线程运行的代码中,不能是多线程共享的,这样有利于保证线程安全。 ## 字符串 @@ -79,7 +79,6 @@ const c = `foobar`; // good const a = 'foobar'; const b = `foo${a}bar`; -const c = 'foobar'; ``` ## 解构赋值 @@ -234,7 +233,7 @@ for (i = 0; i < len; i++) { const itemsCopy = [...items]; ``` -使用Array.from方法,将类似数组的对象转为数组。 +使用 Array.from 方法,将类似数组的对象转为数组。 ```javascript const foo = document.querySelectorAll('.foo'); @@ -251,7 +250,7 @@ const nodes = Array.from(foo); })(); ``` -那些需要使用函数表达式的场合,尽量用箭头函数代替。因为这样更简洁,而且绑定了this。 +那些需要使用函数表达式的场合,尽量用箭头函数代替。因为这样更简洁,而且绑定了 this。 ```javascript // bad @@ -268,7 +267,7 @@ const nodes = Array.from(foo); [1, 2, 3].map(x => x * x); ``` -箭头函数取代`Function.prototype.bind`,不应再用self/\_this/that绑定 this。 +箭头函数取代`Function.prototype.bind`,不应再用 self/\_this/that 绑定 this。 ```javascript // bad @@ -298,7 +297,7 @@ function divide(a, b, { option = false } = {}) { } ``` -不要在函数体内使用arguments变量,使用rest运算符(...)代替。因为rest运算符显式表明你想要获取参数,而且arguments是一个类似数组的对象,而rest运算符可以提供一个真正的数组。 +不要在函数体内使用 arguments 变量,使用 rest 运算符(...)代替。因为 rest 运算符显式表明你想要获取参数,而且 arguments 是一个类似数组的对象,而 rest 运算符可以提供一个真正的数组。 ```javascript // bad @@ -327,9 +326,9 @@ function handleThings(opts = {}) { } ``` -## Map结构 +## Map 结构 -注意区分Object和Map,只有模拟现实世界的实体对象时,才使用Object。如果只是需要`key: value`的数据结构,使用Map结构。因为Map有内建的遍历机制。 +注意区分 Object 和 Map,只有模拟现实世界的实体对象时,才使用 Object。如果只是需要`key: value`的数据结构,使用 Map 结构。因为 Map 有内建的遍历机制。 ```javascript let map = new Map(arr); @@ -349,7 +348,7 @@ for (let item of map.entries()) { ## Class -总是用Class,取代需要prototype的操作。因为Class的写法更简洁,更易于理解。 +总是用 Class,取代需要 prototype 的操作。因为 Class 的写法更简洁,更易于理解。 ```javascript // bad @@ -398,7 +397,7 @@ class PeekableQueue extends Queue { ## 模块 -首先,Module语法是JavaScript模块的标准写法,坚持使用这种写法。使用`import`取代`require`。 +首先,Module 语法是 JavaScript 模块的标准写法,坚持使用这种写法。使用`import`取代`require`。 ```javascript // bad @@ -427,22 +426,22 @@ module.exports = Breadcrumbs; // ES6的写法 import React from 'react'; -const Breadcrumbs = React.createClass({ +class Breadcrumbs extends React.Component { render() { return