介绍
Bunyan-Error-Serializer 是一个 Node.js 日志记录框架 Bunyan 的插件，用于对错误对象进行序列化和格式化，以便更容易地对错误信息进行管理和分析。这个包可以将一个 Error 对象转换成一个具有一个或多个属性的对象，包括错误消息、堆栈跟踪信息，以及自定义字段等。
安装
在终端中执行以下命令即可安装：
npm install bunyan-error-serializer
使用方法
在代码中使用 bunyan-error-serializer 非常简单，只需要引入该包，并将其作为 Bunyan 的一个 Child Logger 即可。
-- -------------------- ---- -------
----- ------ - ------------------
----- --------------------- - -----------------------------------
----- ------ - ---------------------
----- ------------
-------- -
-
------ -------
------- -------------- -- ---------
--
-
------ --------
----- -------------------------- -- ----------
-
--
------------ -
---- ---------------------
-
---
------------------- ----------
---------------- ------------ --------- ---- ----------在上面的例子中，我们首先引入两个包：bunyan 和 bunyan-error-serializer。然后使用 bunyan.createLogger() 方法创建 Logger 对象。我们通过配置 streams 和 serializers 选项，设置它将日志输出到控制台和文件，并使用 bunyanErrorSerializer 序列化器来处理 Error 对象。
在这里，我们已将 bunyanErrorSerializer 绑定到 err 字段，这意味着当我们在 log 函数中写 err 属性时，Bunyan 序列化器会对它进行序列化处理并将其完整的消息、跟踪、栈等输出到日志中。
深度解析
Bunyan-Error-Serializer 是如何将一个 Error 对象序列化为一个 JSON 对象的呢？现在，我们来一步一步分析它的实现。
-- -------------------- ---- -------
-------- -------------------------- -
-- ------- --- --- --------- -
------ - ---- --- --
-
-- ----- -- ------ --- --- --------- -
------ ----
-
--- --- - ---
------------------------------------------------ ----- -
-------- - ---------
-- -----
--------- - ----------
----------- - ------------
------ ----
-该方法接收一个 Error 对象作为参数，然后根据 Error 实例的类型进行处理：
- 如果类型为字符串，则将其作为一般的消息记录；
- 如果是 null 或者不是一个对象，则返回原始值；
- 否则，对象将被展开，并自动包含错误消息、堆栈跟踪信息。
最后，返回该对象。
如果你不满足这样的序列化器，并希望定制自己的错误序列化方法，则可以通过参数自定义。
-- -------------------- ---- -------
-------- ------------------- -
----- -
-------- ------ ----- ----
- - ----
----- ---------- - -
-------- ------ ----- ----
--
-- ------------ -
----------------- - ---------------------------
-
------ -----------
-然后，我们将其传递给 Bunyan 的 logger 对象，就可以达到想要的记录方式了。
总结
Bunyan-Error-Serializer 是一个优秀的 Node.js 错误序列化器，它可以很好地帮助我们记录和追踪错误信息，并帮助我们及时对其进行处理。在使用该包时，需要注意引入和配置的方式，并会对其进行基本的了解，这样可以更好的掌握该包的使用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066c8eccdc64669dde568e