如何将回调函数转为Promise？

在现代化JavaScript项目中，我们经常需要将遗留的、基于回调的API转换为返回Promise的形式，以便使用async/await或Promise链进行更优雅的调用。这个过程通常被称为“Promise化”或“Promisify”。

手动包装回调函数

核心思想是创建一个新的函数，这个函数返回一个Promise。在函数内部，调用原始的回调风格函数，并依据其回调的调用情况来手动resolve或reject返回的Promise。

function readFilePromise(filePath) {
  return new Promise((resolve, reject) => {
    fs.readFile(filePath, 'utf8', (error, data) => {
      if (error) {
        reject(error);
      } else {
        resolve(data);
      }
    });
  });
}

// 使用
readFilePromise('data.txt')
  .then(data => console.log(data))
  .catch(err => console.error(err));

这是一个标准的模式：在Promise执行器里调用原函数，并在其回调中根据错误优先的惯例，决定是拒绝还是解决Promise。

编写通用工具函数

如果要转换大量遵循“错误优先”风格的回调函数（即回调的第一个参数是错误对象），可以编写一个通用的工具函数。

function promisify(fn) {
  return function(...args) {
    return new Promise((resolve, reject) => {
      fn(...args, (error, result) => {
        if (error) {
          reject(error);
        } else {
          resolve(result);
        }
      });
    });
  };
}

// 使用
const readFileAsync = promisify(fs.readFile);
readFileAsync('data.txt', 'utf8').then(console.log);

这个promisify函数接收一个回调函数fn，并返回一个新的函数。新函数接收原函数除回调以外的所有参数，并在内部自动附加一个遵循错误优先约定的回调，以完成Promise的转换。

处理非常规回调与Node.js内置工具

如果回调函数不遵循(error, result)的标准格式，或者有多个成功参数，就需要自定义适配逻辑。

function customPromisify(fn) {
  return function(...args) {
    return new Promise((resolve, reject) => {
      fn(...args, (...results) => {
        // 根据具体回调的调用方式处理results数组
        if (results[0]) {
          reject(results[0]);
        } else {
          resolve(results.length > 2 ? results.slice(1) : results[1]);
        }
      });
    });
  };
}

对于Node.js环境，util模块已经提供了成熟的promisify方法，可以直接使用。

const util = require('util');
const readFileAsync = util.promisify(fs.readFile);

Node.js的util.promisify能处理大多数标准API，对于不兼容的情况，它支持通过util.promisify.custom符号进行自定义。

在实际应用中，优先使用Node.js内置的util.promisify或第三方库。对于浏览器环境或特殊需求，手动实现一个包装器也很简单。将回调转为Promise是代码现代化的重要一步，它能让你充分利用更清晰的异步流程控制。