Navigator.languages

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/fr/web/api/html_dom_api/index.md)

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La propriété en lecture seule Navigator.languages renvoie un tableau de chaînes de caractères DOMString qui représente les langues préférées de l'utilisatrice ou de l'utilisateur. Les langues sont représentées au format défini par la RFC 5646, aussi connu sous le nom de balise BCP 47. Les éléments du tableau sont triés par ordre de préférence, la langue préférée étant située en première.

La valeur de navigator.language correspond au premier élément du tableau.

Lorsque les langues préférées sont modifiées, la valeur de cette propriété change et un évènement languagechange est déclenché sur l'objet Window.

Pour chaque requête HTTP du navigateur, l'en-tête HTTP Accept-Language utilise la même valeur que navigator.languages si on omet les champs de valeurs de qualité (qvalues) (par exemple en-US;q=0.8).

Valeur

Un tableau de chaînes de caractères.

Exemples

js
navigator.language; // "en-US"
navigator.languages; // ["en-US", "zh-CN", "ja-JP"]

Spécifications

Specification
HTML Standard
# dom-navigator-languages-dev

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi