W3cubDocs

/DOM

navigatorLanguage.languages

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 compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 32
32
In Chrome, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].
Yes 32
32
In Firefox, the navigator.languages property's value is taken from the intl.accept_languages preference.
11
11
Closest available (non-standard) properties are userLanguage and browserLanguage.
24 11
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support 4.4.3
4.4.3
In Chrome, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].
32
32
In Chrome, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].
Yes 4
4
In Firefox, the navigator.languages property's value is taken from the intl.accept_languages preference.
24 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/languages