Skip to content

Commit 002ddda

Browse files
committed
docs(async): edit async
1 parent 2b9fe07 commit 002ddda

File tree

1 file changed

+18
-8
lines changed

1 file changed

+18
-8
lines changed

docs/async.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ var gen = function* () {
3131
写成`async`函数,就是下面这样。
3232

3333
```javascript
34-
var asyncReadFile = async function (){
34+
var asyncReadFile = async function () {
3535
var f1 = await readFile('/etc/fstab');
3636
var f2 = await readFile('/etc/shells');
3737
console.log(f1.toString());
@@ -43,24 +43,34 @@ var asyncReadFile = async function (){
4343

4444
`async`函数对 Generator 函数的改进,体现在以下四点。
4545

46-
(1)内置执行器。Generator 函数的执行必须靠执行器,所以才有了`co`模块,而`async`函数自带执行器。也就是说,`async`函数的执行,与普通函数一模一样,只要一行。
46+
(1)内置执行器。
47+
48+
Generator 函数的执行必须靠执行器,所以才有了`co`模块,而`async`函数自带执行器。也就是说,`async`函数的执行,与普通函数一模一样,只要一行。
4749

4850
```javascript
4951
var result = asyncReadFile();
5052
```
5153

52-
上面的代码调用了`asyncReadFile`函数,然后它就会自动执行,输出最后结果。这完全不像 Generator 函数,需要调用`next`方法,或者用`co`模块,才能得到真正执行,得到最后结果。
54+
上面的代码调用了`asyncReadFile`函数,然后它就会自动执行,输出最后结果。这完全不像 Generator 函数,需要调用`next`方法,或者用`co`模块,才能真正执行,得到最后结果。
55+
56+
(2)更好的语义。
57+
58+
`async``await`,比起星号和`yield`,语义更清楚了。`async`表示函数里有异步操作,`await`表示紧跟在后面的表达式需要等待结果。
5359

54-
2)更好的语义。`async``await`,比起星号和`yield`,语义更清楚了。`async`表示函数里有异步操作,`await`表示紧跟在后面的表达式需要等待结果
60+
3)更广的适用性
5561

56-
(3)更广的适用性。 `co`模块约定,`yield`命令后面只能是 Thunk 函数或 Promise 对象,而`async`函数的`await`命令后面,可以是Promise 对象和原始类型的值(数值、字符串和布尔值,但这时等同于同步操作)。
62+
`co`模块约定,`yield`命令后面只能是 Thunk 函数或 Promise 对象,而`async`函数的`await`命令后面,可以是Promise 对象和原始类型的值(数值、字符串和布尔值,但这时等同于同步操作)。
5763

58-
(4)返回值是 Promise。`async`函数的返回值是 Promise 对象,这比 Generator 函数的返回值是 Iterator 对象方便多了。你可以用`then`方法指定下一步的操作。
64+
(4)返回值是 Promise。
65+
66+
`async`函数的返回值是 Promise 对象,这比 Generator 函数的返回值是 Iterator 对象方便多了。你可以用`then`方法指定下一步的操作。
5967

6068
进一步说,`async`函数完全可以看作多个异步操作,包装成的一个 Promise 对象,而`await`命令就是内部`then`命令的语法糖。
6169

6270
## 用法
6371

72+
### 基本用法
73+
6474
`async`函数返回一个 Promise 对象,可以使用`then`方法添加回调函数。当函数执行的时候,一旦遇到`await`就会先返回,等到异步操作完成,再接着执行函数体内后面的语句。
6575

6676
下面是一个例子。
@@ -79,7 +89,7 @@ getStockPriceByName('goog').then(function (result) {
7989

8090
上面代码是一个获取股票报价的函数,函数前面的`async`关键字,表明该函数内部有异步操作。调用该函数时,会立即返回一个`Promise`对象。
8191

82-
下面的例子,指定多少毫秒后输出一个值。
92+
下面是另一个例子,指定多少毫秒后输出一个值。
8393

8494
```javascript
8595
function timeout(ms) {
@@ -98,7 +108,7 @@ asyncPrint('hello world', 50);
98108

99109
上面代码指定50毫秒以后,输出`hello world`
100110

101-
Async 函数有多种使用形式。
111+
async 函数有多种使用形式。
102112

103113
```javascript
104114
// 函数声明

0 commit comments

Comments
 (0)