CKTIS / JavaScript
Intl.DisplayNames — lokalizované názvy kódov
Intl.DisplayNames prevádza kódy jazykov, regiónov a ďalších kategórií na zobrazované názvy podľa miestnych nastavení vybraných prostredím vykonávania. Zistite, aký typ je povinný, ako sa spracúvajú chýbajúce názvy a aký je rozdiel medzi vstupným kódom a miestnymi nastaveniami výstupu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Intl.DisplayNames(locales, { type, style, fallback, languageDisplay }).of(code)Intl.DisplayNames patrí do ECMA-402, nie do DOM API. Vytvára názvy pre používateľské rozhrania, namiesto prekladania ľubovoľného textu. V new Intl.DisplayNames("pl", { type: "region" }) označuje "pl" požadované poľské miestne nastavenia. Prostredie vykonávania hľadá zhodu medzi dostupnými miestnymi nastaveniami a môže vybrať iné, takže výstup v poľštine nie je zaručený. Argument .of("US") označuje región, ktorého názov chceme získať. Konštruktor vyžaduje new a možnosť type.
type prijíma "language", "region", "script", "currency", "calendar" alebo "dateTimeField". style určuje dĺžku názvu: "long" (predvolené), "short" alebo "narrow"; tieto varianty sa nemusia líšiť. Pre "language" možnosť languageDisplay vyberá "dialect" (predvolené) alebo "standard".
.of(code) vracia názov. Ak pre štrukturálne platný kód nie je dostupný názov, fallback: "code" (predvolené) vráti normalizovaný kód, zatiaľ čo fallback: "none" vráti undefined. Štrukturálne neplatný kód vyvolá RangeError bez ohľadu na fallback; "USA" nie je platný kód pre "region".
resolvedOptions() sprístupňuje použité nastavenia vrátane vybraných miestnych nastavení vo vlastnosti locale. Presné názvy závisia od lokalizačných údajov runtime, preto ich nepovažujte za stabilné identifikátory. Overte dostupnosť Intl.DisplayNames v cieľovom prostredí; jeho prítomnosť v Node 24 nedokazuje podporu v prehliadačoch.
Príklady
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);
}Výsledok
string region RangeError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.