Packages

vue-router

5.5.1 · 13 Nov 2026MIT13.4M / weekRepositoryHomepagenpmAtom feed

Your version

5.5.0

10 Nov 2026Where it was published

5.5.1 is the newest release of 5.x.

Summary· from the note as AI read it

No actionNothing to change: 5 new, 23 fixed.

New

  • Warn on colliding query with params
  • scroll-restoration: Make capture triggers configurable
  • unplugin: Declare route params in defineProps() with definePage props true
  • volar: Type defineProps() with route params when definePage props is true
  • volar: Add typedDefineProps option to sfc-typed-router

In short

8 new2 faster23 fixed

Release note

Features

  • Warn on colliding query with params

  • experimental: Customize scroll restoration capture listeners

  • experimental: Export default scroll capture listener setup

  • experimental: Support type safe route record props

  • scroll-restoration: Make capture triggers configurable

  • unplugin: Declare route params in defineProps() with definePage props true

  • volar: Type defineProps() with route params when definePage props is true

  • volar: Add typedDefineProps option to sfc-typed-router

Bug Fixes

  • Avoid replaceState on pagehide if scrollRestoration is manual

  • Fallback to useId for vapor

  • Preserve named-view props and detect quoted props keys

  • Keep non-object props when merging

  • experimental: Match root paths with multiple optional params

  • experimental: Remove query param set to undefined

  • experimental: Keep query value for params omitted from params

  • experimental: Compare query values element by element in R0123

  • matcher: Avoid exponential backtracking on .* repeatable params

  • router-view: UseRoute() returns the route prop in descendants

  • router-view: Handle pending async component roots in onRouteRendered

  • scroll: Save scroll positions in sessionStorage instead of history.state

  • scroll: Keep scroll positions in memory when sessionStorage fails

  • scroll: Ignore invalid scroll positions in sessionStorage

  • scroll-restoration: Overwrite parent capture and restore

  • scroll-restoration: Reserve keys for pending async pages

  • scroll-restoration: Restore position after native hash links

  • types: Add hotUpdateCallback to auto-resolver handleHotUpdate

  • types: Accept classic parseQuery in RouterOptions

  • types: Allow undefined on push for query params with default

  • unplugin: Support definePage with webpack and rspack

  • unplugin: Keep aliased named imports in definePage extraction

  • unplugin: Reload pages with stale route props

Performance

  • Strip build-time definePage properties

  • unplugin: Watch page files only in dev server

A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.