Skip to content

Router options

Most router functions accept an options argument for configuring the request. The purpose of each of these options is documented here.

url

  • Type: UrlResolvable | () => UrlResolvable

The URL to navigate to. Can be a string, an URL object or a Location object.

method

  • Type: POST, GET, PUT, PATCH or DELETE

HTTP method that will be used for the request. When uploading files, do not use POST but instead add a _method: 'POST' property to the body of the request.

data

  • Type: RequestData

Body of the request. Can be or contain a FormData object.

only

  • Type: string or string[]

Defines the properties that will be included in the response. All other properties except the persistent ones will be excluded.

Read the documentation on partial reloads for more information.

except

  • Type: string or string[]

Defines the properties that will be excluded from the response. Specified persistent properties will also be excluded.

Read the documentation on partial reloads for more information.

preserveState

  • Type: boolean

Defines whether the component should be fully re-rendered, thus preserving its internal state.

preserveUrl

  • Type: boolean

Defines whether the current URL should be preserved. This is an advanced option that should not be used often.

preserveScroll

  • Type: boolean

Defines whether to preserve the position of the document element's and the scroll regions' scrollbars.

Read the documentation on scroll management for more information.

replace

  • Type: boolean

Defines whether to replace the current history state instead of adding an entry. This affects the browser's "back" and "forward" behavior.

hooks

  • Type: Record<HookName, Function>

Defines hooks for the lifecycle of the request. Read the documentation on hooks for more information.

headers

  • Type: Record<string, string>

Defines additionnal headers for the request.

errorBag

  • Type: string

Defines the bag in which validation errors will be put.

useFormData

  • Type: boolean

When set to true, forces the conversion of the data option to a FormData object.

spoof

  • Type: boolean

Automatically spoofs the method when submitting a FormData with the PUT, PATCH or DELETE method.

transformUrl

  • Type: UrlTransformable

Object which properties will affect the provided url. Can also be a callback that returns an UrlTransformable.

progress

= Type: boolean

When set to false, the request will not have a progress bar.