来自一峰ES6教程
一、含义
async 函数是什么?一句话,它就是 Generator 函数的语法糖
const fs = require ('fs' );const readFile = function (fileName ) { return new Promise (function (resolve, reject ) { fs.readFile (fileName, function (error, data ) { if (error) return reject (error); resolve (data); }); }); }; const gen = function * () { const f1 = yield readFile ('/etc/fstab' ); const f2 = yield readFile ('/etc/shells' ); console .log (f1.toString ()); console .log (f2.toString ()); };
上面代码的函数gen可以写成async函数,就是下面这样
const asyncReadFile = async function ( ) { const f1 = await readFile ('/etc/fstab' ); const f2 = await readFile ('/etc/shells' ); console .log (f1.toString ()); console .log (f2.toString ()); };
async函数就是将 Generator 函数的星号(*)替换成async,将yield替换成await,仅此而已
async函数对 Generator 函数的改进,体现在以下四点
内置执行器
Generator 函数的执行必须靠执行器,所以才有了co模块,而async函数自带执行器。也就是说,async函数的执行,与普通函数一模一样,只要一行
上面的代码调用了asyncReadFile函数,然后它就会自动执行,输出最后结果。这完全不像 Generator 函数,需要调用next方法,或者用co模块,才能真正执行,得到最后结果
更好的语义
async和await,比起星号和yield,语义更清楚了。async表示函数里有异步操作,await表示紧跟在后面的表达式需要等待结果
更广的适用性
co模块约定,yield命令后面只能是 Thunk 函数或 Promise 对象,而async函数的await命令后面,可以是 Promise 对象和原始类型的值(数值、字符串和布尔值,但这时等同于同步操作)
返回值是 Promise
async函数的返回值是 Promise 对象,这比 Generator 函数的返回值是 Iterator 对象方便多了。你可以用then方法指定下一步的操作
进一步说,async函数完全可以看作多个异步操作,包装成的一个 Promise 对象,而await命令就是内部then命令的语法糖
二、基本用法
async函数返回一个 Promise 对象,可以使用then方法添加回调函数。当函数执行的时候,一旦遇到await就会先返回,等到异步操作完成,再接着执行函数体内后面的语句
async function getStockPriceByName (name ) { const symbol = await getStockSymbol (name); const stockPrice = await getStockPrice (symbol); return stockPrice; } getStockPriceByName ('goog' ).then (function (result ) { console .log (result); });
async 函数有多种使用形式
async function foo ( ) {}const foo = async function ( ) {};let obj = { async foo ( ) {} };obj.foo ().then (...) class Storage { constructor ( ) { this .cachePromise = caches.open ('avatars' ); } async getAvatar (name ) { const cache = await this .cachePromise ; return cache.match (`/avatars/${name} .jpg` ); } } const storage = new Storage ();storage.getAvatar ('jake' ).then (…); const foo = async ( ) => {};
三、语法
async函数的语法规则总体上比较简单,难点是错误处理机制
3.1 返回 Promise 对象
async函数返回一个 Promise 对象
async函数内部return语句返回的值,会成为then方法回调函数的参数
async function f ( ) { return 'hello world' ; } f ().then (v => console .log (v))
async函数内部抛出错误,会导致返回的 Promise 对象变为reject状态。抛出的错误对象会被catch方法回调函数接收到
async function f ( ) { throw new Error ('出错了' ); } f ().then ( v => console .log (v), e => console .log (e) )
3.2 Promise 对象的状态变化
async函数返回的 Promise 对象,必须等到内部所有await命令后面的 Promise 对象执行完,才会发生状态改变,除非遇到return语句或者抛出错误。也就是说,只有async函数内部的异步操作执行完,才会执行then方法指定的回调函数
async function getTitle (url ) { let response = await fetch (url); let html = await response.text (); return html.match (/<title>([\s\S]+)<\/title>/i )[1 ]; } getTitle ('https://tc39.github.io/ecma262/' ).then (console .log )
3.3 await 命令
正常情况下,await命令后面是一个 Promise 对象,返回该对象的结果。如果不是 Promise 对象,就直接返回对应的值
async function f ( ) { return await 123 ; } f ().then (v => console .log (v))
另一种情况是,await命令后面是一个thenable对象(即定义then方法的对象),那么await会将其等同于 Promise 对象
await命令后面的 Promise 对象如果变为reject状态,则reject的参数会被catch方法的回调函数接收到。
async function f ( ) { await Promise .reject ('出错了' ); } f ().then (v => console .log (v)) .catch (e => console .log (e))
注意,上面代码中,await语句前面没有return,但是reject方法的参数依然传入了catch方法的回调函数。这里如果在await前面加上return,效果是一样的。
任何一个await语句后面的 Promise 对象变为reject状态,那么整个async函数都会中断执行
async function f ( ) { await Promise .reject ('出错了' ); await Promise .resolve ('hello world' ); }
有时,我们希望即使前一个异步操作失败,也不要中断后面的异步操作。这时可以将第一个await放在try...catch结构里面,这样不管这个异步操作是否成功,第二个await都会执行
async function f ( ) { try { await Promise .reject ('出错了' ); } catch (e) { } return await Promise .resolve ('hello world' ); } f ().then (v => console .log (v))
另一种方法是await后面的 Promise 对象再跟一个catch方法,处理前面可能出现的错误。
async function f ( ) { await Promise .reject ('出错了' ) .catch (e => console .log (e)); return await Promise .resolve ('hello world' ); } f ().then (v => console .log (v))
3.4 错误处理
如果await后面的异步操作出错,那么等同于async函数返回的 Promise 对象被reject
async function f ( ) { await new Promise (function (resolve, reject ) { throw new Error ('出错了' ); }); } f ().then (v => console .log (v)) .catch (e => console .log (e))
防止出错的方法,也是将其放在try...catch代码块之中
async function f ( ) { try { await new Promise (function (resolve, reject ) { throw new Error ('出错了' ); }); } catch (e) { } return await ('hello world' ); }
如果有多个await命令,可以统一放在try...catch结构中
async function main ( ) { try { const val1 = await firstStep (); const val2 = await secondStep (val1); const val3 = await thirdStep (val1, val2); console .log ('Final: ' , val3); } catch (err) { console .error (err); } }
3.5 使用注意点
第一点:await命令后面的Promise对象,运行结果可能是rejected,所以最好把await命令放在try...catch代码块中
async function myFunction ( ) { try { await somethingThatReturnsAPromise (); } catch (err) { console .log (err); } } async function myFunction ( ) { await somethingThatReturnsAPromise () .catch (function (err ) { console .log (err); }); }
第二点,多个await命令后面的异步操作,如果不存在继发关系,最好让它们同时触发
let foo = await getFoo ();let bar = await getBar ();
let [foo, bar] = await Promise .all ([getFoo (), getBar ()]);let fooPromise = getFoo ();let barPromise = getBar ();let foo = await fooPromise;let bar = await barPromise;
第三点,await命令只能用在async函数之中,如果用在普通函数,就会报错
async function dbFuc (db ) { let docs = [{}, {}, {}]; docs.forEach (function (doc ) { await db.post (doc); }); }
四、async 函数的实现原理
async 函数的实现原理,就是将 Generator 函数和自动执行器,包装在一个函数里
async function fn (args ) { } function fn (args ) { return spawn (function * () { }); }
所有的async函数都可以写成上面的第二种形式,其中的spawn函数就是自动执行器
function spawn (genF ) { return new Promise (function (resolve, reject ) { const gen = genF (); function step (nextF ) { let next; try { next = nextF (); } catch (e) { return reject (e); } if (next.done ) { return resolve (next.value ); } Promise .resolve (next.value ).then (function (v ) { step (function ( ) { return gen.next (v); }); }, function (e ) { step (function ( ) { return gen.throw (e); }); }); } step (function ( ) { return gen.next (undefined ); }); }); }