edit function/spread operator

Author: ruanyf

docs/class.md

@@ -50,9 +50,34 @@ class ColorPoint extends Point {
 
 ## Module的基本用法
 
-ES6允许将独立的js文件作为模块，也就是说，允许一个JavaScript脚本文件调用另一个脚本文件，从而使得模块化编程成为可能。
+ES6实现了模块功能，试图解决JavaScript代码的依赖和部署上的问题。模块功能有两个关键字：export和import。export用于用户自定义模块，规定对外接口；import用于输入其他模块提供的功能，同时创造命名空间（namespace），防止函数名冲突。
 
-假设有一个circle.js，它是一个单独模块。
+ES6允许将独立的JS文件作为模块，也就是说，允许一个JavaScript脚本文件调用另一个脚本文件。最简单的模块就是一个JS文件，里面使用export关键字输出变量。
+
+```javascript
+
+// profile.js
+export var firstName = 'David';
+export var lastName = 'Belle';
+export var year = 1973;
+
+```
+
+上面是profile.js，ES6将其视为一个模块，里面用export关键字输出了三个变量。其他js文件就可以通过import关键字加载这个模块（文件）。
+
+```javascript
+
+import {firstName, lastName, year} from './profile';
+
+function setHeader(element) {
+  element.textContent = firstName + ' ' + lastName;
+}
+
+```
+
+上面代码中import关键字接受一个对象（用大括号表示），里面指定要从其他模块导入的变量。大括号里面的变量名，必须与被导入模块对外接口的名称相同。
+
+export关键字除了输出变量，还可以输出方法。下面是一个circle.js文件，它输出两个方法。
 
 ```javascript
 
@@ -68,8 +93,6 @@ export function circumference(radius) {
 
 ```
 
-上面代码中的export关键字，表示这个方法是对外开放的接口。
-
 然后，main.js引用这个模块。
 
 ```javascript
@@ -82,10 +105,7 @@ console.log("圆面积：" + area(4));
 console.log("圆周长：" + circumference(14));
 
 ```
-
-import语句用来导入模块，它接受一个对象，里面指定所要导入的方法，后面的from指定模块名。
-
-另一种写法是使用module命令，整体加载circle.js。
+上面写法是逐一指定要导入的方法。另一种写法是使用module关键字，整体导入。
 
 ```javascript
 
@@ -98,7 +118,7 @@ console.log("圆周长：" + circle.circumference(14));
 
 ```
 
-module命令跟一个变量，表示加载的模块定义在该变量上。
+module关键字后面跟一个变量，表示导入的模块定义在该变量上。
 
 ## 模块的继承
 

docs/function.md

@@ -37,9 +37,9 @@ foo()
 
 上面代码的foo函数，如果调用的时候没有参数，就会调用默认值throwIfMissing函数，从而抛出一个错误。
 
-## rest（...）运算符
+## rest参数
 
-ES6引入rest运算符（...），用于获取函数的多余参数，这样就不需要使用arguments.length了。rest运算符后面是一个数组变量，该变量将多余的参数放入数组中。
+ES6引入rest参数（...变量名），用于获取函数的多余参数，这样就不需要使用arguments对象了。rest参数搭配的变量是一个数组，该变量将多余的参数放入数组中。
 
 ```javascript
 
@@ -57,9 +57,9 @@ add(2, 5, 3) // 10
 
 ```
 
-上面代码的add函数是一个求和函数，利用rest运算符，可以向该函数传入任意数目的参数。
+上面代码的add函数是一个求和函数，利用rest参数，可以向该函数传入任意数目的参数。
 
-下面是一个利用rest运算符改写数组push方法的例子。
+前面说过，rest参数中的变量代表一个数组，所以数组特有的方法都可以用于这个变量。下面是一个利用rest参数改写数组push方法的例子。
 
 ```javascript
 
@@ -71,7 +71,7 @@ function push(array, ...items) {
 }
 
 var a = [];
-push(a, "a1", "a2", "a3", "a4"); 
+push(a, 1, 2, 3) 
 
 ```
 
@@ -86,22 +86,26 @@ function f(a, ...b, c) {
 
 ```
 
-rest运算符不仅可以用于函数定义，还可以用于函数调用。
+## 扩展运算符
+
+扩展运算符（spread）是三个点（...）。它好比rest参数的逆运算，将一个数组转为用逗号分隔的参数序列。该运算符主要用于函数调用。
 
 ```javascript
 
-function f(s1, s2, s3, s4, s5) {
-    console.log(s1 + s2 + s3 + s4 +s5);
+function push(array, ...items) {
+  array.push(...items);
 }
 
-var a = ["a2", "a3", "a4", "a5"];
+function add(x, y) {
+  return x + y;
+}
 
-f("a1", ...a)
-// a1a2a3a4a5
+var numbers = [4, 38];
+add(...numbers) // 42
 
 ```
 
-从上面的例子可以看出，rest运算符的另一个重要作用是，可以将数组转变成正常的参数序列。利用这一点，可以简化求出一个数组最大元素的写法。
+扩展运算符可以简化求出一个数组最大元素的写法。
 
 ```javascript
 
@@ -116,7 +120,21 @@ Math.max(14, 3, 77);
 
 ```
 
-上面代码表示，由于JavaScript不提供求数组最大元素的函数，所以只能套用Math.max函数，将数组转为一个参数序列，然后求最大值。有了rest运算符以后，就可以直接用Math.max了。
+上面代码表示，由于JavaScript不提供求数组最大元素的函数，所以只能套用Math.max函数，将数组转为一个参数序列，然后求最大值。有了扩展运算符以后，就可以直接用Math.max了。
+
+扩展运算符还可以用于数组的赋值。
+
+```javascript
+
+var a = [1];
+var b = [2, 3, 4];
+var c = [6, 7];
+var d = [0, ...a, ...b, 5, ...c];
+
+d
+// [0, 1, 2, 3, 4, 5, 6, 7]
+
+```
 
 ## 箭头函数
 

docs/object.md

@@ -49,6 +49,22 @@ var Person = {
 
 ```
 
+这种写法用于函数的返回值，将会非常方便。
+
+```javascript
+
+function getPoint() {
+  var x = 1;
+  var y = 10;
+
+  return {x, y};
+}
+
+getPoint()
+// {x:1, y:10}
+
+```
+
 ## 属性名表达式
 
 ES6允许定义对象时，用表达式作为对象的属性名。在写法上，要把表达式放在方括号内。