开发工具CLI【免费下载链接】consola Elegant Console Logger for Node.js and Browser项目地址https://gitcode.com/gh_mirrors/co/consola点击查看免费下载consola 是一款面向 Node.js 与浏览器环境的优雅控制台日志库其 CHANGELOG.md 完整记录了从 0.1.0 到 3.4.2 的全部演进轨迹。本文以该变更记录为骨架逐版本解读 3.x 时代的 TypeScript 重写、子路径导出、交互式 prompt、box 与 tree 工具函数等关键能力并结合仓库源码src、test、examples给出可验证的实现细节帮助你理解每个版本背后的设计决策、破坏性变更与踩坑修复从而在项目中安全升级、合理选用 API。一、版本脉络总览从 0.1.0 到 3.4.2根据 CHANGELOG.mdconsola 的演进可划分为三个时代版本区间定位关键里程碑v0.1.0 ~ v1.x奠基期2018 年首个版本、fancy reporter 重写、icon/additional 字段、wrapConsole/wrapStdv2.0.0 ~ v2.15.x成熟期2018~2021 年spam 防刷、mockTypes、pause/resume、formatOptions、别名机制v3.0.0 ~ v3.4.2现代化重写2023 年至今TypeScript 重写、子路径导出、交互式 prompt、box/tree/color 工具集当前仓库 package.json 中版本号为3.4.2与 CHANGELOG 顶部最新条目一致。整个演进的核心脉络是从控制台包装器逐步走向带交互提示、可插拔 reporter、可轻量裁剪的通用日志与 CLI 工具集。二、v3.0.0TypeScript 重写与两大破坏性变更v3.0.0 是 consola 历史上最重大的转折点CHANGELOG 明确标注了两项 Breaking Changes2.1 ⚠️ 用 TypeScript 重写整个项目此前 consola 以 JavaScript 实现v3.0.0 起全部代码迁移到 TypeScript对应提交4479d2f。从源码结构可以印证当前 src 目录下所有实现consola.ts、constants.ts、types.ts、prompt.ts 等均为.ts文件且配套提供了 basic.d.ts、browser.d.ts、core.d.ts、utils.d.ts 等顶层类型声明文件同时开启严格类型检查Strict typechecks。伴随重写还有一系列内部重构日志级别与类型收敛到常量模块⚠️ 将LogLevels、LogTypes移至 src/constants.ts并合并LogTypeLiteral与logtype为统一的LogType类型移除json与winston两个 reporter为瘦身砍掉内置的 JSON 与 winston 输出JSON 输出改为通过自定义 reporter 实现参见 examples/json.ts所有选项收敛到consola.options不再在多处重复保存配置Move all options to consola.options without duplicationspam 防刷逻辑收敛进_lastLog对象见 src/consola.ts 的_lastLog字段移除全局async选项、移除globalThis缓存并统一global改为globalThis。2.2 新增能力prompt、fail、trace 与 createConsolav3.0.0 一口气引入了多个对使用者影响深远的 APIconsola.prompt交互式提示PR #170支持text、confirm、select、multiselect四种类型底层交互体验由clack提供完整用法见 examples/prompt.tsconsola.fail日志级别PR #153与success相对表示操作失败级别同为 3见 src/constants.tsconsola.trace输出堆栈PR #151type 为trace时fancy reporter 会构造 Error 并渲染堆栈见 src/reporters/fancy.ts暴露createConsola与命名导出ef6e5e5从此import { consola, createConsola } from consola成为标准用法src/index.ts、src/core.ts 均从./shared重新导出Consola、LogLevels、LogTypes及各类类型支持字面量形式的 logLevelPR #133level既可传数字也可传日志类型名src/consola.ts 的_normalizeLogLevel负责解析测试环境下默认 logLevel 为 1PR #134src/index.ts 中_getDefaultLogLevel在isTest时返回LogLevels.warn即 1。test/consola.test.ts 直接断言createConsola().level为 1可验证该行为。2.3 性能优化chalk → colorette移除 dayjsv3.0.0 将颜色库从chalk换成更轻量的colorette当前 src/utils/color.ts 即基于 colorette 实现并内联了 ANSI 颜色定义同时移除dayjs时间依赖从依赖层面大幅压缩体积。这两项属于性能提升而非功能增强CHANGELOG 以 Performance 分类标注。2.4 修复与细节v3.0.0 还修复了一批类型与行为问题给 mock 函数补充.raw987dadc、修正颜色格式工具的默认值、CONSOLA_LEVEL环境变量正确传入 defaultsPR #129见 src/index.ts、fancy reporter 在无法确定终端宽度时把时间与 tag 显示在右侧PR #128等构建侧则改用向后兼容的 CJS wrapper 承载默认导出e2e6aa6。三、v3.0.1 ~ v3.0.2稳定性与边界修复这两个补丁版本聚焦真实运行环境的边界问题Worker 支持utils 改用默认的stream.writePR #173避免在 worker 线程中因自定义 write 导致异常wrapStd 包装 stdout/stderrwrapStd现在会正确包装options.stdout与options.stderrab59db6而不仅是进程默认流相关实现见 src/consola.tsfancy 徽章降级无法确定宽度时改用更精简的徽章样式ad24029mockTypes 基于 options.types 进行 mockf9d86b6修复了不按自定义 types mock 的问题reporters 改为具名导出BasicReporter、FancyReporter、BrowserReporter以具名导出方式暴露便于按需引用。四、v3.1.0子路径导出与 fancy 开关v3.1.0 是按需裁剪理念落地的关键版本/basic、/core、/browser子路径导出PR #178从 package.json 的exports字段可以看到./basic、./core、./utils、./browser均有独立的 import/require/types 映射。其中consola/basic使用纯 BasicReportersrc/basic.ts、consola/browser使用 BrowserReporter 与浏览器原生prompt/confirmsrc/browser.ts、consola/core仅包含核心类不带任何 reportersrc/core.ts可节省约 80% 的包体积fancy选项PR #177createConsola({ fancy: true | false })可显式控制是否使用 fancy reporter。默认逻辑是isCI || isTest时回退到 BasicReporter见 src/index.ts该行为源自 v2.2.4 仅 CI 与测试环境使用 basic reporter 的延续。五、v3.2.xbox、utils 子路径与 fancy 视觉增强v3.2.x 集中补齐了输出美化的工具矩阵5.1consola.box边框输出PR #193新增box日志类型与box()工具函数实现在 src/utils/box.ts内置 8 种边框预设solid、double、doubleSingle、doubleSingleRounded、singleThick、singleDouble、singleDoubleRounded、roundedsrc/utils/box.ts样式选项borderColor默认white、valign默认center、padding默认 2、marginLeft/marginTop/marginBottom默认 1见 src/utils/box.tsv3.2.1 修复了singleThick预设命名问题PR #201v3.2.3 将box的 style 选项放宽为PartialBoxStylePR #210允许只覆盖部分样式完整示例见 examples/box.ts。5.2consola/utils子路径与 Color utilsPR #199、#200新增consola/utils子路径导出把纯函数工具独立成可复用集合当前包含字符串处理stripAnsi、centerAlign、rightAlign、leftAlign、alignsrc/utils/string.ts颜色工具colors、getColor、colorizesrc/utils/color.ts边框boxsrc/utils/box.ts树形formatTreev3.3.0 加入见下文。5.3 fancy reporter 支持下划线与其他修复下划线样式PR #191_underlined_文本会被渲染为下划线样式由 src/reporters/fancy.ts 的characterFormat处理v3.2.1 进一步修正了带前后空格的下划线样式PR #203保留 tag 大小写PR #190不再把 tag 强制小写mock 继承PR #183create/withTag产生的子实例会继承父实例的 mock 行为src/consola.ts 中create()会检查this._mockFn并对新实例重新mockTypesselect/multiselect 返回类型修正PR #197修复了单/多选的类型推断。六、v3.3.xformatTree、prompt 取消策略与 error causev3.3.x 是交互体验与错误诊断深度打磨的版本6.1formatTree树形输出PR #223、#267新增formatTree工具src/utils/tree.ts可将嵌套结构渲染为带├─/└─分支的树节点支持字符串或{ text, children?, color? }对象选项支持color整体颜色、prefix默认两个空格、maxDepthPR #267 新增的最大深度截断与ellipsis默认...示例见 examples/tree.ts。6.2 prompt可配置取消策略PR #325与类型导出PR #301此前用户按 CtrlC 取消 prompt 时一律按默认值解析v3.3.0 起可通过{ cancel: ... }配置五种策略实现在 src/prompt.ts 的handleCancel中default以default或initial值解析默认行为undefined以undefined解析null以null解析symbol以Symbol.for(cancel)解析即kCancelreject抛出一个名为ConsolaPromptCancelledError的 Error 拒绝 Promise。同时所有 prompt 选项类型TextPromptOptions、ConfirmPromptOptions、SelectPromptOptions、MultiSelectOptions、PromptOptions从 src/prompt.ts 具名导出并在 src/shared.ts 统一 re-export。6.3 错误报告支持cause链PR #308当 Error 带有cause时BasicReporter 会递归格式化整条 cause 链并以[cause]:前缀与逐级缩进区分层级见 src/reporters/basic.tserrorLevel每深入一层递增 1。6.4 其他修复select/multiselect 使用initialPR #232修复初始值不生效的问题box 标题颜色与边框一致PR #236标题不再单独取色fancy 在Intl不可用时回退v3.3.1PR #326src/reporters/fancy.ts 中stringWidth会先检测Intl.Segmenter不可用则退回stripAnsi(str).length构建与类型修复子路径类型PR #265、为浏览器构建补充require条件PR #243、修复select类型返回值PR #238工程化引入 vitest 测试框架PR #182当前 test/consola.test.ts 即基于 vitest。七、v3.4.xclack/prompts 上游化与宽度计算修复v3.4.x 把 prompt 交互层切换到官方上游clack/promptsv3.4.0PR #332并围绕宽度计算做了两轮精准修复v3.4.0box 宽度计算排除 ANSI 转义序列字符PR #336即 src/utils/box.ts 中宽度计算使用stripAnsi(line).length而非原始长度避免着色文本撑破边框v3.4.2box 宽度计算纳入标题宽度PR #362src/utils/box.ts 的Math.max(..., opts.title ? stripAnsi(opts.title).length : 0)正是该修复的实现v3.4.1从堆栈中移除所有 message 行PR #356让 src/utils/error.ts 的parseStack只保留干净的调用帧v3.4.2导出 tree utilsPR #349formatTree及相关类型可通过consola/utils稳定引用同时清理无用依赖PR #361构建v3.4.0 更新 exports 以适配 node16 的 TypeScript 解析PR #331该改动曾于 v3.3.2 引入同时为 string-width 打了 node 14 补丁、v3.3.3 回退最终在 v3.4.0 重新落地——这一来一回正好说明node16 module resolution 的 exports 调整需要谨慎验证升级时务必关注此类构建层变更。八、回溯 2.xspam 防刷、mock 与全局接管v2.x 奠定了 consola 的经典能力CHANGELOG 记录了它们的诞生顺序8.1 spam 防刷机制v2.8.0 ~ v2.14.0v2.8.0 引入 spam 预防7da806bv2.9.0 支持统计重复次数197a6b3v2.14.0 改进 throttle 逻辑5314eee当前实现位于 src/consola.ts相同日志在throttle默认 1000ms窗口内重复超过throttleMin默认 5次会被合并最终输出时追加(repeated N times)提示test/consola.test.ts 精确验证了该行为10 次相同日志最终只输出 7 条末条 args 为[SPAM, (repeated 4 times)]。8.2 mockTypes 与别名体系v2.1.0v2.1.0 引入mockTypesa332890与别名机制cbea7bd。当前 src/consola.ts 维护了完整的向后兼容别名add、remove、clear、withScope、mock、pause、resume。README 中的 mock 用法Jest 的jest.fn()、Vitest 的vi.fn()配合wrapAll()可在测试中拦截全部日志输出。8.3 全局接管与暂停恢复v2.0.0 起提供wrapConsole/restoreConsole、wrapStd/restoreStd、pauseLogs/resumeLogs。实现细节wrapConsole把 console 各方法备份为__type后替换为对应类型的.rawsrc/consola.tswrapStd包装 stdout/stderr 的write为log.rawsrc/consola.ts暂停时日志进入全局队列恢复时按序重放src/consola.ts配套示例见 examples/wrap-console.ts、examples/wrap-std.ts。8.4 formatOptions 与浏览器能力v2.2.0 ~ v2.15.0v2.2.0 支持formatOptions7ed640fv2.15.0 允许formatOptions.date隐藏时间PR #101v2.11.0 浏览器端支持 printf 风格格式化字符串PR #66v2.7.0 优化宽度逻辑宽度 80 时始终隐藏右侧信息07d8246并在空间不足时智能隐藏时间与 tag00a375f——这些行为在 src/reporters/fancy.ts 中仍可看到痕迹space 0 columns 80才把 tag/date 放到右侧v2.12.0 补齐 reporter 的 TypeScript 定义PR #94。九、回溯 1.x从 0.1.0 到 2.0 的奠基v0.1.02018-03-31首个版本提供与 console 兼容的日志类型96a8162v1.1.0不依赖ora重写 FancyReporter73c1ddcv1.2.0basic reporter 支持additional字段b50cad8、按需引入 lodash 方法优化体积91065e4v1.3.0支持额外日志参数8b6d3d2、防止多版本 consola 实例冲突0bce262v1.4.0支持自定义附加样式PR #18、fancy 支持icon字段0123bedv1.4.4暴露global.consola558cae5。十、结合源码的关键实现速览把 CHANGELOG 的条目映射到当前源码可以得到几条版本演进即代码现状的印证链CHANGELOG 条目源码位置说明Log levels/types 移到 constantsv3.0.0src/constants.tsLogLevels/LogTypes/LogType/LogLevel全部集中定义consola.boxv3.2.0src/utils/box.ts8 种边框预设 PartialBoxStyle样式formatTree maxDepthv3.3.0src/utils/tree.ts_buildTree递归渲染分支maxDepth截断prompt cancel 策略v3.3.0src/prompt.tshandleCancel五种策略 switcherror cause 支持v3.3.0src/reporters/basic.tsformatError递归处理err.causebox 宽度排除转义/含标题v3.4.0/v3.4.2src/utils/box.tsstripAnsi计算文本与标题宽度Intl 不可用回退v3.3.1src/reporters/fancy.ts检测Intl.Segmenter测试环境 logLevel1v3.0.0src/index.tsisTest→LogLevels.warn子路径导出v3.1.0/v3.2.0package.json./basic、./core、./browser、./utils四组条件导出十一、如何在项目中跟随版本演进升级前阅读对应版本段CHANGELOG 中带 ⚠️ 的条目即为 Breaking Changesv3.0.0 的 TypeScript 重写、constants 收敛以及 2.0 时代的 internal 重构与additionalStyle→additionalColor重命名升级 v2 → v3 前务必确认这两处按需裁剪入口体积敏感场景使用consola/basic或consola/coreNode 服务端默认入口用 fancy浏览器用consola/browsersrc/browser.ts 内置了基于confirm/prompt的浏览器 prompt 实现对照示例验证行为prompt、box、tree、spam 防刷、raw 输出、std/console 接管均有对应示例examples其中 examples/raw.ts 演示了.raw强制按纯对象输出、examples/spam.ts 演示防刷合并效果用环境变量控制级别Node 与 basic 构建支持CONSOLA_LEVEL环境变量覆盖日志级别src/index.ts、src/basic.ts但 browser 与 core 构建不支持README 已明确说明关注构建层变更v3.3.2 → v3.3.3 → v3.4.0 的node16exports 反复调整表明使用 TS 的node16/nodenextmoduleResolution 时需在升级后重跑类型检查。综上consola 的 CHANGELOG 不只是变更流水账它完整记录了项目从单文件 console 包装器走向模块化、类型安全、可交互、可裁剪的通用日志工具的架构决策全过程。对使用者而言理解这份演进史就等于理解了当前 API 的设计动机与取舍边界。赞分享开发工具CLI【免费下载链接】consola Elegant Console Logger for Node.js and Browser项目地址https://gitcode.com/gh_mirrors/co/consola点击查看免费下载相关推荐md-editor-v3 版本演进深度解析从 v6.3.2 到 v7.0.0 的核心特性、破坏性变更与源码实现md editor v3 版本演进深度解析从 v6.3.2 到 v7.0.0 的核心特性、破坏性变更与源码实现 本文基于仓库 CHANGELOG.md htt前端UI组件富文本Inputmask 5.x 版本演进全解读核心特性、破坏性变更与源码级机制解析Inputmask 5.x 版本演进全解读核心特性、破坏性变更与源码级机制解析 导读 Inputmask 是一个不依赖 jQuery 也可独立运行的前端输入掩前端UI组件FlexSearch 版本演进全解析从 v0.3 到 v0.8 的核心特性、破坏性变更与迁移指南FlexSearch 版本演进全解析从 v0.3 到 v0.8 的核心特性、破坏性变更与迁移指南 FlexSearch 是一个面向浏览器与 Node.js 的搜索引擎后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考