Skip to content

chore(deps): update devdependency @nuxt/test-utils to v4#300

Open
renovate[bot] wants to merge 1 commit intomainfrom
renovate/nuxt-test-utils-4.x
Open

chore(deps): update devdependency @nuxt/test-utils to v4#300
renovate[bot] wants to merge 1 commit intomainfrom
renovate/nuxt-test-utils-4.x

Conversation

@renovate
Copy link
Contributor

@renovate renovate bot commented Feb 9, 2026

This PR contains the following updates:

Package Change Age Confidence
@nuxt/test-utils ^3.19.2 → ^4.0.0 age confidence

Release Notes

nuxt/test-utils (@​nuxt/test-utils)

v4.0.0

Compare Source

4.0.0 is the next major release.

👀 Highlights

We're releasing Nuxt Test Utils v4, with support for Vitest v4. 🚀

Better mocking support

The biggest improvement in this release is how mocking works. Nuxt initialization has been moved from setupFiles to the beforeAll hook (#​1516), which means vi.mock and mockNuxtImport calls now take effect before Nuxt starts. This fixes a long-standing issue where mocks for composables used in middleware or plugins wouldn't apply reliably (#​750, #​836, #​1496).

On top of that, mockNuxtImport now passes the original implementation to the factory function (#​1552), making partial mocking much more natural:

mockNuxtImport('useRoute', original => vi.fn(original))

it('my test', async () => {
  vi.mocked(useRoute).mockImplementation(
    (...args) => ({ ...vi.mocked(useRoute).getMockImplementation()!(...args), path: '/mocked' }),
  )

  const wrapper = await mountSuspended(MyComponent)
  expect(wrapper.find('#path').text()).toBe('/mocked')
})
registerEndpoint improvements

registerEndpoint now works correctly with query parameters in URLs (#​1560), and endpoints registered in setup files are no longer lost when modules reset (#​1549).

🚧 Migration

@nuxt/test-utils v4 contains a few breaking changes, almost all related to requiring at least vitest v4 as a peer dependency (if you are using vitest). It replaces vite-node with Vite's native Module Runner and simplifies pool configuration.

This will mean improvements for test performance and mocking, but does require some changes to your test code.

[!TIP]
Most of the changes below are straightforward. The biggest thing to watch out for is code that runs at the top level of a describe block — see below.

Update your dependencies

Update vitest and its companion packages together:

{
  "devDependencies": {
-   "@​nuxt/test-utils": "^3.x",
-   "vitest": "^3.x",
-   "@​vitest/coverage-v8": "^3.x"
+   "@​nuxt/test-utils": "^4.0",
+   "vitest": "^4.0",
+   "@​vitest/coverage-v8": "^4.0"
  }
}
Peer dependencies

We've tightened peer dependency ranges. You may need to update some of these:

Dependency v3 v4
vitest ^3.2.0 ^4.0.2
happy-dom * >=20.0.11
jsdom * >=27.4.0
@jest/globals ^29.5.0 || >=30.0.0 >=30.0.0
@cucumber/cucumber ^10.3.1 || >=11.0.0 >=11.0.0
@testing-library/vue ^7.0.0 || ^8.0.1 ^8.0.1
Later environment setup

This is the change that might require most change in your tests. Because we've moved the nuxt environment setup into beforeAll, this means composables called at the top level of a describe block will fail with [nuxt] instance unavailable.

// Before (worked in vitest v3)
describe('my test', () => {
  const router = useRouter() // ran lazily, after environment setup
  // ...
})

// After (vitest v4)
describe('my test', () => {
  let router: ReturnType<typeof useRouter>

  beforeAll(() => {
    router = useRouter() // runs after environment setup
  })
  // ...
})

This applies to useRouter(), useNuxtApp(), useRoute(), and any other Nuxt composable or auto-import.

[!TIP]
If you only need the value within individual tests, beforeEach or directly within the test works too.

Stricter mock exports

If you use vi.mock with a factory function, accessing an export that the factory doesn't return will now throw an error instead of silently returning undefined.

// Before: accessing `bar` would silently return undefined
vi.mock('./module', () => ({ foo: 'mocked' }))

// After: accessing `bar` throws
// Fix: use importOriginal to include all exports
vi.mock('./module', async (importOriginal) => ({
  ...await importOriginal(),
  foo: 'mocked',
}))

[!NOTE]
If you're mocking a virtual module (like #build/nuxt.config.mjs) where importOriginal can't resolve the real module, you might need to explicitly list all accessed exports in your mock factory.

Other changes

For the full list, see the vitest v4 migration guide.

👉 Changelog

compare changes

🚀 Enhancements
  • deps: ⚠️ Upgrade to vitest v4 (#​1481)
  • deps: ⚠️ Drop official support for older versions of test runners + dom environments (31fdc262a)
  • runtime-utils: Pass original to mockNuxtImport factory (#​1552)
  • runtime: ⚠️ Change nuxt start timing to beforeAll hook (#​1516)
  • e2e: Support setup and teardown timeouts in setupBun (#​1578)
🩹 Fixes
  • runtime: Handle optional chaining vueWrapper plugin installed check (#​1547)
  • runtime-utils: Keep endpoints from registerEndpoint in setup file (#​1549)
  • runtime-utils: Support registerEndpoint with query params (#​1560)
  • runtime-utils: Avoid local variable in mockNuxtImport macro (#​1564)
  • runtime-utils: Add missing nextTick import (#​1563)
  • Pin h3-next to patch (1ff3bbb91)
  • playwright: Bump windows timeout (63e39b7c9)
  • config: Respect include options in non nuxt environment simple setup (#​1570)
💅 Refactors
  • module: Use @nuxt/devtools-kit for devtools hooks (426e0b537)
  • runtime: Remove unnecessary querySelector (#​1577)
📖 Documentation
🏡 Chore
  • Allow changelog update util to return major bump (9e86cadab)
  • Make app-vitest follow advised setup guidelines (#​1542)
  • Update lockfile (6d798b5e1)
  • config: Migrate Renovate config (#​1568)
  • Add test utils setup to .nuxtrc (b4021dee4)
✅ Tests
  • Avoid running root test script twice (44f6bd396)
⚠️ Breaking Changes
  • deps: ⚠️ Upgrade to vitest v4 (#​1481)
  • deps: ⚠️ Drop official support for older versions of test runners + dom environments (31fdc262a)
  • runtime: ⚠️ Change nuxt start timing to beforeAll hook (#​1516)
❤️ Contributors

v3.23.0

Compare Source

3.23.0 is the next minor release.

👉 Changelog

compare changes

🚀 Enhancements
  • runtime-utils: Support h3 v2 (#​1515)
  • module: Add install wizard when freshly installed (#​1538)
🩹 Fixes
  • e2e: Ensure $fetch is not typed as any (1f4754ea9)
🏡 Chore
✅ Tests
  • Add cleanup to resolve-config tests (#​1537)
🤖 CI
  • Prepare build environment in autofix workflow (2c0864ed6)
❤️ Contributors

v3.22.0

Compare Source

3.22.0 is the next minor release.

👉 Changelog

compare changes

🚀 Enhancements
  • runtime-utils: Unify logic of mount + render helpers (#​1522)
  • module: Run vitest in separate process (#​1524)
  • runtime-utils: Allow skipping initial route change (fd77ec066)
  • runtime: Skip route sync emulation when NuxtPage exists (#​1530)
🔥 Performance
  • module: Skip nuxt-root stub plugin when building (#​1512)
🩹 Fixes
  • runtime-utils: Reject promise on error render + mount helpers (#​1503)
  • runtime-utils: Support new .sync method for syncing route (1148c3cf1)
  • e2e: Always override global env options with inline options (c8f881b3d)
  • runtime-utils: Avoid missing render warn on reject render + suspend helpers (#​1520)
  • e2e: Use server.deps rather than deps (2b3c86921)
  • config: Also call sync() in initial setup (ec555192c)
  • module: Use devtools:before hook instead of direct config check (#​1532)
  • config: Do not override vitest root with nuxt rootDir (#​1531)
💅 Refactors
  • runtime-utils: Do not export addCleanup (86b4998bb)
  • module: Extract nuxt environment options plugin (5ada22a9f)
📖 Documentation
  • Fix link to module authors testing guide (#​1511)
🏡 Chore
✅ Tests
  • Use local kit version for module (79f1e14d5)
  • Add defaultLocale in i18n test (059988fc3)
  • Avoid definePageMeta compiler-hint warning (#​1523)
🤖 CI
❤️ Contributors

v3.21.0

Compare Source

3.21.0 is the next minor release.

👉 Changelog

compare changes

🚀 Enhancements
  • runtime-utils: Support rerender behavior in renderSuspended (#​1466)
  • runtime-utils: Support once option in registerEndpoint (#​1475)
  • runtime-utils: Support css modules in mount + render helpers (#​1464)
  • runtime-utils: Pass app context across in mount + render helpers (#​1477)
  • runtime-utils: Support mocked target arguments in mockNuxtImport (#​1492)
🩹 Fixes
  • runtime: Remove redefinition of $fetch.create (#​1471)
  • runtime-utils: Pass non-enumerable globalProperties in mount + render helpers (#​1476)
  • module: Include vitest config in node project (#​1497)
  • runtime-utils: Improve mount + render helpers (#​1483)
  • Revert to @nuxt/kit v3 for bridge support (#​1498)
🏡 Chore
  • Move built dep configuration -> workspace file (d936cb465)
  • Update pnpm to 10.21 and enable trust policy (ed6ff050d)
  • Revert pnpm trust policy and restore provenance action (b034f0a5e)
  • Remove spurious globby dependency (eba19d16b)
  • Remove export (2a88683bd)
  • Remove @nuxt/kit from peer dependencies (b80ca5ea8)
  • Add back @nuxt/kit as peer dep (5c126e1af)
  • Bump vite-node to v5 (3322919c2)
🤖 CI
  • Rebuild better-sqlite3 on windows (9fdaf3824)
❤️ Contributors

v3.20.1

Compare Source

Configuration

📅 Schedule: Branch creation - "on Monday" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate
Copy link
Contributor Author

renovate bot commented Feb 9, 2026

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

  • any of the package files in this branch needs updating, or
  • the branch becomes conflicted, or
  • you click the rebase/retry checkbox if found above, or
  • you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: package-lock.json
npm warn Unknown env config "store". This will stop working in the next major version of npm.
npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: @nuxt/test-utils@4.0.0
npm error Found: vitest@3.2.4
npm error node_modules/vitest
npm error   dev vitest@"^3.2.4" from the root project
npm error
npm error Could not resolve dependency:
npm error peerOptional vitest@"^4.0.2" from @nuxt/test-utils@4.0.0
npm error node_modules/@nuxt/test-utils
npm error   dev @nuxt/test-utils@"^4.0.0" from the root project
npm error   @nuxt/test-utils@">=3.13.1" from vitest-environment-nuxt@1.0.1
npm error   node_modules/vitest-environment-nuxt
npm error     vitest-environment-nuxt@"^1.0.1" from @nuxt/test-utils@4.0.0
npm error
npm error Conflicting peer dependency: vitest@4.0.18
npm error node_modules/vitest
npm error   peerOptional vitest@"^4.0.2" from @nuxt/test-utils@4.0.0
npm error   node_modules/@nuxt/test-utils
npm error     dev @nuxt/test-utils@"^4.0.0" from the root project
npm error     @nuxt/test-utils@">=3.13.1" from vitest-environment-nuxt@1.0.1
npm error     node_modules/vitest-environment-nuxt
npm error       vitest-environment-nuxt@"^1.0.1" from @nuxt/test-utils@4.0.0
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error /runner/cache/others/npm/_logs/2026-02-09T02_59_45_929Z-eresolve-report.txt
npm error A complete log of this run can be found in: /runner/cache/others/npm/_logs/2026-02-09T02_59_45_929Z-debug-0.log

@netlify
Copy link

netlify bot commented Feb 9, 2026 •
edited
Loading

❌ Deploy Preview for nuxt-leaflet failed. Why did it fail? →

Name Link
🔨 Latest commit fa557d3
🔍 Latest deploy log https://app.netlify.com/projects/nuxt-leaflet/deploys/69894db2bfa6a600087d965a

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

0 participants