W3cubDocs

/DOM

navigatorLanguage.language

The NavigatorLanguage.language read-only property returns a string representing the preferred language of the user, usually the language of the browser UI.

Syntax

var lang = navigator.language 

Value

A DOMString. lang stores a string representing the language version as defined in BCP 47. Examples of valid language codes include "en", "en-US", "fr", "fr-FR", "es-ES", etc.

Note that in Safari on macOS and iOS prior to 10.2, the country code returned is lowercase: "en-us", "fr-fr" etc.

Example

if (window.navigator.language != 'en') {       
  doLangSelect(window.navigator.language); 
}

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'NavigatorLanguage: language' in that specification.
Living Standard Initial definition

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support Yes
Yes
Returns the browser UI language, not the value of the Accept-Language HTTP header.
Yes 1
1
Prior to Firefox 4 this property's value was also part of the user agent string, as reported by navigator.userAgent.
5
Starting in Firefox 5.0 this property's value is based on the value of the Accept-Language HTTP header.
11
11
Closest available (non-standard) properties are userLanguage and browserLanguage.
Yes Yes
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes
Yes
Returns the browser UI language, not the value of the Accept-Language HTTP header.
Yes
Yes
Returns the browser UI language, not the value of the Accept-Language HTTP header.
Yes 4 Yes Yes ?

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/navigatorLanguage/language