vue-router
5.5.1 · 13 Nov 2026MIT13.4M / weekRepositoryHomepagenpmAtom feed
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.