NavigatorLanguage.languages

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 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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
languages
Expérimentale
Chrome Support complet 32
Notes
Support complet 32
Notes
Notes In Chrome, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].
Edge Support complet 12
Notes
Support complet 12
Notes
Notes In Chromium versions of Edge, this returns the browser UI language, not the value of the Accept-Language HTTP header.
Firefox Support complet 32
Notes
Support complet 32
Notes
Notes In Firefox, the navigator.languages property's value is taken from the intl.accept_languages preference.
IE Support complet 11
Notes
Support complet 11
Notes
Notes Closest available (non-standard) properties are userLanguage and browserLanguage.
Opera Support complet 24Safari Support complet 11WebView Android Support complet 4.4.3
Notes
Support complet 4.4.3
Notes
Notes In Chrome, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].
Chrome Android Support complet 32
Notes
Support complet 32
Notes
Notes In Chrome, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].
Firefox Android Support complet 4
Notes
Support complet 4
Notes
Notes In Firefox, the navigator.languages property's value is taken from the intl.accept_languages preference.
Opera Android Support complet 24Safari iOS Support complet OuiSamsung Internet Android Support complet 2.0
Notes
Support complet 2.0
Notes
Notes In Samsung Internet, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].

Légende

Support complet  
Support complet
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Voir aussi