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

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

See also