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 |
|---|---|---|
| Unknown La définition de 'navigator.language' dans cette spécification. |
Recommendation | Définition initiale. |
Compatibilité des navigateurs
Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !
| 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.