app-lib-log v0.0.54

一、背景介绍

• nodejs 与 js 统一日志打印风格
• 便捷线上与开发的灵活调整
• 彩色高亮打印

二、功能描述

1. 支持浏览器与 nodejs
2. 支持彩色输出日志
3. 支持日志级别设置
4. 支持日志收集扩展

三、注意事项

1. 类的方法输出 在 md 中不能呈现 在 doc/html 文档中可以

四、使用案列

五、todo 列表

1. brower 端支持不打野堆栈的情况输出
2. brower 端支持文本转换输出

六、API

Classes

Constants

Functions

ALL_FUNCTIONS

• 日志级别相关方法

• 彩色转换与其他方法

  参考详细文档

Kind: global constant

TYPE

日志类型

Kind: global constant

LEVEL

日志级别

• 通过 setOption({level:number}) 进行打印高于该值 (number) 的日志
• 调整该顺序值进行灵活打印
• 或者只打印某几项日志

Kind: global constant

option

默认配置

• setOption - 进行设置
• getOption - 获取当前的配置

Kind: global constant

log

• 默认会挂载全局 直接通过 log 来使用

Kind: global constant

setOption(option) ⇒ objcet

设置配置

• 设置后即刻生效
• 后续日志打印按照该设置进行

Kind: global function
Returns: objcet - 新的参数配置 option

getOption() ⇒ object

获取配置

Kind: global function
Returns: object - 参考默认 option

auotLevel/auotLogLevel() ⇒ object

根据命令行终端参数动态设置日志级别

• --debug
• process.env.DEBUG 仅在 nodejs 中生效 debug 模式 默认级别为 0 否则为 21

Kind: global function
Returns: object - log 日志实例

tb/transTextColorBlock(text, opitons) ⇒ string

输出执行缩进 显示块长度 文件颜色 和背景色的 文本 1. option 参数

• indent 缩进
• width 块的长度
• algin 对齐
• color 颜色
• background 背景颜色

Kind: global function
Returns: string - 彩色文案

tx/transTextColor(text, color, background) ⇒ string

转换文本颜色

Kind: global function
Returns: string - 彩色文案

txl/transTextColorAndLog(text, color, background) ⇒ string

转换文本颜色并且打印

• 不受级别控制

Kind: global function
Returns: string - 彩色文本内容

tl/transLevelTextColor(level, text, isBackground) ⇒ string

转换指定级别文本颜色

• 不受级别控制

Kind: global function
Returns: string - 彩色文本内容

tll/transLevelTextColorAndLog(level, text, isBackground) ⇒ string

转换指定级别文本颜色

• 不受级别控制

Kind: global function
Returns: string - 彩色文本内容

tlh/transLevelHeaderAndLog(level, text, chalkOption) ⇒ string

打印指定的脚本

• 带级别字段和内容

Kind: global function
Returns: string - 转换后的字符内容

t/trace(args) ⇒ null

trace 调试打印

Kind: global function

d/debug(args) ⇒ null

debug 调试打印

Kind: global function

i/info(args) ⇒ null

info 信息打印

Kind: global function

l/log(args) ⇒ null

log 日志打印

Kind: global function

s/success(args) ⇒ null

success 成功打印

Kind: global function

tt/time(args) ⇒ null

time 时间打印

Kind: global function

T/table(args) ⇒ null

table 表格打印

Kind: global function

w/warn(args) ⇒ null

warn 警告打印

Kind: global function

wn/warnNoTrace(args) ⇒ null

debug 调试打印

• 不带堆栈

Kind: global function

e/error(args) ⇒ null

error 错误打印

Kind: global function

en/errorNoTrace(args) ⇒ null

error 调试打印

• 不带堆栈

Kind: global function

mt/mTrace(args) ⇒ null

mTrace 堆栈打印 (模块化)

Kind: global function

md/mDebug(args) ⇒ null

mDebug 调试打印 (模块化)

Kind: global function

mi/mInfo(args) ⇒ null

mInfo 信息打印 (模块化)

Kind: global function

ml/mLog(args) ⇒ null

mLog 日志打印 (模块化)

• 原生的控制台打印

Kind: global function

ms/mSuccess(args) ⇒ null

mSuccess 成功打印 (模块化)

Kind: global function

mtt/mTime(args) ⇒ null

mTime 调试打印 (模块化)

Kind: global function

mT/mTable(args) ⇒ null

mTable 表格打印 (模块化)

Kind: global function

mw/mWarn(args) ⇒ null

mWarn 告警打印 (模块化)

Kind: global function

mwn/mWarnNoTrace(args) ⇒ null

mWarnNoTrace 调试打印 (模块化)

• 不带堆栈

Kind: global function

me/mError(args) ⇒ null

mError 调试打印 (模块化)

Kind: global function

men/mErrorNoTrace(args) ⇒ null

mErrorNoTrace 调试打印 (模块化)

• 不带堆栈

Kind: global function

autoFillText(text, length, aligin) ⇒

autoFillText 动态补全文本

• 常用于打印类似各种级别的日志 配置配合 tl 使用

Kind: global function
Returns: 整合的字段

fill(length, content) ⇒

• 填充文本 (一般是空白)

Kind: global function
Returns: string 填充后的内容

create(option) ⇒ object

1. 第一次引入 默认创建实例
2. 后续导入 直接返回第一次创建的实例

Kind: global function
Returns: object - logInstance 日志实例

七、发布日志

• 2024-12-11 12-00-38-去掉debugger

• 2023-12-28 11-44-16-aaa