Navigator.languages
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.
Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.
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 # dom-navigator-languages-dev |
Compatibilité des navigateurs
Chargement…
Voir aussi
Navigator.languageNavigator- L'évènement
languagechange