使用pify库，你可以非常便利地将任何遵循Node.js回调风格的函数转换为返回Promise对象的函数，从而使得你的异步代码更加清晰和易于维护。本文通过丰富的代码示例引导你如何有效地利用pify，让你的异步编程之旅更加畅快。

安装pify
为了开始使用pify，你首先需要通过NPM把它添加到你的项目中。

npm install pify

如何使用pify

使用pify非常简单，你可以将它应用于单个函数或者转换模块中的所有方法。

单个函数Promise化
将fs.readFile这样的单个回调风格的函数转换，如下所示：

// 引入fs模块和pify
import fs from 'fs';
import pify from 'pify';

// Promise化读取文件函数
const readFileAsync = pify(fs.readFile);

// 使用async/await读取文件
async function readPackageJson() {
  const data = await readFileAsync('package.json', 'utf8');
  console.log(JSON.parse(data).name);  //=> "pify"
}

readPackageJson();

模块方法全部Promise化
如果你想要转换一个模块中的所有方法，只需直接将模块传递给pify。

// Promise化整个fs模块
const fsAsync = pify(fs);
// 堆代码 duidaima.com
// 使用async/await读取文件
async function readPackageJson() {
  const data = await fsAsync.readFile('package.json', 'utf8');
  console.log(JSON.parse(data).name);  //=> "pify"
}

readPackageJson();

API选项详解
pify提供了一些选项，让你可以更加灵活地控制转换的过程。
multiArgs - 处理多个返回值

// 处理具有多个返回值的request函数
import request from 'request';
import pify from 'pify';

// 开启multiArgs选项
const pRequest = pify(request, { multiArgs: true });

async function fetchWebsite() {
  const [httpResponse, body] = await pRequest('https://sindresorhus.com');
  console.log(body);  // 网站内容
}

fetchWebsite();

include/exclude - 指定转换哪些方法
通过include和exclude选项，你可以控制哪些方法被Promise化，哪些不被转换。

// 仅转换指定的方法
const fsPromises = pify(fs, {
  include: ['readFile', 'writeFile']
});

// 或者排除某些方法
const fsPromises = pify(fs, {
  exclude: ['readSync', 'writeSync']
});

excludeMain - 排除模块本身的转换
如果模块本身也是一个函数，使用excludeMain选项以排除它。

function moduleFunction() {
  return true;
}

moduleFunction.someMethod = (callback) => {
  callback(null, 'Hello, pify!');
};

// 使用excludeMain选项
const promisifiedModule = pify(moduleFunction, { excludeMain: true });

async function useModule() {
  // 直接调用模块将得到原始函数的返回值
  console.log(promisifiedModule());  //=> true
  // 模块的方法已经被Promise化
  console.log(await promisifiedModule.someMethod());  //=> "Hello, pify!"
}

useModule();

与Node.js的util.promisify相比

pify和Node.js内置的util.promisify有一些不同之处。虽然它们都可以将回调风格的函数转换为Promise，但是pify提供了额外的灵活性和一些有用的选项，并且在多种情况下表现更好。

常见问题
处理类方法或者函数重载时，我们可能会遇到上下文绑定的问题或者类型推导问题。pify使这些情形处理变得简单。