https://github.com/kchapelier/in-browser-language
Get the language of the browser
https://github.com/kchapelier/in-browser-language
Last synced: about 2 months ago
JSON representation
Get the language of the browser
- Host: GitHub
- URL: https://github.com/kchapelier/in-browser-language
- Owner: kchapelier
- License: mit
- Created: 2015-01-02T15:43:13.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2019-07-26T06:28:32.000Z (about 6 years ago)
- Last Synced: 2025-08-09T08:37:48.659Z (about 2 months ago)
- Language: JavaScript
- Size: 4.88 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# in-browser-language
This module is designed to be used with browserify or other CJS bundlers.
```npm i in-browser-language --save```
## How it works
The module checks for (in order) :
* `window.navigator.languages`
* `window.navigator.language`
* `window.clientInformation.userLanguage`
* `window.clientInformation.browserLanguage`
* `window.clientInformation.systemLanguage`
Some systems / browser may actually return the language of the OS instead of the language of the browser.
There is no way around this issue but it can be mitigated by allowing the user to change its language.
## Methods
**list()**
Return an array containing the languages.
**first()**
Return the first language of the list.
**pick(proposedLanguages, defaultLanguage)**
Pick the first language found both in the `proposedLanguages` array and the list of languages supported by the browser.
If there are no matches, the defaultLanguage is returned.
```js
var browserLanguage = require('in-browser-language');
console.log(browserLanguage.list());
// returns ['fr', 'en']
console.log(browserLanguage.first());
// returns 'fr'
console.log(browserLanguage.pick(['pl', 'ja', 'en', 'fr']));
// returns 'fr' as 'fr' is the first declared by the browser
console.log(browserLanguage.pick(['pl', 'ja'], 'pl'));
// returns 'pl' as there are no matches
console.log(browserLanguage.pick(['pl', 'ja']));
// returns null as there are no matches and no defaultLanguage
```
## History
### 1.0.3 (2018-09-18)
* Remove `uniq` dependency.