Node.js 怎么用 util.promisify 把回调函数转成 Promise？

Question

仓乃文 · Accepted Answer

旧版 Node.js API 和第三方库大量使用 error-first 回调风格，无法用 async/await。util.promisify 将符合 error-first 约定的回调函数转为返回 Promise 的函数，一行代码完成回调到 Promise 的转换。

基本转换：
```javascript
const util = require("util");
const fs = require("fs");

const readFile = util.promisify(fs.readFile);

async function main() {
  const data = await readFile("config.json", "utf8");
  console.log(data);
}
```

批量转换：
```javascript
const { promisify } = require("util");
const fs = require("fs");

const readFile = promisify(fs.readFile);
const writeFile = promisify(fs.writeFile);
const mkdir = promisify(fs.mkdir);
```

自定义 promisify 行为：
```javascript
function customCallback(data, callback) {
  callback(null, data.toUpperCase());
}

customCallback[promisify.custom] = (data) => {
  return new Promise((resolve) => {
    customCallback(data, (err, result) => resolve(result));
  });
};

const fn = promisify(customCallback);
```

补充说明：
- 只支持 error-first 回调格式：(err, result) => {}
- Node.js 10+ fs 模块自带 fs.promises API，无需手动 promisify
- promisify.custom 符号可以覆盖默认转换逻辑
- 对于不规范的回调函数，需要手动包装 Promise
- util.callbackify 可以反向将 Promise 函数转回调