CKTIS / JavaScript
Intl.DisplayNames — lokalisierte Namen für Codes
Intl.DisplayNames wandelt Codes für Sprachen, Regionen und andere Kategorien in Anzeigenamen für die von der Laufzeitumgebung ermittelte Locale um. Erfahre, welcher Typ erforderlich ist, wie fehlende Namen behandelt werden und worin sich Eingabecode und Ausgabe-Locale unterscheiden.
Version: 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 gehört zu ECMA-402 und nicht zur DOM-API. Es erzeugt Namen für Benutzeroberflächen, statt beliebige Texte zu übersetzen. In new Intl.DisplayNames("pl", { type: "region" }) fordert "pl" die polnische Locale an. Die Laufzeitumgebung gleicht die Anfrage mit ihren verfügbaren Locales ab und kann eine andere Locale verwenden. Polnische Ausgaben sind daher nicht garantiert. Das Argument von .of("US") bezeichnet die Region, deren Name gesucht wird. Der Konstruktor erfordert new und die Option type.
type akzeptiert "language", "region", "script", "currency", "calendar" oder "dateTimeField". style legt die Namenslänge fest: "long" (Standard), "short" oder "narrow"; diese Varianten müssen sich nicht unterscheiden. Für "language" wählt die Option languageDisplay entweder "dialect" (Standard) oder "standard".
.of(code) gibt einen Namen zurück. Gibt es für einen strukturell gültigen Code keinen verfügbaren Namen, liefert fallback: "code" (Standard) den normalisierten Code zurück, während fallback: "none" undefined zurückgibt. Ein strukturell ungültiger Code löst unabhängig von fallback einen RangeError aus; "USA" ist kein gültiger Code für "region".
resolvedOptions() zeigt die wirksamen Einstellungen, darunter die ermittelte Locale in der Eigenschaft locale. Die genauen Namen hängen von den Locale-Daten der Laufzeitumgebung ab und sollten daher nicht als stabile Bezeichner behandelt werden. Prüfe, ob Intl.DisplayNames in der Zielumgebung verfügbar ist; seine Verfügbarkeit in Node 24 belegt keine Browserunterstützung.
Beispiele
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);
}Ergebnis
string region RangeError
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.