Repolode
dahlia

dahlia/logtape

面向 JavaScript 与 TypeScript 的零依赖日志库,支持 Deno、Node.js、Bun、浏览器和边缘函数。

Star
2,016
Fork
55
未关闭 Issue
9
最近提交
3天前

这是什么?

LogTape 是一个面向 JavaScript 和 TypeScript 的日志库,设计上以库开发者为先。库可以在不做任何配置的情况下直接输出日志,应用则完全掌控日志的去向和详细程度。

日志通过层级化的分类(category)进行管理,可以按模块或分类子树单独设置日志级别。它支持结构化日志、模板字符串消息、可插拔的 sink,并内置对敏感字段或模式的脱敏功能。核心包无依赖,可运行于 Deno、Node.js、Bun、浏览器和边缘函数环境。

仓库还提供多个可选包:对接 Pino、Winston、Bunyan、log4js 的适配器,输出到 AWS CloudWatch Logs、OpenTelemetry、Sentry、syslog 和 Windows Event Log 的 sink,文件 sink,美化的文本格式化器,以及 Express、Fastify、Hono、Koa、Elysia、GraphQL Yoga、Drizzle ORM 的集成。

核心功能

  • 01核心包零依赖
  • 02层级化分类,可按层级设置日志级别
  • 03支持结构化日志和模板字符串消息
  • 04按模式或字段内置敏感数据脱敏
  • 05可运行于 Deno、Node.js、Bun、浏览器和边缘函数
  • 06提供 Pino、Winston、OpenTelemetry、Sentry 等适配器和 sink

适用场景

  • 在库中添加日志,且不强制使用者做任何配置
  • 在 Deno、Node.js 和 Bun 项目中统一应用日志
  • 将结构化日志发送到 OpenTelemetry 或 Sentry
  • 在 Express、Hono 或 Drizzle 应用中记录 HTTP 请求和数据库查询

快速上手

  1. 1

    使用 npm 安装核心包

    npm add @logtape/logtape
  2. 2

    或使用 Deno 从 JSR 安装

    deno add jsr:@logtape/logtape
  3. 3

    阅读官方手册了解用法与配置

标签

常见问题

logtape 是什么?
面向 JavaScript 与 TypeScript 的零依赖日志库,支持 Deno、Node.js、Bun、浏览器和边缘函数。 LogTape 是一个面向 JavaScript 和 TypeScript 的日志库,设计上以库开发者为先。库可以在不做任何配置的情况下直接输出日志,应用则完全掌控日志的去向和详细程度。
logtape 可以免费使用吗?用的什么许可证?
logtape 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
logtape 还在维护吗?
活跃维护中。logtape 最近一次提交是在 2026年10月19日。
logtape 适合用来做什么?
在库中添加日志,且不强制使用者做任何配置 在 Deno、Node.js 和 Bun 项目中统一应用日志 将结构化日志发送到 OpenTelemetry 或 Sentry 在 Express、Hono 或 Drizzle 应用中记录 HTTP 请求和数据库查询
logtape 怎么安装和运行?
使用 npm 安装核心包: npm add @logtape/logtape 或使用 Deno 从 JSR 安装: deno add jsr:@logtape/logtape 阅读官方手册了解用法与配置
在哪里获取 logtape?
源代码和安装说明在 GitHub 上:https://github.com/dahlia/logtape

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目