Nuxt module to dynamically redirect initial requests
npm install @nuxtjs/redirect-module[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![Circle CI][circle-ci-src]][circle-ci-href]
[![Codecov][codecov-src]][codecov-href]
[![Dependencies][david-dm-src]][david-dm-href]
[![Standard JS][standard-js-src]][standard-js-href]
> Nuxt module to dynamically redirect initial requests
Redirecting URLs is an often discussed topic, especially when it comes to
SEO. Previously it was hard to create a "real" redirect without performance
loss or incorrect handling. But this time is over!
1. Add the @nuxtjs/redirect-module dependency with yarn or npm to your project
2. Add @nuxtjs/redirect-module to the modules section of nuxt.config.js:
3. Configure it:
``js`
{
modules: [
['@nuxtjs/redirect-module', {
// Redirect option here
}]
]
}
`js`
{
modules: [
'@nuxtjs/redirect-module'
],
redirect: [
// Redirect options here
]
}
- Default: []
Rules of your redirects.
- Default: (req, res, next) => decodeURI(req.url)
You can set decode.
- Default: (error, req, res, next) => next(error)
You can set callback when there is an error in the decode.
- Default: 302
You can set the default statusCode which gets used when no statusCode is defined on the rule itself.
Simply add the links you want to redirect as objects to the module option array:
`js`
redirect: [
{ from: '^/myoldurl', to: '/mynewurl' }
]
You can set up a custom status code as well. By default, it's 302!
`js`
redirect: [
{ from: '^/myoldurl', to: '/mynewurl', statusCode: 301 }
]
As you may have already noticed, we are leveraging the benefits of
Regular Expressions. Hence, you can fully customize your redirects.
`js`
redirect: [
{ from: '^/myoldurl/(.*)$', to: '/comeallhere' }, // Many urls to one
{ from: '^/anotherold/(.*)$', to: '/new/$1' } // One to one mapping
]
Furthermore you can use a function to create your to url as well :+1:from
The rule and the req of the middleware will be provided as arguments.
The function can also be async!
`js/posts/${param}
redirect: [
{
from: '^/someUrlHere/(.*)$',
to: (from, req) => {
const param = req.url.match(/functionAsync\/(.*)$/)[1]
return
}
}
]
And if you really need more power... okay! You can also use a factory function
to generate your redirects:
`js`
redirect: async () => {
const someThings = await axios.get("/myApi") // It'll wait!
return someThings.map(coolTransformFunction)
}
Now, if you want to customize your redirects, how your decode is done
or when there is some error in the decode, you can also:
`js`
redirect: {
rules: [
{ from: '^/myoldurl', to: '/mynewurl' }
],
onDecode: (req, res, next) => decodeURI(req.url),
onDecodeError: (error, req, res, next) => next(error)
}
ATTENTION: The factory function must return an array with redirect
objects (as seen above).
The redirect module will not work in combination with nuxt generate.
Redirects are realized through a server middleware, which can only react when there is a server running.
1. Clone this repository
2. Install dependencies using yarn install or npm install
3. Start development server using
Copyright (c) Alexander Lichter
[npm-version-src]: https://img.shields.io/npm/dt/@nuxtjs/redirect-module.svg?style=flat-square
[npm-version-href]: https://npmjs.com/package/@nuxtjs/redirect-module
[npm-downloads-src]: https://img.shields.io/npm/v/@nuxtjs/redirect-module/latest.svg?style=flat-square
[npm-downloads-href]: https://npmjs.com/package/@nuxtjs/redirect-module
[circle-ci-src]: https://img.shields.io/circleci/project/github/nuxt-community/redirect-module.svg?style=flat-square
[circle-ci-href]: https://circleci.com/gh/nuxt-community/redirect-module
[codecov-src]: https://img.shields.io/codecov/c/github/nuxt-community/redirect-module.svg?style=flat-square
[codecov-href]: https://codecov.io/gh/nuxt-community/redirect-module
[david-dm-src]: https://david-dm.org/nuxt-community/redirect-module/status.svg?style=flat-square
[david-dm-href]: https://david-dm.org/nuxt-community/redirect-module
[standard-js-src]: https://img.shields.io/badge/code_style-standard-brightgreen.svg?style=flat-square
[standard-js-href]: https://standardjs.com