为何JSON.stringify的replacer函数无法识别Node.js Buffer实例？

我尝试给JSON.stringify()写一个replacer函数，用来检测值是不是Buffer，但JSON.stringify回调这个函数的时候，值已经不是Buffer类型了，这是为什么？我当然可以遍历对象把Buffer转成字符串，但为啥这个replacer函数不起作用？

代码示例 #

const anObject = {
  aBuffer: Buffer.from("This is a Buffer")
}

console.log("Serialized:", JSON.stringify(anObject, (key,value) => Buffer.isBuffer(value) ? value.toString("hex") : value));
console.log("Expected:", `{aBuffer: ${anObject.aBuffer.toString("hex")}}`)
console.log("Buffer is buffer:", Buffer.isBuffer(anObject.aBuffer)); //用instanceof Buffer结果一样

运行结果 #

Serialized: {"aBuffer":{"type":"Buffer","data":[84,104,105,115,32,105,115,32,97,32,66,117,102,102,101,114]}}
teste.js:5
Expected: {aBuffer: 54686973206973206120427566666572}
teste.js:6
Buffer is buffer: true

这是因为在调用replacer函数之前，JSON.stringify会先对值做一次默认的序列化处理。对于Buffer对象，Node.js已经内置了默认的序列化逻辑，会把它转换成{type: "Buffer", data: [...]}这样的普通对象，等replacer拿到这个值的时候，它已经不是Buffer实例了，自然检测不出来。

要解决这个问题，有两种可行方案：

方案1：给Buffer添加自定义toJSON方法 #

直接覆盖Buffer默认的序列化逻辑，让JSON.stringify处理Buffer时直接返回十六进制字符串：

Buffer.prototype.toJSON = function() {
  return this.toString('hex');
};

const anObject = {
  aBuffer: Buffer.from("This is a Buffer")
};

console.log("Serialized:", JSON.stringify(anObject));
// 输出: Serialized: {"aBuffer":"54686973206973206120427566666572"}

注意：这个方案会全局修改Buffer的toJSON方法，可能影响其他依赖默认Buffer序列化的代码。

方案2：在replacer里检测序列化后的Buffer结构 #

针对Node.js默认序列化后的Buffer结构做判断，再转回Buffer并转成字符串：

const anObject = {
  aBuffer: Buffer.from("This is a Buffer")
};

console.log("Serialized:", JSON.stringify(anObject, (key, value) => {
  if (value?.type === 'Buffer' && Array.isArray(value.data)) {
    return Buffer.from(value.data).toString('hex');
  }
  return value;
}));
// 输出: Serialized: {"aBuffer":"54686973206973206120427566666572"}

这个方案只在当前序列化逻辑中生效，不会影响全局，更稳妥。

内容的提问来源于stack exchange，提问作者felipeaf