Navigator: languages property
The Navigator.languages
read-only property
returns an array of strings representing the user's preferred
languages. The language is described using language tags according to
RFC 5646: Tags for Identifying Languages (also known as BCP 47). 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
).
Value
A string.
Examples
js
navigator.language; //"en-US"
navigator.languages; //["en-US", "zh-CN", "ja-JP"]
Specifications
Specification |
---|
HTML Standard # dom-navigator-languages-dev |
Browser compatibility
BCD tables only load in the browser