在前端开发过程中,我们经常需要记录一些调试信息或日志,便于排查问题或分析运行状况。而 npm 包 @jsenv/logger 提供了一种简单、灵活的日志记录方式,本文就来介绍如何使用它。
安装
首先,我们需要将 @jsenv/logger 安装为项目的依赖项:
--- ------- ------------- ------
基本使用
在代码中使用 @jsenv/logger,我们首先需要导入该模块并创建一个 logger 实例。然后我们可以使用该 logger 实例的不同方法,记录不同级别的日志。如下是一个简单示例:
----- - ------------- ----------- --------- - - ------------------------ ----- ------ - -------------- ------------------- ---------------- -- ---- ------------------------ -- ------ --------------
该示例中,我们创建了一个 logger 实例,并使用该实例记录了一条 info 级别的日志。logger 的日志级别可以在创建时通过第二个参数进行设置,如若不设置,默认为 info 级别。
除 info 级别外,@jsenv/logger 还支持多个其他级别,如 debug、warn、error、fatal。使用方式类似 info,只需要将方法名改为对应级别即可。
自定义日志格式
默认情况下,@jsenv/logger 打印的日志格式是包含级别、时间、内容的字符串。不过我们可以通过提供自定义 formatter 来自定义打印格式,使日志更符合我们的需求。如下是一个示例:
----- - ------------- ---------- ---------------- - - ------------------------ ----- ------ - ----------------------------- - ----------- - -- ------------ ----- ------- -- -- ---------------- ---------- ---------- -- -------- - ------------------ --------- ------------- -- - -- ------------------ -- - ------ ---------
在该示例中,我们在创建 logger 实例时,提供了一个自定义 formatter function,它根据传入的 loggerLevel、time、message 来返回自定义的格式化字符串。同时,我们也提供了一个输出到文件的方式。
执行后,输出结果将会是:debug: This is a custom format. (2021-11-29T07:30:36.059Z)
指定日志级别
在日志量较大的情况下,如果不指定日志级别,则会输出所有级别的日志,难以快速定位问题。因此,我们可以通过在创建 logger 实例时指定日志级别,来过滤输出的日志。如下是一个示例:
----- - ------------- ---------- ------------------- - - ------------------------ ----- ------ - ---------------------------- - -------- ----------------------- -- ----------------- --------- ------------------- ---------
在该示例中,我们指定了 logger 的日志级别为 info,因此 debug 级别的日志不会被输出。执行后,输出结果将会是:[🐼] 2021-11-29T07:30:36.059Z 🤙 info message
需要注意的是,logger 的日志级别是个别返回的值。因此,可以通过修改 logger 的 level 字段来动态改变日志级别,如下所示:
------------ - ---------------
这样,当前 logger 实例的日志级别就变为了 debug。
总结
@jsenv/logger 是一款灵活、简单易用的日志库,可以帮助我们更好地记录日志。本文介绍了如何使用@jsenv/logger 和一些常规的用法,如需更多定制,也可以参考官方文档进行详尽的学习。
以上是 @jsenv/logger 的使用教程,希望能帮助到大家。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/5eedb4a9b5cbfe1ea0611322