vue-router
Version:
## Status: Alpha
37 lines (23 loc) • 1.55 kB
Markdown
# vue-router-next [](https://circleci.com/gh/vuejs/vue-router-next)
## Status: Alpha
The current codebase has most of the existing features on Vue Router v3.x and is usable. It supports all the [merged RFCs](https://github.com/vuejs/rfcs/pulls?q=is%3Apr+is%3Amerged+label%3Arouter).
Since the library is still unstable **and because we want feedback** on bugs and missing features, **it will probably go through a few breaking changes**.
## Known issues
### Breaking changes compared to vue-router@3.x
- `mode: 'history'` -> `history: createWebHistory()`
- Catch all routes (`/*`) must now be defined using a parameter with a custom regex: `/:catchAll(.*)`
- `router.match` and `router.resolve` are merged together into `router.resolve` with a slightly different signature
- `router.getMatchedComponents` is now removed as they can be retrieved from `router.currentRoute.value.matched`:
```js
router.currentRoute.value.matched
.map(record => Object.values(record.components))
.flat()
```
#### Improvements
These are technically breaking changes but they fix an inconsistent behavior.
- Pushing or resolving a non existent named route throws an error instead of navigating to `/` and displaying nothing.
### Missing features
- `keep-alive` is not yet supported
- Partial support of per-component navigation guards. No `beforeRouteEnter`
## Contributing
See [Contributing Guide](https://github.com/vuejs/vue-router-next/blob/master/.github/contributing.md).