# @chubbyts/chubbyts-log-types 中文文档 规范地址：https://npmcn.com/package/%40chubbyts/chubbyts-log-types/ 版本：3\.4\.1 npm 元数据更新时间：2026-11-09T16:48:45.303Z 中文译文更新时间：2026-11-09T19:36:40.751Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40chubbyts/chubbyts-log-types 原文对照：https://npmcn.com/package/%40chubbyts/chubbyts-log-types/?lang=original 源码仓库：https://github.com/chubbyts/chubbyts-log-types ## 关键信息（来自 npm 元数据） - 包体积（解压后）：10.1 kB，5 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22 - 运行依赖：0 个 - 首次发布：2022-05-26T10:51:06.079Z - 最新版本发布：2026-11-09T16:48:45.072Z - 近 30 天下载量：1779（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：24（近 12 个月 8 个） ## 中文简介 日志( logger) 类型, PSR-3 启发 . ## 安装 ```sh npm install @chubbyts/chubbyts-log-types ``` 也可以使用：`pnpm add @chubbyts/chubbyts-log-types`、`yarn add @chubbyts/chubbyts-log-types`、`bun add @chubbyts/chubbyts-log-types` ## README # 胖子-日志类型 [![CI](https://github.com/chubbyts/chubbyts-log-types/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/chubbyts/chubbyts-log-types/actions/workflows/ci.yml) [![Coverage Status](https://coveralls.io/repos/github/chubbyts/chubbyts-log-types/badge.svg?branch=master)](https://coveralls.io/github/chubbyts/chubbyts-log-types?branch=master) [![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fchubbyts%2Fchubbyts-log-types%2Fmaster)](https://dashboard.stryker-mutator.io/reports/github.com/chubbyts/chubbyts-log-types/master) [![npm-version](https://img.shields.io/npm/v/@chubbyts/chubbyts-log-types.svg)](https://www.npmjs.com/package/@chubbyts/chubbyts-log-types) [![bugs](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=bugs)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![code\_smells](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=code_smells)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![coverage](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=coverage)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![duplicated\_lines\_density](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![ncloc](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=ncloc)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![sqale\_rating](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![alert\_status](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=alert_status)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![reliability\_rating](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![security\_rating](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=security_rating)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![sqale\_index](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=sqale_index)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) [![vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=chubbyts_chubbyts-log-types&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=chubbyts_chubbyts-log-types) ## 说明 日志( logger) 类型, [临 时 议 题](https://www.php-fig.org/psr/PSR-3) 启发. 货包只装了几分几分几分 `createLogger` 帮助, 因此库可以依赖于日志合同 而不取决于具体的伐木执行情况. ## 所需资源 - 节点: ## 安装 穿过 [国家预防机制](https://www.npmjs.com/) 作为 [@ chubbyts/ chubbyts-log-类型](https://www.npmjs.com/package/@chubbyts/chubbyts-log-types)。 。 。 . ```sh npm i @chubbyts/chubbyts-log-types@^3.4.1 ``` ## 使用量 ### 类型 ```ts import type { Context, LogFn, Logger, LogLevel, NamedLogFn, } from '@chubbyts/chubbyts-log-types/log'; ``` ```ts type LogLevel = | 'emergency' | 'alert' | 'critical' | 'error' | 'warning' | 'notice' | 'info' | 'debug'; type Context = Record; type LogFn = (level: LogLevel, message: string, context: Context) => void; type NamedLogFn = (message: string, context: Context) => void; // one NamedLogFn per LogLevel, plus the generic log function type Logger = Record & { log: LogFn }; ``` ### 创建日志 `createLogger` 单曲 `LogFn` 并从中衍生出所有具体层次的方法. ```ts import { createLogger } from '@chubbyts/chubbyts-log-types/log'; const logger = createLogger((level, message, context) => { const datetime = new Date().toISOString(); console.log(JSON.stringify({ datetime, level, message, context })); }); logger.info('User logged in', { userId: 'a1b2c3' }); logger.error('Payment failed', { orderId: 42, reason: 'card declined' }); logger.log('warning', 'Disk space low', { freeBytes: 1_024 }); ``` ### 无效日志 没有争论 `createLogger` 返回一个丢弃每个消息的日志, 这是一种方便的默认或测试. ```ts import { createLogger } from '@chubbyts/chubbyts-log-types/log'; const logger = createLogger(); logger.debug('This goes nowhere', {}); ``` ### 取决于类型 接受一个 `Logger` 而不是具体执行. ```ts import type { Logger } from '@chubbyts/chubbyts-log-types/log'; import { createLogger } from '@chubbyts/chubbyts-log-types/log'; export const createUserService = (logger: Logger = createLogger()) => ({ delete: (id: string) => { logger.notice('User deleted', { id }); }, }); ``` ### 按级别过滤 ```ts import type { LogFn, LogLevel } from '@chubbyts/chubbyts-log-types/log'; import { createLogger } from '@chubbyts/chubbyts-log-types/log'; // ordered from most to least severe const levels: Array = [ 'emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug', ]; const createMinLevelLogFn = (minLevel: LogLevel, log: LogFn): LogFn => (level, message, context) => { if (levels.indexOf(level) <= levels.indexOf(minLevel)) { log(level, message, context); } }; const logger = createLogger( createMinLevelLogFn('warning', (level, message, context) => { console.log(level, message, context); }), ); logger.error('Shown', {}); logger.info('Suppressed', {}); ``` ## 版权 2026 道米尼克·佐格(英语: ## 常见问题 ### @chubbyts/chubbyts-log-types 是什么？ 日志\( logger\) 类型, PSR-3 启发 \. ### 如何安装 @chubbyts/chubbyts-log-types？ 在项目目录运行 npm install @chubbyts/chubbyts-log-types，或使用 pnpm add / yarn add / bun add。 ### @chubbyts/chubbyts-log-types 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @chubbyts/chubbyts-log-types 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @chubbyts/chubbyts-log-types 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @chubbyts/chubbyts-log-types 可以商用吗？ @chubbyts/chubbyts-log-types 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @chubbyts/chubbyts-log-types 的下载量有多少？ 根据 npm 官方下载统计，@chubbyts/chubbyts-log-types 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,779 次，日均约 59 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @chubbyts/chubbyts-log-types 还在维护吗？ 最新版本 3\.4\.1 发布于 2026/11/10（今天）；至今共发布 24 个版本，其中过去 12 个月发布了 8 个；首次发布于 2022/05/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。