Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Intl.DisplayNames — lokalizované názvy kódů

Intl.DisplayNames převádí kódy jazyků, regionů a dalších kategorií na zobrazované názvy podle národního prostředí zvoleného běhovým prostředím. Seznamte se s povinným typem, zpracováním chybějících názvů a rozdílem mezi vstupním kódem a národním prostředím výstupu.

Verze: 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 patří do ECMA-402, nikoli do DOM API. Vytváří názvy pro uživatelská rozhraní, místo aby překládalo libovolný text. V new Intl.DisplayNames("pl", { type: "region" }) označuje "pl" požadované polské národní prostředí. Běhové prostředí hledá shodu mezi dostupnými národními prostředími a může zvolit jiné, takže výstup v polštině není zaručen. Argument .of("US") označuje region, jehož název chceme získat. Konstruktor vyžaduje new a volbu type.

type přijímá "language", "region", "script", "currency", "calendar" nebo "dateTimeField". style určuje délku názvu: "long" (výchozí), "short" nebo "narrow"; tyto varianty se nemusí lišit. Pro "language" volba languageDisplay vybírá "dialect" (výchozí) nebo "standard".

.of(code) vrací název. Pokud pro strukturálně platný kód není dostupný žádný název, fallback: "code" (výchozí) vrátí normalizovaný kód, zatímco fallback: "none" vrátí undefined. Strukturálně neplatný kód vyvolá RangeError bez ohledu na fallback; "USA" není platný kód pro "region".

resolvedOptions() zpřístupňuje použitá nastavení včetně zvoleného národního prostředí ve vlastnosti locale. Přesné názvy závisí na lokalizačních datech běhového prostředí, proto je nepovažujte za stabilní identifikátory. Ověřte dostupnost Intl.DisplayNames v cílovém prostředí; jeho přítomnost v Node 24 nedokládá podporu v prohlížečích.

Pří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ýsledek

string
region
RangeError

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje