CKTIS / JavaScript
Intl.DisplayNames — noms localisés pour les codes
Intl.DisplayNames transforme les codes de langue, de région et d’autres catégories en noms à afficher selon la locale retenue par l’environnement d’exécution. Découvrez le type requis, la gestion des noms manquants et la différence entre le code d’entrée et la locale de sortie.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Intl.DisplayNames(locales, { type, style, fallback, languageDisplay }).of(code)Intl.DisplayNames fait partie d’ECMA-402, et non de l’API DOM. Il produit des noms destinés aux interfaces utilisateur, au lieu de traduire du texte arbitraire. Dans new Intl.DisplayNames("pl", { type: "region" }), "pl" indique que la locale polonaise est souhaitée. L’environnement d’exécution choisit parmi les locales disponibles et peut en retenir une autre : un résultat en polonais n’est donc pas garanti. L’argument de .of("US") désigne la région dont on veut obtenir le nom. Le constructeur exige new et l’option type.
type accepte "language", "region", "script", "currency", "calendar" ou "dateTimeField". style définit la longueur du nom : "long" (par défaut), "short" ou "narrow" ; ces variantes ne sont pas nécessairement différentes. Pour "language", l’option languageDisplay choisit "dialect" (par défaut) ou "standard".
.of(code) renvoie un nom. Si aucun nom n’est disponible pour un code structurellement valide, fallback: "code" (par défaut) renvoie le code normalisé, tandis que fallback: "none" renvoie undefined. Un code structurellement invalide déclenche RangeError, quelle que soit la valeur de fallback ; "USA" n’est pas un code valide pour "region".
resolvedOptions() expose les paramètres effectifs, notamment la locale retenue dans la propriété locale. Les noms exacts dépendent des données de localisation de l’environnement d’exécution ; ne les considérez donc pas comme des identifiants stables. Vérifiez la disponibilité de Intl.DisplayNames dans l’environnement cible : sa présence dans Node 24 ne garantit pas la prise en charge par les navigateurs.
Exemples
const names = new Intl.DisplayNames("en", { type: "region" });
console.log(typeof names.of("US"));
console.log(names.resolvedOptions().type);
try {
names.of("USA");
} catch (error) {
console.log(error.name);
}Résultat
string region RangeError
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.