KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.DisplayNames — gelokaliseerde namen voor codes

Intl.DisplayNames zet codes voor talen, regio’s en andere categorieën om in weergavenamen volgens de locale die de runtime kiest. Lees welk type vereist is, hoe ontbrekende namen worden afgehandeld en wat het verschil is tussen de invoercode en de locale voor de uitvoer.

Versie: 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 hoort bij ECMA-402 en niet bij de DOM API. Het maakt namen voor gebruikersinterfaces, in plaats van willekeurige tekst te vertalen. In new Intl.DisplayNames("pl", { type: "region" }) vraag je met "pl" om de Poolse locale. De runtime zoekt een overeenkomst tussen de beschikbare locales en kan een andere locale kiezen. Uitvoer in het Pools is dus niet gegarandeerd. Het argument van .of("US") geeft aan van welke regio je de naam wilt krijgen. De constructor vereist new en de optie type.

type accepteert "language", "region", "script", "currency", "calendar" of "dateTimeField". style bepaalt de lengte van de naam: "long" (standaard), "short" of "narrow"; deze varianten hoeven niet van elkaar te verschillen. Voor "language" kiest de optie languageDisplay "dialect" (standaard) of "standard".

.of(code) geeft een naam terug. Als er geen naam beschikbaar is voor een structureel geldige code, geeft fallback: "code" (standaard) de genormaliseerde code terug, terwijl fallback: "none" undefined teruggeeft. Een structureel ongeldige code veroorzaakt RangeError, ongeacht fallback; "USA" is geen geldige code voor "region".

resolvedOptions() toont de effectieve instellingen, waaronder de gekozen locale in de eigenschap locale. De precieze namen hangen af van de localegegevens van de runtime en moeten daarom niet als stabiele identificatiecodes worden behandeld. Controleer of Intl.DisplayNames beschikbaar is in de doelomgeving; de aanwezigheid ervan in Node 24 bewijst geen ondersteuning in browsers.

Voorbeelden

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

Resultaat

string
region
RangeError

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen