Intl.DisplayNames.prototype.of()
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 avril 2021.
La méthode Intl.DisplayNames.prototype.of() prend comme argument un code et renvoie une chaîne de caractères selon les options et la locale fournies lors de l'instanciation de l'objet Intl.DisplayNames.
Exemple interactif
const regionNamesInEnglish = new Intl.DisplayNames(['en'], { type: 'region' });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(['zh-Hant'], {
type: 'region',
});
console.log(regionNamesInEnglish.of('US'));
// Expected output: "United States"
console.log(regionNamesInTraditionalChinese.of('US'));
// Expected output: "美國"
Syntaxe
js
of(code);
Paramètres
code-
La valeur du
codeà fournir dépend dutype:- Si le type est
"region", le code sera un code de région ISO-3166 sur deux lettres, ou un code de région géographique sur trois chiffres UN M49. - Si le type est
"script", le code sera un code de script ISO-15924 sur quatre lettres. - Si le type est
"language", le code sera de la forme d'une sous-séquence languageCode ["-"scriptCode] ["-" regionCode ] ("-" variant ) de la grammaire unicode_language_id pour la grammaire des identifiants de locales et de langues Unicode UTS 35. languageCode est soit un code de langue ISO 639-1 sur deux lettres ou un code de langue ISO 639-2 sur trois lettres. - Si le type est
"currency", le code sera un code à 3 lettres ISO 4217.
- Si le type est
Valeur de retour
Une chaîne de caractères formatée spécifique à une locale.
Exemples
Utilisation de la méthode of()
js
let regionNames = new Intl.DisplayNames(["en"], { type: "region" });
regionNames.of("419"); // "Latin America"
let languageNames = new Intl.DisplayNames(["en"], { type: "language" });
languageNames.of("fr"); // "French"
let currencyNames = new Intl.DisplayNames(["en"], { type: "currency" });
currencyNames.of("EUR"); // "Euro"
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-Intl.DisplayNames.prototype.of |
Compatibilité des navigateurs
Chargement…