Skip to content

LoggerJS更快、更强的同构日志库

采集、处理、投递。一条高速管线。

LoggerJS logo

NOTE

各指南均为完整中文版。自动生成的参考页中,包名、导出子路径、TypeScript 声明和源码链接保留英文原文,方便与发布产物对照。

LoggerJS 管线 ​

采集手动记录的日志,以及浏览器和 Node 的 integration。整理middleware 直接处理原始 record,成本低且可组合。处理需要更丰富的行为时,才把 record 投影为 event 交给 processor。投递transport 决定 codec、批量、重试和目的地。
ts
import { createLogger, stdoutTransport } from "@loggerjs/node";
import { redactProcessor } from "@loggerjs/processors";

const logger = createLogger({
  category: ["api"],
  level: "info",
  processors: [redactProcessor({ keys: ["password", /token/i] })],
  transports: [stdoutTransport()],
});

logger.info("order created", { orderId: "ord_123" });
await logger.flush();

从哪里开始 ​

新项目

从 Node 或浏览器的快速开始入手,再按运行时添加 processor 和 transport。

生产上线

生产配方和运维指南介绍隐私、离线队列、崩溃路径和厂商投递。

API 查询

通过自动生成的包和 API 页面查询导出、子路径和公开声明。

文档地图 ​

基于 MIT License 发布。