Update dependency vue-router to v4 #525

It's now possible to completely omit the component option when defining routes with children. While nested routes are about defining layouts, they are also directly connected to a path and users often found themselves defining a pass through component that would just render a <RouterView> component to reuse the path structure. You can now simplify this to:

- import { RouterView } from 'vue-router'
- import { h } from 'vue'
-
 const routes = [
   {
     path: '/admin',
-     component: () => h(RouterView),
     children: [
       { path: 'users', component: AdminUserList },
       { path: 'users/:id', component: AdminUserDetails },
     ],
   },
 ]

In other words, you can now nest paths without having to define a component.

Passing History State in navigations

Passing History State through router.push() has been implemented and used by the router since its version 4.0 but hasn't been exposed as a public API until now. This enables passing a state property when calling router.push() or router.replace(). This is useful to pass global state to be associated with the history entry that cannot be shared by copying the URL. One common example of this are Modals:

// go to /users/24 but show a modal instead
router.push({ name: 'UserDetail', params: { id: 24 } state: { backgroundView: ... } })

To see a full example, check the modal e2e test, it has been updated to use the state property.

It's worth noting this shouldn't be used to pass fetched data or complex objects such as classes because of type and size limitations. Check the History State documentation for more information about the state property.

Given the nature of the <RouterView>'s route prop, there is also a new function loadRouteLocation() that can be used on a resolved route location to load a route with lazy loading:

import { loadRouteLocation } from 'vue-router'

const loadedRoute = await loadRouteLocation(router.resolve('/users/24'))

Typed Routes

In v4.1 we were initially planning to introduce types to automatically detect the params from a path property, creating autocomplete and type safety in router.push() and <RouterLink>'s to prop. It was implemented but also turned out to be extremely slow after ~50 routes due to the nature of the types relying on nesting and complex unions. Instead, we are introducing a build plugin to generate the types of the routes for you based your file structure. This is similar to Nuxt and Vite Plugin Pages but with full type support (similar to nuxt-typed-router) while allowing you to keep using the exact same API, just with Autocompletion and typing hints 😄. The plugin currently supports Vite, Webpack (with some caveats), and rollup and it's currently experimental to gather feedback from the community and build a flexible solution. We hope to release a stable version in the following months.

Check out the plugin GitHub repository for installation instructions and documentation.

Here are some other examples of how much this plugin can improves your developer experience:

CJS/MJS support for Node

We now expose a few extra entry points for Node but kept the old ones as well to prevent any disruption to the existing users. You can find more information about this in the corresponding pull request.

Please refer to CHANGELOG.md for details.

`v4.0.16`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.15`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.14`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.13`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.12`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.11`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.10`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.9`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.8`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.7`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.6`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.5`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.4`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.3`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.2`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.1`

Compare Source

Please refer to CHANGELOG.md for details.

`v4.0.0`

Compare Source

A more complete but lighter Router

Today Vue Router 4 is officially released as stable.
After 14 alphas, 13 betas and 6 release candidates, Vue Router v4 is ready to bring the best of routing to your Vue 3 applications with improved bundle size, TypeScript integration, new features and consistency improvements for modern apps.

It has taken almost 2 years of work, around 1500 commits, 15 RFCs, and the help of many users and their bug reports and feature requests to get here. Thank you all for your very much appreciated help!

Project Organization improvements

Vue Router is now divided in three modules:

History implementation: handles the address bar and is specific to the environment Vue Router runs on (Node, Browser, Mobile, etc)
Router Matcher: handles the parsing of routes /users/:id and its ranking
Router: connects everything together and handle routing specific features like navigation guards

Dynamic Routing

One the most wanted features on Vue Router is Dynamic Routing. It makes the router more flexible and powerful and open possibilities for applications that were not possible before! This is possible thanks to an advanced path parsing with automatic ranking, allowing the router to guess what route should be matched based on the URL string representation, allowing user to define routes in any order.

Improved Navigation system

The new navigation system is more consistent and improves the experience of Scroll Behavior to match native browser behavior. It also gives users almost more information about the status of a navigation and allow using that information to improve user experience through global UI elements like progress bars and modals.

More powerful Devtools

Thanks to the new Vue Devtools, Vue Router is able to create more advanced integrations: navigation in the timeline and a complete route directory that helps you debug routes.

Better Navigation guards

Say good bye to next and avoid easy-to-make mistakes inside navigation guards: return any value you were passing to next. The previous version is still supported to ease migration!

More information on the updated documentation.

Consistent encoding in routes

Encoding has been adapted to make it consistent across different browsers and route location properties (params, query and hash). You don't need to encode these properties when passing them to router.push() and they will always appear decoded in the route locations (e.g. $route and useRoute()).

Small migration path

Vue Router 4 focus on improving the existing Router while keeping a very similar API, migration should be short and almost limited to a few renames if you were using the basics of Vue Router. You can check the full migration guide on the documentation

The future of the Router

Vue Router has been effectively stable for the past couple of months and makes it possible to now focus on:

Better Developer experience with existing tooling (Vetur, Vite, Devtools, etc)
Better integration with modern features like Suspense
RFCs to improve the existing API or bring new ones
Lighter versions of the router

Trying It Out

If you want to give Vue Router 4 a quick try, you can check this CodeSandbox, this Vite template with Tailwind CSS, or use the CLI to get started.

To Learn more about Vue Router 4, check out our new documentation. If you are an existing Vue 2.x user, go directly to the Migration Guide.

Supporting Vue Router Development

If your company uses Vue Router, please consider supporting its development by supporting me 🙏 . It will mean a lot and really help me to keep working on improving the Vue Ecosystem.

If you were already using the release candidate version of vue router, you can find the list of improvements on the CHANGELOG.md.

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), 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 · 2022-06-10T00:52:38Z

⚠ 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 ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: [email protected]
npm ERR! Found: [email protected]
npm ERR! node_modules/vue
npm ERR!   vue@"2.7.16" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer vue@"^3.2.0" from [email protected]
npm ERR! node_modules/vue-router
npm ERR!   vue-router@"4.3.2" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! 
npm ERR! For a full report see:
npm ERR! /tmp/renovate/cache/others/npm/_logs/2024-04-18T11_48_33_704Z-eresolve-report.txt

npm ERR! A complete log of this run can be found in: /tmp/renovate/cache/others/npm/_logs/2024-04-18T11_48_33_704Z-debug-0.log

renovate · 2024-06-10T16:02:49Z

⚠️ 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 error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: [email protected]
npm error Found: [email protected]
npm error node_modules/vue
npm error   vue@"2.7.16" from the root project
npm error
npm error Could not resolve dependency:
npm error peer vue@"^3.2.0" from [email protected]
npm error node_modules/vue-router
npm error   vue-router@"4.5.0" from the root project
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 /tmp/renovate/cache/others/npm/_logs/2024-11-25T16_13_30_478Z-eresolve-report.txt
npm error A complete log of this run can be found in: /tmp/renovate/cache/others/npm/_logs/2024-11-25T16_13_30_478Z-debug-0.log

renovate bot added the 🤖 Automatic Issues/pull requests marked with this label were generated automatically by our helper bots. label Jun 10, 2022

renovate bot assigned Aareksio Jun 10, 2022

renovate bot force-pushed the renovate/vue-router-4.x branch from 33d10f0 to 7de3c94 Compare June 20, 2022 17:01

renovate bot force-pushed the renovate/vue-router-4.x branch 3 times, most recently from 34f6db6 to ed576c9 Compare July 11, 2022 11:31

renovate bot force-pushed the renovate/vue-router-4.x branch from ed576c9 to d69e0ec Compare July 27, 2022 11:45

renovate bot force-pushed the renovate/vue-router-4.x branch 5 times, most recently from cffb904 to 554e626 Compare August 26, 2022 13:03

renovate bot force-pushed the renovate/vue-router-4.x branch from 554e626 to 5d3d7c1 Compare September 6, 2022 16:42

renovate bot force-pushed the renovate/vue-router-4.x branch 3 times, most recently from 8301fab to 4aaa216 Compare October 31, 2022 08:36

renovate bot force-pushed the renovate/vue-router-4.x branch from 4aaa216 to 1963caf Compare October 31, 2022 22:11

renovate bot force-pushed the renovate/vue-router-4.x branch from 1963caf to af1f6dc Compare November 9, 2022 18:23

renovate bot force-pushed the renovate/vue-router-4.x branch from af1f6dc to b0d751b Compare May 11, 2023 12:15

renovate bot force-pushed the renovate/vue-router-4.x branch from b0d751b to 4ade5aa Compare May 18, 2023 16:39

renovate bot force-pushed the renovate/vue-router-4.x branch 2 times, most recently from 43d1b35 to bf097a5 Compare July 6, 2023 17:09

renovate bot force-pushed the renovate/vue-router-4.x branch from bf097a5 to cb490e4 Compare September 22, 2023 10:48

renovate bot force-pushed the renovate/vue-router-4.x branch from cb490e4 to c5ebe86 Compare February 21, 2024 18:06

renovate bot force-pushed the renovate/vue-router-4.x branch 2 times, most recently from 107829c to 6e4212d Compare April 18, 2024 11:48

renovate bot force-pushed the renovate/vue-router-4.x branch from 6e4212d to e0c0c99 Compare June 10, 2024 16:02

renovate bot force-pushed the renovate/vue-router-4.x branch from e0c0c99 to b8c3f22 Compare June 21, 2024 16:30

renovate bot force-pushed the renovate/vue-router-4.x branch 3 times, most recently from 6497ac2 to 4e23812 Compare August 6, 2024 17:56

renovate bot force-pushed the renovate/vue-router-4.x branch 2 times, most recently from 5f6bdd8 to 8ed8b9e Compare September 13, 2024 07:17

Update dependency vue-router to v4

b64f64b

renovate bot force-pushed the renovate/vue-router-4.x branch from 8ed8b9e to b64f64b Compare November 25, 2024 16:13

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update dependency vue-router to v4 #525

Update dependency vue-router to v4 #525

renovate bot commented Jun 10, 2022 •

edited

Loading

renovate bot commented Jun 10, 2022 •

edited

Loading

renovate bot commented Jun 10, 2024 •

edited

Loading

Update dependency vue-router to v4 #525

Are you sure you want to change the base?

Update dependency vue-router to v4 #525

Conversation

renovate bot commented Jun 10, 2022 • edited Loading

Release Notes

Vue Router 4.1

Omitting the component/components option in routes

Passing History State in navigations

Typed Routes

CJS/MJS support for Node

A more complete but lighter Router

Project Organization improvements

Dynamic Routing

Improved Navigation system

More powerful Devtools

Better Navigation guards

Consistent encoding in routes

Small migration path

The future of the Router

Trying It Out

Supporting Vue Router Development

Configuration

renovate bot commented Jun 10, 2022 • edited Loading

⚠ Artifact update problem

File name: package-lock.json

renovate bot commented Jun 10, 2024 • edited Loading

⚠️ Artifact update problem

File name: package-lock.json

renovate bot commented Jun 10, 2022 •

edited

Loading

Omitting the `component`/`components` option in routes

renovate bot commented Jun 10, 2022 •

edited

Loading

renovate bot commented Jun 10, 2024 •

edited

Loading