Experimental
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 DOMString
s 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
BCD tables only load in the browser