This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The NavigatorLanguage.languages read-only property returns an array of DOMStrings representing the user's preferred languages. The language is described using BCP 47 language tags. In the returned array they are ordered by preference with the most preferred language first.
The value of navigator.language is the first element of the returned array.
When its value changes, as the user's preferred languages are changed a languagechange event is fired on the Window object.
The Accept-Language HTTP header in every HTTP request from the user's browser uses the same value for the navigator.languages property except for the extra qvalues (quality values) field (e.g. en-US;q=0.8).
Syntax
preferredLanguages = globalObj.navigator.languages
Examples
navigator.language //"en-US" navigator.languages //["en-US", "zh-CN", "ja-JP"]
Specifications
| Specification | Status | Comment |
|---|---|---|
| HTML Living Standard The definition of 'NavigatorLanguage: languages' in that specification. |
Living Standard | Initial definition |
Browser compatibility
| Desktop | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Basic support | Chrome
Full support
32
| Edge Full support Yes | Firefox
Full support
32
| IE
Full support
11
| Opera Full support 24 | Safari Full support 11 | WebView Android
Full support
4.4.3
| Chrome Android
Full support
32
| Edge Mobile Full support Yes | Firefox Android
Full support
4
| Opera Android Full support 24 | Safari iOS Full support Yes | Samsung Internet Android ? |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.