CKTIS / JavaScript
Intl.DisplayNames — zlokalizowane nazwy kodów
Intl.DisplayNames zamienia kody języków, regionów i innych kategorii na nazwy do wyświetlenia zgodnie z ustawieniami regionalnymi dobranymi przez środowisko wykonawcze. Poznaj wymagany typ, obsługę brakujących nazw i różnicę między kodem a ustawieniami regionalnymi wyniku.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new Intl.DisplayNames(locales, { type, style, fallback, languageDisplay }).of(code)Intl.DisplayNames jest częścią ECMA-402, a nie API DOM. Tworzy nazwy do interfejsów użytkownika, nie tłumaczy dowolnego tekstu. W new Intl.DisplayNames("pl", { type: "region" }) tag "pl" wskazuje preferowane ustawienia regionalne. Środowisko wykonawcze dobiera ustawienia spośród dostępnych, więc podanie "pl" nie gwarantuje nazw po polsku. Argument .of("US") wskazuje region, którego nazwę chcemy uzyskać. Konstruktor wymaga new oraz opcji type.
type przyjmuje "language", "region", "script", "currency", "calendar" lub "dateTimeField". style określa długość nazwy: "long" (domyślnie), "short" albo "narrow"; warianty nie muszą się różnić. Dla "language" opcja languageDisplay wybiera "dialect" (domyślnie) albo "standard".
.of(code) zwraca nazwę. Gdy poprawny strukturalnie kod nie ma nazwy, fallback: "code" (domyślnie) zwraca kod po normalizacji, a fallback: "none" zwraca undefined. Niepoprawny strukturalnie kod powoduje RangeError niezależnie od fallback; "USA" nie jest poprawnym kodem dla "region".
resolvedOptions() ujawnia zastosowane ustawienia, w tym dobrane ustawienia regionalne w polu locale. Dokładne nazwy zależą od danych lokalizacyjnych środowiska, więc nie traktuj ich jako stabilnych identyfikatorów. Sprawdzaj dostępność Intl.DisplayNames w docelowym środowisku; obecność w Node 24 nie dowodzi obsługi w przeglądarce.
Przykłady
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);
}Wynik
string region RangeError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.