loglevel 技术文档

loglevel 技术文档

【免费下载链接】loglevel :ledger: Minimal lightweight logging for JavaScript, adding reliable log level methods to wrap any available console.log methods 项目地址: https://gitcode.com/gh_mirrors/lo/loglevel

安装指南

loglevel 是一个轻量级的日志库，适用于JavaScript环境，包括浏览器、Node.js等。以下是几种常用的安装方法：

使用NPM（推荐）

在命令行中输入以下命令来安装loglevel到您的项目中：

npm install loglevel

使用Bower

如果你的项目使用Bower进行前端资源管理，可以通过执行：

bower install loglevel

直接下载

您也可以直接从GitHub下载最新的生产版本或开发版本，或者通过CDN链接引用：

最小化生产版：

<script src="https://unpkg.com/loglevel/dist/loglevel.min.js"></script>

引入作为ES6模块

对于支持ES6模块的环境，可以这样导入loglevel：

import log from 'loglevel';

或在某些工具中可能需要：

import * as log from 'loglevel';

项目的使用说明

基础日志记录

一旦安装完成，您可以立即开始使用它。以下是基本的使用示例：

在Node.js中：

const log = require('loglevel');
log.warn("这是一个警告信息");

在浏览器环境中，通过<script>标签引入后可以直接使用：

<script src="path/to/loglevel.min.js"></script>
<script>
log.info("这是一条信息消息");
</script>

设置日志级别

默认情况下，日志级别设置为warn，以避免页面上充斥太多信息。你可以通过调用setLevel来改变这一点，比如开启所有级别的日志记录：

log.setLevel("trace");
log.debug("现在可以看到这条调试信息了");

项目API使用文档

日志方法

• log.trace(msg)
• log.debug(msg)
• log.info(msg)
• log.warn(msg)
• log.error(msg)

还有 log.log(msg)，它是 log.debug(msg) 的同义词。

这些方法会根据当前环境的控制台能力来决定其行为，确保在所有环境下都有回退机制，即使没有精确的方法（例如在旧版浏览器），也会尝试使用更通用的console方法。

设置日志级别

使用 log.setLevel(level, [persist]) 来控制日志输出级别：

log.setLevel("info"); // 只有info及以上级别会被打印

其中，level 可以是字符串（如 'debug', 'warn'）或对应的内部级别标识符，且可选参数 persist 控制是否将此设置存储于本地存储。

项目特性概览

• 轻量级：1.4KB的压缩体积。
• 兼容性：良好地处理无console对象的老式浏览器。
• 灵活性：直接使用或与模块加载器一起工作。
• 持久化：日志级别设置可选地保存在本地存储中。
• 简易性：简洁的API设计，易于理解和使用。

loglevel的设计旨在提供核心日志功能，而不过度复杂。通过遵循上述指南，您可以高效地集成并利用这个库进行日常的开发、测试和调试任务。

【免费下载链接】loglevel :ledger: Minimal lightweight logging for JavaScript, adding reliable log level methods to wrap any available console.log methods 项目地址: https://gitcode.com/gh_mirrors/lo/loglevel