browser-lang
Detect user's most preferred language within the given language list.
Why?
- To determine an
initial display language
ordefault language router
on your application with fallback options.
Inspiration
- I made
en
andko
router to support i18n. How do I detect user's preferred language in browser? - My app only supports
en
andko
for now. What language should I display whenzh
users visit us? - I added
fr
router. But, how do I handlefr_FR
andfr_CA
users as well?
Installation
npm install browser-lang --save
or
yarn add browser-lang
Options
-
languages: language code list that is available on your application.
-
fallback: default language when user's preferred language is not on the list.
Example
in javascript project
// const browserLang = require('browser-lang');
import browserLang from 'browser-lang';
const myLanguage = browserLang();
// return the preferred language in browser: e.g. "ko-KR" or "ko".
const myLanguage = browserLang({
languages: ['ko', 'de', 'zh', 'zh_TW', 'en'],
fallback: 'en',
});
// return "ko" if the preferred language in browser is set to "ko-KR" or "ko".
// return "en" as a fallback if the preferred language in browser is "fr".
// return 'zh' if the preferred language in browser is set to "zh_HK".
Browser support
- Chrome
- Firefox
- Safari
- IE
- Edge
- Opera
License
MIT © Daewoong Moon