NavigatorLanguage.languages

Experimental

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 NavigatorLanguage.languages retourne un tableau de DOMString représentant les langues préférées de l'utilisateur. Les étiquettes de langue utilisent les étiquettes de langages défini par BCP 47. Le tableau retourné est trié par ordre de préférence décroissante (la langue préférée en premier).

La valeur de navigator.language est le premier élément du tableau retourné.

Quant la valeur change, notamment lorsque l'utilisateur modifie ses préférences de langues, un événement languagechange (en-US) est déclenché sur l'objet Window.

L'entête HTTP Accept-Language présent dans chaque requête HTTP issu de la navigation de l'utilisateur contient les mêmes valeurs que navigator.languages, avec en plus un champ qvalues (valeur de qualité), par exemple: en-US;q=0.8.

Syntaxe

preferredLanguages = globalObj.navigator.languages

Exemples

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

Spécifications

Spécifications Status Commentaire
HTML Living Standard
La définition de 'NavigatorLanguage: languages' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi