router.matcher

`router.matcher` is a method in Vue Router that returns a function used to match a given location against the routes defined in the router. It takes a single parameter, which is the location object to be matched.

The returned function has the following signature:

function (location: Location, currentRoute?: Route, redirectedFrom?: Location): Route | undefined

The `location` parameter is the location object to be matched. The `currentRoute` parameter is an optional current route object, which can be used to help with nested routes. The `redirectedFrom` parameter is an optional location object that represents the original location before any redirects were applied.

The function returns a `Route` object if there is a match, or `undefined` if there is no match.

Here is an example of how to use `router.matcher`:

import { createRouter, createWebHistory } from 'vue-router'

const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: '/', component: Home },
    { path: '/about', component: About },
    { path: '/contact', component: Contact }
  ]
})

const location = { path: '/about' }
const matchedRoute = router.matcher(location)

console.log(matchedRoute) // Route { path: '/about', component: About }