Logger 日志方法 API

本文逐项记录 @fast-china/utils 的 Logger 日志公开函数。

createLogger 日志

创建独立日志器。

签名

export function createLogger(options: LoggerOptions = {}): Logger;

示例

import { createLogger } from "@fast-china/utils";

const result = createLogger({ brand: "Admin", minimumLevel: "warn" });

输入

输入值	输入值类型	必填/默认值	输入值说明
options	LoggerOptions	否，默认 {}	级别、前缀、输出目标和 uni-app App-Plus 拆分选项。

返回

返回值	返回值类型	返回值说明
result	Logger	不会修改全局控制台或其他日志器配置的新实例。

configureLogger 日志

替换默认 的完整配置。

签名

export function configureLogger(options: LoggerOptions = {}): void;

示例

import { configureLogger } from "@fast-china/utils";

configureLogger({ brand: "Admin", minimumLevel: "warn" });

输入

输入值	输入值类型	必填/默认值	输入值说明
options	LoggerOptions	否，默认 {}	默认 Logger 使用的级别、前缀、输出目标和 uni-app App-Plus 拆分选项。

返回

返回值	返回值类型	返回值说明
result	void	没有返回值。

logger.debug / logger.log / logger.warn / logger.error 日志

按指定级别向当前 Logger Sink 输出一条带作用域的日志。四个方法具有相同输入和 void 返回契约。

签名

debug(scope: string, ...content: unknown[]): void;
log(scope: string, ...content: unknown[]): void;
warn(scope: string, ...content: unknown[]): void;
error(scope: string, ...content: unknown[]): void;

示例

import { logger } from "@fast-china/utils";

logger.debug("startup", "initializing");
logger.log("api", "request completed", { status: 200 });
logger.warn("cache", "entry expired");
logger.error("api", "request failed", new Error("network"));

输入

输入值	输入值类型	必填/默认值	输入值说明
scope	string	是	无外围空白的非空模块、组件或业务来源名称。
...content	unknown[]	否，可传多个	消息和附加值；非字符串值保持原始类型。

返回

返回值	返回值类型	返回值说明
result	void	没有返回值；低于最低日志级别时不输出。