CKTIS / JavaScript
Intl.DisplayNames — nomi localizzati per i codici
Intl.DisplayNames converte i codici di lingua, regione e altre categorie in nomi da visualizzare secondo la locale individuata dall’ambiente di esecuzione. Scopri il tipo obbligatorio, come vengono gestiti i nomi mancanti e la differenza tra il codice di input e la locale di output.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new Intl.DisplayNames(locales, { type, style, fallback, languageDisplay }).of(code)Intl.DisplayNames fa parte di ECMA-402, non dell’API DOM. Genera nomi per le interfacce utente, anziché tradurre testo arbitrario. In new Intl.DisplayNames("pl", { type: "region" }), "pl" richiede la locale del polacco. L’ambiente di esecuzione cerca una corrispondenza tra le locale disponibili e può sceglierne un’altra: il risultato in polacco non è quindi garantito. L’argomento di .of("US") identifica la regione di cui si vuole ottenere il nome. Il costruttore richiede new e l’opzione type.
type accetta "language", "region", "script", "currency", "calendar" o "dateTimeField". style seleziona la lunghezza del nome: "long" (predefinito), "short" o "narrow"; queste varianti non devono necessariamente essere diverse. Per "language", l’opzione languageDisplay sceglie "dialect" (predefinito) oppure "standard".
.of(code) restituisce un nome. Se non è disponibile un nome per un codice strutturalmente valido, fallback: "code" (predefinito) restituisce il codice normalizzato, mentre fallback: "none" restituisce undefined. Un codice strutturalmente non valido genera RangeError, indipendentemente da fallback; "USA" non è un codice valido per "region".
resolvedOptions() mostra le impostazioni effettive, compresa la locale selezionata nella proprietà locale. I nomi esatti dipendono dai dati di localizzazione dell’ambiente di esecuzione, quindi non considerarli identificatori stabili. Verifica che Intl.DisplayNames sia disponibile nell’ambiente di destinazione; la sua presenza in Node 24 non dimostra il supporto nei browser.
Esempi
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);
}Risultato
string region RangeError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.