Intl.Locale.prototype.language
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 septembre 2020.
La propriété Intl.Locale.prototype.language est une propriété fournie via un accesseur qui renvoie la langue associée à la locale.
Description
La langue est l'une des caractéristiques majeurs d'une locale. La spécification Unicode indique que l'identifiant de la langue d'une locale est composée de l'identifiant canonique de la langue et de l'identifiant de la réponse (on pourra ainsi distinguer l'anglais britannique de l'anglais américain). Toutefois, la propriété language de Locale renvoie uniquement la composante relative à la langue.
Exemples
Indiquer la langue via la chaîne décrivant la locale
Afin de pouvoir représenter une locale Unicode correctement, une chaîne doit commencer par un identifiant de langue. Le principal argument du constructeur Locale doit être un identifiant valide et doit donc contenir la composante liée à la langue.
let langStr = new Intl.Locale("en-Latn-US");
console.log(langStr.language); // Affichera "en" dans la console
Surcharger la langue via l'objet de configuration
Bien que la composante de la langue doive être indiquée dans le premier paramètre, le constructeur Locale prend comme deuxième argument un objet de configuration qui permet de surcharger cette composante.
let langObj = new Intl.Locale("en-Latn-US", { language: "es" });
console.log(langObj.language); // Affichera "es" dans la console
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-Intl.Locale.prototype.language |
Compatibilité des navigateurs
Chargement…