用途:@nuxt/test-utils 是 Nuxt 官方测试工具库,用于在 Vitest 中测试 Nuxt 应用,覆盖组件、composable、服务端与 API 等场景。
主要能力:提供 Nuxt 测试环境(vitest-environment-nuxt)、mount/render 组件辅助、renderSuspended、mockNuxtImport、registerEndpoint、cleanup 等。v4.0 将 Nuxt 初始化从 setupFiles 移到 beforeAll,使 vi.mock 与 mockNuxtImport 能在 Nuxt 启动前生效;mockNuxtImport 新增 original 参数支持部分模拟;registerEndpoint 支持查询参数与 once 选项。
使用方式:在 Vitest 中配置 Nuxt 环境,用 mockNuxtImport 模拟 composable,用 registerEndpoint 模拟 API 路由,用 mount/render 测试组件。搜索可用 skilld search "query" -p @nuxt/test-utils,支持 docs:、issues:、releases: 前缀过滤。
限制与注意:v4 要求 vitest ^4.0.2,并收紧 happy-dom、jsdom 等依赖范围;describe 顶层调用 composable 会报 instance unavailable,需移入 beforeAll/beforeEach/test;vi.mock 对未返回导出更严格;服务端/API 测试应放在 nuxt 环境而非 node。具体安装命令与完整 API 文档暂未提供。