Nuxt Test Utils v4发布：集成Vitest v4，全面重构Mock机制

Nuxt团队发布Nuxt Test Utils v4.0.0，这是官方Nuxt测试库的首个主版本。更新以Vitest v4为唯一依赖要求，从根本上重构了测试环境和Mock工作方式。

核心变更

环境初始化迁移至beforeAll

最具影响力的变更将Nuxt测试环境搭建从setupFiles迁移到beforeAll钩子。修复了两个长期存在的问题：模块级mock被静默忽略，因为组合式函数在mock生效前就被执行。

需要迁移：在describe块顶层调用Nuxt组合式函数（如useRouter()、useNuxtApp()）现在会抛出错误。需将调用移入beforeAll。

增强mockNuxtImport

mockNuxtImport现在将原始实现传入工厂函数，实现更简洁的部分mock——可以包装或扩展真实实现，而非从零构建。

registerEndpoint修复

• 修复了配置文件中注册的端点在测试间丢失的状态管理bug
• 包含查询参数的URL模式现在可以正确匹配

更严格的Mock导出（Vitest v4）

访问工厂函数未显式返回的mock模块导出项现在会抛出错误，而非静默返回undefined。修复方案：在工厂返回值中展开importOriginal。

更新的对等依赖

• happy-dom: 20.0.11+
• jsdom: 27.4.0+
• @jest/globals: 30.0.0+
• @cucumber/cucumber: 11+

重要意义

Nuxt Test Utils在Vue测试生态中占据独特位置——它在测试环境中运行完整Nuxt应用，衔接了单元测试和E2E测试。

周npm下载量47万+，这是Nuxt生态系统的关键更新。团队应仔细规划迁移，因为mock行为和组合式函数初始化时序存在破坏性变更。