Koa middleware to pick locale from an array of supported locales
MIT License
Koa middleware to pick locale from an array of supported locales.
Install:
npm i koa-pick-locale
When using this middleware, you need to provide an array of locales to pick from. Later in the middleware stack, you can retrieve the chosen locale
via ctx.locale
The middleware will by default look at the accept-language
header to see if it can satisfy the pick
array, if not it will fall back to the default
locale. If you do not provide the default
locale, the default will be en
.
import {pickLocale} from 'koa-pick-locale'
const app = new Koa()
app.use(pickLocale({default:'fr',pick:['sr','de','en`]}))
// later in the middleware stack
ctx.locale = 'sr'
You can provide an array of custom headers to search through.
app.use(pickLocale({default:'fr',pick:['sr','de','en`],
headers:['x-custom-locale','accept-language','x-custom-lang']
}))
middleware will look through all the headers and the first one that satisfies the pick
value, that value will be returned, otherwise, the default
value will be returned.
Middleware can also look through the cookies to pick the locale. The process is the same as for the headers array.
app.use(pickLocale({default:'fr',pick:['sr','de','en`],
cookies:['my-cookie','locale-cookie']
}))
You can also use both cookies
and headers
thogether. By default, the headers
array will be searched first, but this can be changed.
app.use(pickLocale({default:'fr',pick:['sr','de','en`],
cookies:['my-cookie','locale-cookie'],
headers:['x-custom-locale','accept-language','x-custom-lang'],
order:'headersFirst' // default order: headers first
}))
If you want cookies to be searched first, use: order:'cookiesFirst
.
You can switch on debugging by providing the environment variable: DEBUG=koa-pick-locale
This project is licensed under the MIT License - see the LICENSE file for details