前言
在现代化开发中，使用 log 工具进行日志输出是不可缺少的一环。nightingale-console 是一个 Node.js 日志输出包，它可以帮助我们快速、简单地进行日志输出。本文将详细介绍 nightingale-console 包的使用方法。
简介
Nightingale 是一个经典的 JavaScript 日志库，支持作为 Node.js 模块或在浏览器中使用。nightingale-console 则是基于 Nightingale 的日志输出包，通过它可以快速将日志输出到控制台中。
安装：
$ npm install nightingale-console --save
安装完成后，在 JS 中引入即可使用：
const { ConsoleHandler } = require('nightingale-console');使用
输出日志
输出日志非常简单，只需要创建一个 ConsoleHandler 对象，并使用 log() 函数输出：
const { ConsoleHandler } = require('nightingale-console');
const consoleHandler = new ConsoleHandler();
consoleHandler.log('Hello, world!');此时控制台将会输出：
Hello, world!
日志等级控制
我们可以通过设置日志等级来控制日志的输出情况，这样可以更好地进行调试和 log 的管理。nightingale-console 支持 5 个等级：
- debug
- info
- notice
- warning
- error
我们可以通过指定等级的方式输出不同等级的日志：
-- -------------------- ---- ------- ----- - --------------- ------ - - ------------------------------- ----- -------------- - --- ---------------------------- -------------------------- -- -- ----- ----------- ---------------------------- -- - ------- ----------- --------------------------- -- - ------ ----------- ------------------------- -- -- ---- ----------- -------------------------- -- - ----- -----------
控制台会输出：
This is an error message! This is a warning message! This is a notice message! This is an info message!
在这里，我们通过指定日志等级为 INFO ，只有等级大于等于 INFO 的日志才会被输出。也就是说，反复调用 Handler 的日志输出函数是非常浪费性能的。
除了通过指定日志等级的方式控制，也可以通过环境变量的方式来控制。例如，我们可以通过以下方式输出 WARNING 级别的日志：
LOG_LEVEL=warning node app.js
也可以通过设置全局的 LOG_LEVEL 来使所有的日志输出按照指定的等级进行过滤：
const { configure } = require('nightingale');
configure({
handlers: [new ConsoleHandler()],
level: LEVELS.WARNING,
});这里，我们将全局的日志等级设置为 WARNING，然后通过创建一个 ConsoleHandler 来输出日志。
自定义日志格式
nightingale-console 默认采用 '[{level}] {key}: {message}' 的格式输出日志，但它也支持自定义日志格式。
-- -------------------- ---- -------
----- - -------------- - - -------------------------------
----- -------------- - --- -------------------- -
-------------- -
------ -- -------------------- ----------------- -------------- -------------------
--
---
------------------------ -- - ------- ---- ------ ----------这里，我们通过在 ConsoleHandler 的构造函数的第二个参数中传递一个新的 format 函数，覆盖默认的格式，并输出自定义的日志格式。
自定义日志输出方式
nightingale-console 默认输出到控制台，但它也支持自定义输出方式，例如文件、数据库等。
-- -------------------- ---- -------
----- - ------- - - -----------------------
----- - --------------- ------ - - -------------------------------
----- ----------- ------- ------- -
-------------------- -
-------------------- ---------
----------- - ---------------
-
-- -------
------------- -
----- - --------- ------ ---- ------- - - -------
------------------------------ -------- ------ ---------------
-
-
----- ----------- - --- -------------
------- --------------------------------- - ------ --- ---
---
----- -------------- - --- -----------------------------
--------------
---------------------------
---------------------------
------------ -- -- ----- -----------这里，我们定义了一个 FileHandler 类，继承于 Nightingale 库中的 Handler。然后我们可以在自定义输出函数 write() 中实现自己的日志输出操作。
最后，我们将 ConsoleHandler 的最低日志等级设置为 NOTICE，并将自定义的文件输出 Handler 作为 ConsoleHandler 的 Handler。这样，对于等级大于等于 NOTICE 的日志，就会同时输出到控制台和文件中。
结语
本文详细介绍了 nightingale-console 包的使用方法，包括如何输出日志、日志等级控制、自定义日志格式以及自定义日志输出方式。希望本文能对大家进行指导并提供参考价值。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/69367