日志库 winston 的学习笔记 - logger.info 的实现原理单步调试

按照这篇文章日志库 winston 的学习笔记 - 创建一个使用 winston 的 Node.js 应用里的代码，对下列方法进行单步调试：

因为我们调用的是 info 方法，所以生成的日志，level 为 info：

第一个参数为 message，后面的都是 meta 信息：

在 info 的实现代码里，首先判断传入 log 方法的参数个数：

如果参数个数为 0 或者 1，有专门的实现。否则，进入 self.log:

构造 info 对象：

其中 msg 变量存储的是用户调用 info 方法传入的第一个参数，meta 是传递的第二个参数。

最后调用内部的 write 方法，传入的 message，是两个参数的连接。

encoding 是 utf8

chunk：

write 里面先 read，然后再 _transform:

format 我们选择的是 json format：

json.js 负责把 info 对象序列化成 json 字符串：

结果：

addChunk：

emit：

三个 listeners：

data listener：

这里面看到了应用开发人员指定的 combined.log:

writeOrBuffer：

_write 的注释：Writes the info object to our transport instance.

好多递归操作：

准备投递到 fs stream 来写了：

文件 transport 的写入逻辑：

这是 fs 的 native 实现了：

if (process.env.NODE_ENV !== 'production') {
    logger.add(new winston.transports.Console({
      format: winston.format.combine(
        winston.format.colorize({ all: true }),
        winston.format.simple()
    )}));
}

上述代码的含义是，如果当前 Node.js 执行环境不是生产环境，则将 winston 的输出，打印到控制台上。

_stream_readable.js 抛出 data 事件：

读取事件处理函数：

console 对应的 event handler：

transformed：

console 有专门对应的 transport 实现文件，位于 console.js 内：

从 data 字符串能看出在 console 打印彩色字符串的实现方式：

并没有像我想象的那样，执行到 82 行的 console.log

console 对象的 _stdout 属性，在 internal 这个 constructor.js 里注入：

这个 writeUtf8String 函数，是原生 native API：

位于 Node.js 源代码 的 internal/stream_base_common.js 内部：

writeUtf8String

stream_base_commons.js 文件位置如下：

https://github.com/nodejs/node/tree/master/lib/internal

native 实现：

https://github.com/nodejs/node/blob/master/lib/internal/stream_base_commons.js

this[kFs].write