The NavigatorLanguage.language
read-only property returns a string representing the preferred language of the user, usually the language of the browser UI.
SyntaxEdit
lang = globalObj.navigator.language
Values
A
string representing the language version as defined in BCP 47. Examples of valid language codes include "en", "en-US", "fr", "es-ES", etc.
ExampleEdit
if (window.navigator.language != "en") {
doLangSelect(window.navigator.language);
}
SpecificationsEdit
Specification | Status | Comment |
---|---|---|
HTML5.1 The definition of 'NavigatorLanguage.language' in that specification. |
Working Draft | Initial definition |
Browser compatibilityEdit
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes)[1] | 1.0 (1.7 or earlier)[2] 5.0 (5.0)[3] |
11.0[4] | (Yes) | (Yes) |
on WorkerNavigator |
? | 35 (35) | ? | ? | ? |
[1] Returns the browser UI language, not the value of the Accept-Language
HTTP header.
[2] Prior to Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), this property's value was also part of the user agent string, as reported by navigator.userAgent
.
[3] Starting in Gecko 5.0 (Firefox 5.0 / Thunderbird 5.0 / SeaMonkey 2.2), this property's value is based on the value of the Accept-Language
HTTP header.
[4] Closest available (non-standard) properties are userLanguage
and browserLanguage
.