docs: add removal of unnamed params

diff --git a/docs/guide/migration/index.md b/docs/guide/migration/index.md
index 33dd30f02ba924d3895a7d162a37713a7225daf0..afc4c71e2a61ba0e43295273be7c8f40fa8794c1 100644 (file)
--- a/docs/guide/migration/index.md
+++ b/docs/guide/migration/index.md
@@ -252,6 +252,18 @@ const parent = this.$route.matched[this.$route.matched.length - 2]
 
 The `pathToRegexpOptions` and `caseSensitive` properties of route records have been replaced with `sensitive` and `strict` options for `createRouter()`. They can now also be directly passed when creating the router with `createRouter()`. Any other option specific to `path-to-regexp` has been removed as `path-to-regexp` is no longer used to parse paths.
 
+### Removal of unnamed parameters
+
+Due to the removal of `path-to-regexp`, unnamed parameters are no longer supported:
+
+- `/foo(/foo)?/suffix` becomes `/foo/:_(foo)?/suffix`
+- `/foo(foo)?` becomes `/foo:_(foo)?`
+- `/foo/(.*)` becomes `/foo/:_(.*)`
+
+:::tip
+Note you can use any name instead of `_` for the param. The point is to provide one.
+:::
+
 ### Usage of `history.state`
 
 Vue Router saves information on the `history.state`. If you have any code manually calling `history.pushState()`, you should likely avoid it or refactor it with a regular `router.push()` and a `history.replaceState()`:

diff --git a/playground/router.ts b/playground/router.ts
index 9a2a32b7526f9f350638a4ffc675467de8b08ed9..a98dddce0fade07fe1bc3d2db44f0dc11ec8ab1a 100644 (file)
--- a/playground/router.ts
+++ b/playground/router.ts
@@ -37,6 +37,7 @@ export const router = createRouter({
     },
     { path: '/users/:id', name: 'user', component: User, props: true },
     { path: '/documents/:id', name: 'docs', component: User, props: true },
+    { path: '/optional/:id?', name: 'optional', component: User, props: true },
     { path: encodeURI('/n/€'), name: 'euro', component },
     { path: '/n/:n', name: 'increment', component },
     { path: '/multiple/:a/:b', name: 'multiple', component },