La propriété en lecture seule NavigatorLanguage.language est une chaîne de caractères qui représente la langue de préférence de l'utilisateur, généralement c'est la langue de l'interface utilisateur de son navigateur.
Syntaxe
lang = globalObj.navigator.language
Valeurs
Une chaîne de caractères représentant la version de la langue qui est définie dans BCP 47. Des exemples de codes de langue valides sont "en", "en-US", "fr", "es-ES", etc.
Il est à noter que dans Safari sur macOS et iOS dans les versions antérieures à 10.2, le code de pays retourné est en minuscules: "en-us", "fr-fr", etc.
Exemples
if (window.navigator.language != "fr") {
selectionnerLangue(window.navigator.language);
}
Spécifications
| Spécification | État | Commentaire |
|---|---|---|
| HTML5 Web application La définition de 'navigator.language' dans cette spécification. |
Recommendation | Définition initiale. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | (Oui)[1] | (Oui) | 1.0 (1.7 ou moins)[2] 5.0 (5.0)[3] |
11.0[4] | (Oui) | (Oui) |
Utilisable pour WorkerNavigator |
? | ? | 35 (35) | ? | ? | ? |
| Fonctionnalité | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | (Oui) | (Oui) | 1.0 (1.0) | Pas de support[4] | (Oui) | (Oui) |
Utilisable pour WorkerNavigator |
? | ? | 35 (35) | Pas de support | ? | ? |
[1] Renvoie la langue utilisée pour l'interface du navigateur, pas la valeur de l'en-tête Accept-Language.
[2] Avant Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), la valeur de cette propriété faisait aussi partie de la chaîne de l'agent utilisateur (user agent) telle que renvoyée par navigator.userAgent.
[3] À partir de Gecko 5.0 (Firefox 5.0 / Thunderbird 5.0 / SeaMonkey 2.2), la valeur de la propriété est basée sur la valeur de l'en-tête Accept-Language.
[4] Les propriétés non-standard les plus proches sont userLanguage et browserLanguage.