Logger
日志工具类
scripts
# http://localhost:3000
pnpm run dev
pnpm run build
使用
pnpm install @ezuikit/utils-logger
export interface LoggerOptions {
level?: 'INFO' | 'LOG' | 'WARN' | 'ERROR';
showTime?: boolean;
name?: string;
}
import Logger from '@ezuikit/utils-logger';
const logger = new Logger({ level: 'INFO' });
logger.info('info');
logger.log('log');
logger.warn('warn');
logger.error('error');
// 更改日志等级 WARN 只打印 warn error
logger.setOptions({ level: 'WARN' });
logger.info('setOptions info');
logger.log('setOptions log');
logger.warn('setOptions warn');
logger.error('setOptions error');
多上下文 (context)
context(key) 按 key 拿到一个互相隔离的 logger 实例，同一个 key 始终返回同一个实例，不需要自己在业务里到处传引用。
const logger = Logger({ name: 'EZUIKIT', level: 'WARN' });
const player = logger.context('player');
player.warn('ready'); // [player] [WARN] ready
// 同名复用，拿到的是同一个实例
logger.context('player') === player; // true
三条语义：
隔离 — 每个上下文有自己的配置，setOptions 只影响自己，不会影响父实例，也不会影响其他上下文。
const player = logger.context('player');
const talk = logger.context('talk');
player.setOptions({ level: 'INFO' });
player.getOptions().level; // "INFO"
logger.getOptions().level; // "WARN" 父实例不受影响
talk.getOptions().level; // "WARN" 其他上下文不受影响
继承 — 创建时继承父实例当时的配置（level、showTime 等）。之后父实例再改配置，不会追溯到已创建的上下文。
const logger = Logger({ level: 'INFO' });
const before = logger.context('before'); // 继承到 INFO
logger.setOptions({ level: 'ERROR' });
const after = logger.context('after'); // 继承到 ERROR
before.getOptions().level; // "INFO" 不被追溯修改
前缀只显示自己的 key — 不会带上父实例的 name，也不会随嵌套层级累积。
const logger = Logger({ name: 'EZUIKIT' });
logger.log('x'); // [EZUIKIT] [LOG] x
logger.context('player').log('x'); // [player] [LOG] x
logger.context('player').context('hls').log('x'); // [hls] [LOG] x
注册表管理
logger.context('player');
logger.context('talk');
logger.getContexts(); // ["player", "talk"] 已创建的 key 列表
logger.hasContext('player'); // true
logger.removeContext('talk'); // true，移除后再 context("talk") 会创建新实例
上下文实例长期持有会一直占着内存，播放器这类会反复创建销毁的场景，销毁时用 removeContext(key) 清掉即可。已经被外部持有的旧实例仍然可用，只是不再被复用。