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

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

快速开始

查看包

API 参考

浏览器和服务端

同一 logger 模型运行在浏览器、Node.js、workers 和 edge runtimes。

自动采集

按需捕获 console、错误、网络失败、路由、process 事件、HTTP framework、队列和数据库边界。

可靠投递

transport 拥有 codec，并可组合 batching、retry、backoff、offline replay、crash-path flush 和 beacon delivery。

组合式处理

middleware 和 processor 在投递前完成 enrich、redact、sample、dedupe、fingerprint、route 和 buffer。

可度量热路径

benchmark 和 CI gate 覆盖 disabled levels、lean NDJSON、prepared encoders、batching、browser delivery 和 size budgets。

对库友好的默认值

library logger 在宿主应用配置前保持静默，依赖可以记录日志但不强制输出。

NOTE

中文站包含主要指南的完整中文译文；生成参考页中的包名、export subpaths、TypeScript 声明和源码链接保留原文，便于与发布产物逐项核对。

LoggerJS 管线

采集手写日志，加上浏览器和 Node integration。塑形middleware 保持 raw record 低成本且可组合。处理需要更丰富行为时，processor 再投影 event。投递transport 选择 codec、batching、retry 和目的地。

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 或浏览器 quick start，再按运行时补 processor 和 transport。

生产上线

生产配方和运维指南覆盖隐私、离线队列、崩溃路径和 vendor 投递。

API 查询

生成的包和 API 页面用于确认 exports、subpaths 和公共声明。

文档地图

快速开始覆盖安装、第一个 logger、级别、lazy message、context 和 typed events。
核心概念解释 records、events、middleware、processors、transports、codecs、integrations 和 routing。
传输、集成、处理器和编解码是主要实现参考。
生产配方、运维和性能帮助做上线选择。
基准、基准矩阵和对比把性能与定位绑定到仓库证据。
包、API 报告和示例由当前仓库生成。
AI Skill、llms.txt 和 llms-full.txt 帮助 coding agent 直接使用 LoggerJS。