Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Intl.DisplayNames — lokalizirana imena kod

Intl.DisplayNames pretvori kode jezikov, regij in drugih kategorij v prikazna imena glede na področne nastavitve, ki jih izbere izvajalno okolje. Spoznajte obvezno vrsto, obravnavo manjkajočih imen in razliko med vhodno kodo ter področnimi nastavitvami izhoda.

Različica: 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 je del ECMA-402, ne DOM API-ja. Ustvarja imena za uporabniške vmesnike, namesto da bi prevajal poljubno besedilo. V new Intl.DisplayNames("pl", { type: "region" }) oznaka "pl" izraža zahtevo za poljske področne nastavitve. Izvajalno okolje poišče ujemanje med razpoložljivimi področnimi nastavitvami in lahko izbere druge, zato izpis v poljščini ni zagotovljen. Argument .of("US") označuje regijo, katere ime želimo dobiti. Konstruktor zahteva new in možnost type.

type sprejema "language", "region", "script", "currency", "calendar" ali "dateTimeField". style določa dolžino imena: "long" (privzeto), "short" ali "narrow"; te različice se ne razlikujejo nujno. Za "language" možnost languageDisplay izbere "dialect" (privzeto) ali "standard".

.of(code) vrne ime. Če za strukturno veljavno kodo ni na voljo imena, fallback: "code" (privzeto) vrne normalizirano kodo, fallback: "none" pa vrne undefined. Strukturno neveljavna koda sproži RangeError ne glede na fallback; "USA" ni veljavna koda za "region".

resolvedOptions() razkrije dejanske nastavitve, vključno z izbranimi področnimi nastavitvami v lastnosti locale. Natančna imena so odvisna od lokalizacijskih podatkov izvajalnega okolja, zato jih ne obravnavajte kot stabilne identifikatorje. Preverite, ali je Intl.DisplayNames na voljo v ciljnem okolju; njegova prisotnost v Node 24 ne dokazuje podpore v brskalnikih.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri