@chubbyts/chubbyts-log-types

中文文档
3.4.1发布于 2026/11/10MITTypeScriptES Module零依赖近 30 天下载 1779

日志( logger) 类型, PSR-3 启发 .

中文使用文档
文档目录10 节
  1. 说明
  2. 所需资源
  3. 安装
  4. 使用量
  5. 类型
  6. 创建日志
  7. 无效日志
  8. 取决于类型
  9. 按级别过滤
  10. 版权

胖子-日志类型

CI Coverage Status Mutation testing badge npm-version

bugs code_smells coverage duplicated_lines_density ncloc sqale_rating alert_status reliability_rating security_rating sqale_index vulnerabilities

说明

日志( logger) 类型, 临 时 议 题 启发.

货包只装了几分几分几分 createLogger 帮助, 因此库可以依赖于日志合同 而不取决于具体的伐木执行情况.

所需资源

  • 节点:

安装

穿过 国家预防机制 作为 @ chubbyts/ chubbyts-log-类型。 。 。 .

npm i @chubbyts/chubbyts-log-types@^3.4.1

使用量

类型

import type {
  Context,
  LogFn,
  Logger,
  LogLevel,
  NamedLogFn,
} from '@chubbyts/chubbyts-log-types/log';
type LogLevel =
  | 'emergency'
  | 'alert'
  | 'critical'
  | 'error'
  | 'warning'
  | 'notice'
  | 'info'
  | 'debug';

type Context = Record<string, unknown>;

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<LogLevel, NamedLogFn> & { log: LogFn };

创建日志

createLogger 单曲 LogFn 并从中衍生出所有具体层次的方法.

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 返回一个丢弃每个消息的日志, 这是一种方便的默认或测试.

import { createLogger } from '@chubbyts/chubbyts-log-types/log';

const logger = createLogger();

logger.debug('This goes nowhere', {});

取决于类型

接受一个 Logger 而不是具体执行.

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 });
  },
});

按级别过滤

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<LogLevel> = [
  '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 共发布 24 个版本,首次发布于 2022/05/26;过去 12 个月发布了 8 个版本。

版本发布日期距今
3.4.1latest2026/11/10今天
3.4.02026/11/081 天前
3.3.12026/10/2021 天前
3.3.02026/07/283 个月前
3.2.02026/05/106 个月前
3.1.12026/04/186 个月前

关于 @chubbyts/chubbyts-log-types 的常见问题

@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 和提交记录判断。