Intl.DisplayNames - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Intl.DisplayNames

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2021.

L'objet Intl.DisplayNames permet la traduction cohérente des noms de langues, de régions et de systèmes d'écriture.

Dans cet article

Exemple interactif

const regionNamesInFrench = new Intl.DisplayNames(["fr"], { type: "region" });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(["zh-Hant"], {
  type: "region",
});

console.log(regionNamesInFrench.of("FR"));
// Résultat attendu : "France"

console.log(regionNamesInTraditionalChinese.of("FR"));
// Résultat attendu : "法國"

Constructeur

Intl.DisplayNames()

Crée un nouvel objet Intl.DisplayNames.

Méthodes statiques

Intl.DisplayNames.supportedLocalesOf()

Retourne un tableau contenant les langues fournies qui sont supportées sans avoir à se rabattre sur la langue locale par défaut au moment de l'exécution.

Propriétés d'instance

Ces propriétés sont définies sur Intl.DisplayNames.prototype et partagées par toutes les instances de Intl.DisplayNames.

Intl.DisplayNames.prototype.constructor

La fonction constructeur qui a créé l'objet instance. Pour les instances de Intl.DisplayNames, la valeur initiale est le constructeur Intl.DisplayNames.

Intl.DisplayNames.prototype[Symbol.toStringTag]

La valeur initiale de la propriété [Symbol.toStringTag] est la chaîne de caractères "Intl.DisplayNames". Cette propriété est utilisée dans Object.prototype.toString().

Méthodes d'instance

Intl.DisplayNames.prototype.of()

Cette méthode reçoit un code et retourne une chaîne de caractères à partir de la langue et des options fournies lors de l'instanciation de Intl.DisplayNames.

Intl.DisplayNames.prototype.resolvedOptions()

Retourne un nouvel objet avec des propriétés reflétant la locale et les options de mise en forme calculées lors de l'initialisation de l'objet.

Exemples

Affichage des noms de régions

Pour créer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant à un code de région dans cette langue.

js
// Obtenir le nom d'une région en anglais
let nomsRegions = new Intl.DisplayNames(["en"], { type: "region" });
nomsRegions.of("419"); // "Latin America"
nomsRegions.of("BZ"); // "Belize"
nomsRegions.of("US"); // "United States"
nomsRegions.of("BA"); // "Bosnia & Herzegovina"
nomsRegions.of("MM"); // "Myanmar (Burma)"

// Obtenir le nom d'une région en chinois traditionnel
nomsRegions = new Intl.DisplayNames(["zh-Hant"], { type: "region" });
nomsRegions.of("419"); // "拉丁美洲"
nomsRegions.of("BZ"); // "貝里斯"
nomsRegions.of("US"); // "美國"
nomsRegions.of("BA"); // "波士尼亞與赫塞哥維納"
nomsRegions.of("MM"); // "緬甸"

Affichage des noms de langues

Pour créer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant à un code de langue (possiblement suivi d'un code de système d'écriture ou de région) dans cette langue.

js
// Obtenir le nom d'une langue en anglais
let nomsLangues = new Intl.DisplayNames(["en"], { type: "language" });
nomsLangues.of("fr"); // "French"
nomsLangues.of("de"); // "German"
nomsLangues.of("fr-CA"); // "Canadian French"
nomsLangues.of("zh-Hant"); // "Traditional Chinese"
nomsLangues.of("en-US"); // "American English"
nomsLangues.of("zh-TW"); // "Chinese (Taiwan)"

// Obtenir le nom d'une langue en chinois traditionnel
nomsLangues = new Intl.DisplayNames(["zh-Hant"], { type: "language" });
nomsLangues.of("fr"); // "法文"
nomsLangues.of("zh"); // "中文"
nomsLangues.of("de"); // "德文"

Affichage des noms de systèmes d'écriture

Pour créer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant à un code de système d'écriture dans cette langue.

js
// Obtenir le nom d'un système d'écriture en anglais
let nomsScript = new Intl.DisplayNames(["en"], { type: "script" });
nomsScript.of("Latn"); // "Latin"
nomsScript.of("Arab"); // "Arabic"
nomsScript.of("Kana"); // "Katakana"

// Obtenir le nom d'un système d'écriture en chinois traditionnel
nomsScript = new Intl.DisplayNames(["zh-Hant"], { type: "script" });
nomsScript.of("Latn"); // "拉丁文"
nomsScript.of("Arab"); // "阿拉伯文"
nomsScript.of("Kana"); // "片假名"

Affichage des noms de devises

Pour créer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant au code d'une devise.

js
// Obtenir le nom d'une devise en anglais
let nomsDevises = new Intl.DisplayNames(["en"], { type: "currency" });
nomsDevises.of("USD"); // "US Dollar"
nomsDevises.of("EUR"); // "Euro"
nomsDevises.of("TWD"); // "New Taiwan Dollar"
nomsDevises.of("CNY"); // "Chinese Yuan"

// Obtenir le nom d'une devise en chinois traditionnel
nomsDevises = new Intl.DisplayNames(["zh-Hant"], { type: "currency" });
nomsDevises.of("USD"); // "美元"
nomsDevises.of("EUR"); // "歐元"
nomsDevises.of("TWD"); // "新台幣"
nomsDevises.of("CNY"); // "人民幣"

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 27 févr. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Intl.DisplayNames
Constructeur
1. Intl.DisplayNames()
Méthodes statiques
1. supportedLocalesOf()
Méthodes d'instance
1. of()
2. resolvedOptions()
Héritage
Object/Function
Méthodes statiques
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Propriétés statiques
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Méthodes d'instance
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor
Pages similaires
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DurationFormat
Intl.ListFormat
Intl.Locale
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter