Nuxt.js Files

3.17.4 is a regularly-scheduled patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

:::sh
npx nuxi@latest upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

• nuxt: Use Set for circular dep plugin (#32110)
• Refactor Array.includes checks to use Sets (#32133)
• nuxt: Use shallowRef for primitive values (#32152)
• nuxt: Skip route rules processing for empty child array (#32166)
• nuxt: Use Intl.Collator instead of localeCompare (#32167)

🩹 Fixes

• nuxt: Do not await lazy asyncData inside <ClientOnly> (#32101)
• nuxt: Respect cachedData with multiple asyncData calls (#32099)
• nuxt: Clear async data after a tick (#32096)
• nuxt: Support reactive keys in useLazyAsyncData (#32092)
• rspack: Use ts-checker-rspack-plugin (#32115)
• nuxt: Clear previous head in island-renderer (#32100)
• nuxt: Handle virtual files prefixed with / (#32129)
• schema: Remove nitro options from DeepPartial (#31990)
• nuxt: Ensure legacy async data remains reactive (#32134)
• nuxt: Pass attrs down to single child of <ClientOnly> (#32131)
• nuxt: Fix merge conflicts (7044450d4)
• nuxt: Clone vnode when passing attrs down to client-only (b3acf0c78)
• vite: Do not replace global with globalThis (#32130)
• nuxt: Suppress client-side errors by crawlers (#32137)
• nuxt: Use fresh route when <NuxtLayout> first renders (#24673)
• nuxt: Add additional logging when skipping error page for bot (68c270083)
• nuxt: Add watch paths outside srcDir to parcel strategy (#32139)

📖 Documentation

• Use emphasis instead of quotes (#32078)
• Update useNuxtData default return to undefined (#32054)
• Capitalise headings (#32095)
• Prefix imports.dirs with alias (0dbf314d9)
• Mention node v20 is minimum requirement for nuxt setup (#32148)
• Use more descriptive link text (d0b1b9d35)

🏡 Chore

• Remove unneeded JSdoc comments (#32090)
• Use vitest workspaces for tests (#32121)

✅ Tests

• Add universal routing tests + clean up output (64178b6f4)
• nuxt: Add unit tests for watch strategies (#32138)
• Resolve watch path (8fb562c04)
• Use fake timers instead of setTimeout mock (#32142)

🤖 CI

• Rename workflow (835098fcb)
• Skip codeql event on merge_group events (46c259664)

❤️ Contributors

• John Tanzer (@moshetanzer)
• Daniel Roe (@danielroe)
• Robin (@OrbisK)
• @beer (@iiio2)
• Julien Huang (@huang-julien)
• हिमांशु (@CodeMan62)
• Norbiros (@Norbiros)
• watsonhaw5566 (@watsonhaw5566)
• xjccc (@xjccc)