util.promisify 的那些事儿 (2)

在一些内置包中，也能够找到promisify.custom的踪迹，比如说最常用的child_process.exec就内置了promisify.custom的处理：

const { exec } = require('child_process') const { promisify } = require('util') console.log(typeof exec[promisify.custom]) // function

因为就像前边示例中所提到的曲线救国的方案，官方的做法也是将函数签名中的参数名作为key，将其所有参数存放到一个Object对象中进行返回，比如child_process.exec的返回值抛开error以外会包含两个，stdout和stderr，一个是命令执行后的正确输出，一个是命令执行后的错误输出：

promisify(exec)('ls').then(console.log) // -> { stdout: 'XXX', stderr: '' }

或者我们故意输入一些错误的命令，当然了，这个只能在catch模块下才能够捕捉到，一般命令正常执行stderr都会是一个空字符串：

promisify(exec)('lss').then(console.log, console.error) // -> { ..., stdout: '', stderr: 'lss: command not found' }

包括像setTimeout、setImmediate也都实现了对应的promisify.custom。
之前为了实现sleep的操作，还手动使用Promise封装了setTimeout：

const sleep = promisify(setTimeout) console.log(new Date()) await sleep(1000) console.log(new Date()) 内置的 promisify 转换后函数

如果你的Node版本使用10.x以上的，还可以从很多内置的模块中找到类似.promises的子模块，这里边包含了该模块中常用的回调函数的Promise版本（都是async函数），无需再手动进行promisify转换了。

而且我本人觉得这是一个很好的指引方向，因为之前的工具实现，有的选择直接覆盖原有函数，有的则是在原有函数名后边增加Async进行区分，官方的这种在模块中单独引入一个子模块，在里边实现Promise版本的函数，其实这个在使用上是很方便的，就拿fs模块进行举例：

// 之前引入一些 fs 相关的 API 是这样做的 const { readFile, stat } = require('fs') // 而现在可以很简单的改为 const { readFile, stat } = require('fs').promises // 或者 const { promises: { readFile, stat } } = require('fs')

后边要做的就是将调用promisify相关的代码删掉即可，对于其他使用API的代码来讲，这个改动是无感知的。
所以如果你的node版本够高的话，可以在使用内置模块之前先去翻看文档，有没有对应的promises支持，如果有实现的话，就可以直接使用。

promisify 的一些注意事项

一定要符合Error first callback的约定

不能返回多个参数

注意进行转换的函数是否包含this的引用

前两个问题，使用前边提到的promisify.custom都可以解决掉。
但是第三项可能会在某些情况下被我们所忽视，这并不是promisify独有的问题，就一个很简单的例子：

const obj = { name: 'Niko', getName () { return this.name } } obj.getName() // Niko const func = obj.getName func() // undefined

类似的，如果我们在进行Promise转换的时候，也是类似这样的操作，那么可能会导致生成后的函数this指向出现问题。
修复这样的问题有两种途径：

使用箭头函数，也是推荐的做法

在调用promisify之前使用bind绑定对应的this

不过这样的问题也是建立在promisify转换后的函数被赋值给其他变量的情况下会发生。
如果是类似这样的代码，那么完全不必担心this指向的问题：

const obj = { name: 'Niko', getName (callback) { callback(null, this.name) } } // 这样的操作是不需要担心 this 指向问题的 obj.XXX = promisify(obj.getName) // 如果赋值给了其他变量，那么这里就需要注意 this 的指向了 const func = promisify(obj.getName) // 错误的 this 小结

个人认为Promise作为当代javaScript异步编程中最核心的一部分，了解如何将老旧代码转换为Promise是一件很有意思的事儿。
而我去了解官方的这个工具，原因是在搜索Redis相关的Promise版本时看到了这个readme：

This package is no longer maintained. node_redis now includes support for promises in core, so this is no longer needed.

然后跳到了node_redis里边的实现方案，里边提到了util.promisify，遂抓过来研究了一下，感觉还挺有意思，总结了下分享给大家。