• original {Function} async 异步函数。
    • 返回: {Function} 传统回调函数。

    async 异步函数(或者一个返回值为 Promise 的函数)转换成遵循异常优先的回调风格的函数,例如将 (err, value) => ... 回调作为最后一个参数。 在回调函数中,第一个参数为拒绝的原因(如果 Promise 解决,则为 null),第二个参数则是解决的值。

    1. const util = require('util');
    2. async function fn() {
    3. return 'hello world';
    4. }
    5. const callbackFunction = util.callbackify(fn);
    6. callbackFunction((err, ret) => {
    7. if (err) throw err;
    8. console.log(ret);
    9. });

    将会打印出:

    1. hello world

    回调函数是异步执行的,并且有异常堆栈错误追踪。 如果回调函数抛出一个异常,进程会触发一个 ['uncaughtException'][] 异常,如果没有被捕获,进程将会退出。

    null 在回调函数中作为一个参数有其特殊的意义,如果回调函数的首个参数为 Promise 拒绝的原因且带有返回值,且值可以转换成布尔值 false,这个值会被封装在 Error 对象里,可以通过属性 reason 获取。

    1. function fn() {
    2. return Promise.reject(null);
    3. }
    4. const callbackFunction = util.callbackify(fn);
    5. callbackFunction((err, ret) => {
    6. // 当 Promise 被以 `null` 拒绝时,它被包装为 Error 并且原始值存储在 `reason` 中。
    7. err && err.hasOwnProperty('reason') && err.reason === null; // true
    8. });