用途:@workleap/logging 是面向 Workleap 前端 TypeScript 应用的结构化、可组合日志库,用于在浏览器控制台输出带样式与作用域的日志,并可转发到遥测工具。
主要能力:提供 BrowserConsoleLogger(带样式输出到浏览器控制台)与 CompositeLogger(把日志转发给多个底层 logger);日志级别从低到高为 debug、information、warning、error、critical;通过作用域(scope)把相关日志归组到同一标签,便于追踪操作。
安装:pnpm add @workleap/logging
基本用法:new BrowserConsoleLogger() 直接使用,或传入 { logLevel: LogLevel.information } 限定最低级别。链式写法需以 log 方法收尾,例如 withText、withObject、withError 后调用 .error();支持 withText 样式与 withLineChange 换行。作用域用 startScope("标签") 开启,调用 scope.end() 输出全部记录,或 end({ dismiss: true }) 丢弃;标签可在创建或结束时设置样式。createCompositeLogger(verbose, [loggers]) 为工厂函数,verbose 控制是否记录 debug,不传 loggers 时默认使用 BrowserConsoleLogger。
LogRocket 集成:LogRocket 会话回放默认不含 console 输出,可用 @workleap/telemetry 或 @workleap/logrocket 的 LogRocketLogger 发送日志,常与 CompositeLogger 组合同时输出到控制台与 LogRocket。级别建议:开发期用 debug,生产用 information。
限制与注意:只有 RootLogger 实例可以 startScope;若 logger 被声明为 Logger(如 Squide 的 useLogger()),需先转为 RootLogger 再调用。链式片段必须调用具体 log 方法才会输出;作用域必须 end() 才会输出;错误日志应带上 withObject 上下文与 withError 堆栈;不得记录密码、令牌或个人信息;按环境设置 CompositeLogger 的过滤级别。官方文档中未提供的内容暂未提供。