miniprogram-logger-plus
目录
介绍
无论是在开发调试阶段或者线上运行阶段，日志是帮助我们发现问题以及排查修复问题的一个好的工具。依托于微信小程序的高度封装，打印日志变得十分简单。比如使用 console 就可以在控制台打印日志，除此之外，微信小程序提供了一款十分实用的 实时日志 ，它的一个优点是：日志汇聚并实时上报到小程序后台，可直接在小程序后台查看日志，无需人工提交日志。
miniprogram-logger-plus 默认集成了上面 console 和 实时日志，开发者在使用时，可以 零配置 使用。
安装
按照通用的方式使用 npm 下载安装到你的项目下即可，无需全局安装。
安装命令：
npm i miniprogram-logger-plus使用
使用前可以阅读微信小程序对于 npm 包的使用方式（ npm 支持），当然你也可以按照笔者的说明进行使用。
构建 npm
普通的 npm 包在小程序中需要先进行 构建 npm 后才能使用。具体操作为在安装完成后，点击 小程序开发工具 菜单栏的 工具 - 构建 npm。
点击后，显示以下界面，表示构建成功。
可进入 miniprogram_npm 目录进行进一步检查，出现图示红框项目，表示构建成功。
入门
一个非常简单的使用方式如下：
// 引入
const { Logger } = require('miniprogram-logger-plus')
// 实例化
const logger = new Logger()
// 打印日志
logger.debug('我是打印的日志内容')配置
你可以 零配置 直接实例化使用，同时，为了支持更多使用场景，插件支持以下配置项。配置项在实例化阶段引入，即
// 实例化时引入配置项
const logger = new Logger(options)目前支持以下配置项：
| 属性 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| level | string | 否 | 'ALL' | 日志等级，支持：'ALL', 'DEBUG', 'INFO', 'WARN', 'ERROR', 'NONE' |
| console | boolean | 否 | true | 是否开启 console 日志 |
| realtimeLog | boolean | 否 | true | 是否开启实时日志（realtimeLog） |
示例
下面展示一个使用示例：
// 实例化时引入配置项
const logger = new Logger({
level: 'WARN', // 日志等级为 'WARN'
realtimeLog: false, // 关闭实时日志
})
logger.debug('打印 DEBUG 日志') // 当前日志等级（'WARN'）下将不会打印该日志
logger.warn('打印 WARN 日志')进阶
一般情况下，大部分开发者用不到本节列举的功能，为了少数场景下的使用便利，提供以下功能。
Logger API
属性：
| 属性 | 类型 | 说明 |
|---|---|---|
| level | string | 日志等级，可查看说修改日志等级 |
使用示例：
logger.level // 'WARN'
logger.level = 'INFO' // 将日志等级变更为 'INFO'方法：
add(options: object)
添加一个 日志输出源 ，见 日志输出源
remove(name: string)
移除一个日志输出源
enable(name: string)
启用一个日志输出源
disable(name: string)
禁用一个日志输出源
日志输出源
插件内置了 2 款日志输出源：console 和 realtimeLog，你除了可以禁用默认的日志输出源外，还可以自定义日志输出源，然后使用 add 方法添加该日志输出源，下面介绍一个示例：
const options = {
/** 自定义的日志输出源名称，不要和现有的重复即可 */
name: 'customLog',
/** 日志等级，仅等于或高于该等级的日志会被传输到当前日志输出源中 */
level: 'INFO',
/** 日志前缀，将会被按序替换为对应内容 */
prefix: ['now', 'duration', 'level'],
/** 适配器，最终将调用该适配器方法打印日志，这里以 console 为例 */
adapter: {
debug: console.log,
info: console.info,
warn: console.warn,
error: console.error,
},
// 实际上，以上内容可以缩写为 `adapter: console,`
}
// 使用 add 方法挂载到日志上
logger.add(options)
// 临时禁用该日志输出源
logger.disable('customLog')
// 再次启用
logger.enable('customLog')
// 永久移除
logger.remove('customLog')当你自定义日志输出源的时候，可以参考以上示例进行创建。
作者
我是 inlym ，欢迎访问我的主页。
如果你有任何问题或者建议，欢迎联系我，以下是我的联系方式：
- 邮箱：inlym@qq.com
- 主页：www.inlym.com
参与
非常欢迎你能够参与这个项目的开发和维护。
你可以通过以下几种方式参与到项目中：
- 提建议和需求。对于几句话就能说清楚的建议和需求，你可以直接 提一个 New Issue 。
- Fork 项目，修改代码，然后提交 Pull requests 。（提交前请检查务必通过 ESLint 检查）
许可证
本插件使用 MIT 许可证。