npm 包 just-task-logger 使用教程

阅读时长 7 分钟读完

什么是 just-task-logger

just-task-logger 是一款基于 just-task 的插件,用于在终端输出美观的任务日志。

安装 just-task 和 just-task-logger

使用 just-task-logger 之前,需要先安装 just-task 和 just-task-logger。

如何使用 just-task-logger

使用 just-task-logger,需要先在 just-task 的任务配置中进行注册。

举个例子,下面是一个简单的任务配置:

-- -------------------- ---- -------
----- - ----- ------ - - ---------------------

------------- -- -- -
  ------------------ ---------
---

----------- -- -- -
  -------------------- ---------
---

--------------- --------------- --------

下面演示如何通过 just-task-logger 来美化输出效果。

-- -------------------- ---- -------
----- - ----- ------ - - ---------------------
----- ------ - ----------------------------

------------- -- -- -
  ----------------- ---------
---

----------- -- -- -
  ------------------- ---------
---

--------------- --------------- --------

-- ------
-------------------
  ------- -----
  -------- -----
  --------- --------
---

上述示例代码中,我们通过导入 just-task-logger,使用 logger.log() 方法输出了任务日志,并根据需要使用 logger.setOptions() 方法来添加日志样式。

通过 just-task-logger,我们可以很方便地输出各种不同级别的日志信息,如下所示:

just-task-logger 还支持批量添加任务的日志描述,如下所示:

-- -------------------- ---- -------
----- - ----- ------ - - ---------------------
----- ------ - ----------------------------

------------- -- -- -
  ----------------- ---------
---

----------- -- -- -
  ------------------- ---------
---

--------------- --------------- --------

-- ------
---------------------------
  ------ --- ----- --------
  ---- --- ------- --------
---

通过以上操作,我们已经成功地使用 just-task-logger 来美化任务日志输出。

just-task-logger 的高级用法

除了常规的日志输出和样式设置,just-task-logger 还提供了一些高级的用法。

1. 加载外部日志配置

在有些情况下,我们需要将任务的日志配置保存在外部文件中,并在运行任务时加载相关配置。

-- -------------------- ---- -------
----- - ----- ------ - - ---------------------
----- ------ - ----------------------------
----- -- - --------------

----- ------ - ---------------------------------------------

--------------------------

------------- -- -- -
  ----------------- ---------
---

----------- -- -- -
  ------------------- ---------
---

--------------- --------------- --------

上述示例代码中,我们使用 logger.loadConfig() 方法来加载外部日志配置,并将 config.json 文件中的内容作为配置参数传递进去。

config.json 文件内容如下:

-- -------------------- ---- -------
-
  --------- -----
  ---------- -----
  ----------- --------
  --------------- -
    -------- --- ----- --------
    ------ --- ------- -------
  -
-

2. 日志样式自定义

在我们的项目中,可能需要对任务日志的样式进行一些自定义,例如修改颜色、添加图标等。

-- -------------------- ---- -------
----- - ----- ------ - - ---------------------
----- ------ - ----------------------------

------------------
  ------ -------------
---

------------- -- -- -
  ----------------- -------- - ------ ------- ---
---

----------- -- -- -
  ------------------- ---------
---

--------------- --------------- --------

上述示例代码中,我们使用 logger.addStyles() 方法来自定义样式,然后在输出任务日志时,传递相应的样式参数即可。

3. 添加日志记录器

在我们的项目中,可能需要将任务日志输出到文件或其他地方,这时候就可以通过添加日志记录器的方式实现。

-- -------------------- ---- -------
----- - ----- ------ - - ---------------------
----- ------ - ----------------------------
----- -- - --------------

----- ------ - -------------------------------------

----- --------- - --------- ------ -- -
  ------------------------------------ ------ ---------------------- ---------------
--

---------------------
  ----- ----------
---

------------- -- -- -
  ----------------- -------- - --------- ------ ---
---

----------- -- -- -
  ------------------- -------- - --------- ------ ---
---

--------------- --------------- --------

上述示例代码中,我们首先创建了一个写入流 stream,并定义了一个名为 logToFile 的记录器函数。然后,通过 logger.addRecorders() 方法将记录器函数注册到 just-task-logger 中。最后,在输出任务日志时,传递相应的记录器参数即可。

总结

通过本篇文章的学习,我们已经了解了 just-task-logger 的安装和基本用法,以及高级用法。在实际项目开发中,将 just-task-logger 应用到任务日志输出中,可以极大地提高开发效率和项目可维护性,推荐大家尝试使用。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5f0427fe403f2923b035be60

纠错
反馈