Skip to content

Complete guide to

Mastering Pinia

written by its creator

API Documentation / RouterOptions

Interface: RouterOptions

Options to initialize a Router instance.

Hierarchy

Properties

end

Optional end: boolean

Should the RegExp match until the end by appending a $ to it.

Default Value

true

Inherited from

PathParserOptions.end


history

history: RouterHistory

History implementation used by the router. Most web applications should use createWebHistory but it requires the server to be properly configured. You can also use a hash based history with createWebHashHistory that does not require any configuration on the server but isn't handled at all by search engines and does poorly on SEO.

Example

js
createRouter({
  history: createWebHistory(),
  // other options...
})

linkActiveClass

Optional linkActiveClass: string

Default class applied to active RouterLink. If none is provided, router-link-active will be applied.


linkExactActiveClass

Optional linkExactActiveClass: string

Default class applied to exact active RouterLink. If none is provided, router-link-exact-active will be applied.


parseQuery

Optional parseQuery: (search: string) => LocationQuery

Type declaration

▸ (search): LocationQuery

Custom implementation to parse a query. See its counterpart, RouterOptions.stringifyQuery.

Parameters
NameType
searchstring
Returns

LocationQuery

Example

Let's say you want to use the qs package to parse queries, you can provide both parseQuery and stringifyQuery:

js
import qs from 'qs'

createRouter({
  // other options...
  parseQuery: qs.parse,
  stringifyQuery: qs.stringify,
})

routes

routes: readonly RouteRecordRaw[]

Initial list of routes that should be added to the router.


scrollBehavior

Optional scrollBehavior: RouterScrollBehavior

Function to control scrolling when navigating between pages. Can return a Promise to delay scrolling. Check ScrollBehavior.

Example

js
function scrollBehavior(to, from, savedPosition) {
  // `to` and `from` are both route locations
  // `savedPosition` can be null if there isn't one
}

sensitive

Optional sensitive: boolean

Makes the RegExp case-sensitive.

Default Value

false

Inherited from

PathParserOptions.sensitive


strict

Optional strict: boolean

Whether to disallow a trailing slash or not.

Default Value

false

Inherited from

PathParserOptions.strict


stringifyQuery

Optional stringifyQuery: (query: LocationQueryRaw) => string

Type declaration

▸ (query): string

Custom implementation to stringify a query object. Should not prepend a leading ?. parseQuery counterpart to handle query parsing.

Parameters
NameType
queryLocationQueryRaw
Returns

string

Released under the MIT License.