Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Intl.DisplayNames — lokalizirani nazivi kodova

Intl.DisplayNames pretvara kodove jezika, regija i drugih kategorija u nazive za prikaz prema regionalnim postavkama koje odabere okruženje izvođenja. Saznajte koja je vrsta obavezna, kako se obrađuju nazivi koji nedostaju i koja je razlika između ulaznog koda i regionalnih postavki izlaza.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

new Intl.DisplayNames(locales, { type, style, fallback, languageDisplay }).of(code)

Intl.DisplayNames dio je ECMA-402, a ne DOM API-ja. Stvara nazive za korisnička sučelja umjesto da prevodi proizvoljan tekst. U new Intl.DisplayNames("pl", { type: "region" }) oznaka "pl" traži poljske regionalne postavke. Okruženje izvođenja traži podudaranje među dostupnim regionalnim postavkama i može odabrati druge, pa rezultat na poljskom nije zajamčen. Argument .of("US") označava regiju čiji naziv želimo dobiti. Konstruktor zahtijeva new i opciju type.

type prihvaća "language", "region", "script", "currency", "calendar" ili "dateTimeField". style određuje duljinu naziva: "long" (zadano), "short" ili "narrow"; te se varijante ne moraju razlikovati. Za "language" opcija languageDisplay odabire "dialect" (zadano) ili "standard".

.of(code) vraća naziv. Ako za strukturno valjan kod nije dostupan naziv, fallback: "code" (zadano) vraća normalizirani kod, dok fallback: "none" vraća undefined. Strukturno nevaljan kod uzrokuje RangeError bez obzira na fallback; "USA" nije valjan kod za "region".

resolvedOptions() prikazuje primijenjene postavke, uključujući odabrane regionalne postavke u svojstvu locale. Točni nazivi ovise o lokalizacijskim podacima okruženja izvođenja pa ih nemojte smatrati stabilnim identifikatorima. Provjerite dostupnost Intl.DisplayNames u ciljnom okruženju; njegova prisutnost u Node 24 ne dokazuje podršku u preglednicima.

Primjeri

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);
}

Rezultat

string
region
RangeError

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori