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
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
Navigator.language
Navigator
- L'évènement
languagechange