Intl.DisplayNames.prototype.resolvedOptions()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Die resolvedOptions()-Methode von Intl.DisplayNames-Instanzen gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung dieses DisplayNames-Objekts berechneten Optionen widerspiegeln.

Syntax

js
resolvedOptions()

Parameter

Keine.

Rückgabewert

Ein neues Objekt mit Eigenschaften, die die während der Initialisierung dieses DisplayNames-Objekts berechneten Optionen widerspiegeln. Das Objekt besitzt die folgenden Eigenschaften in der angegebenen Reihenfolge:

locale

Der BCP 47-Sprachcode für die tatsächlich verwendete Locale, bestimmt durch den Locale-Aushandlungsprozess. Kein Unicode-Erweiterungsschlüssel wird in der Ausgabe enthalten sein.

style

Der in dem options-Argument angegebene Wert für diese Eigenschaft, wobei bei Bedarf eine Standardvorgabe ergänzt wird. Es ist entweder "narrow", "short" oder "long". Der Standardwert ist "long".

type

Der in dem options-Argument angegebene Wert für diese Eigenschaft. Es ist entweder "language", "region", "script", "currency", "calendar" oder "dateTimeField". Es ist erforderlich, daher gibt es keinen Standardwert.

fallback

Der in dem options-Argument angegebene Wert für diese Eigenschaft. Es ist entweder "code" oder "none". Der Standardwert ist "code".

languageDisplay

Der in dem options-Argument angegebene Wert für diese Eigenschaft. Es ist entweder "dialect" oder "standard". Der Standardwert ist "dialect".

Beispiele

Verwendung von resolvedOptions

js
const displayNames = new Intl.DisplayNames(["de-DE"], { type: "region" });

const usedOptions = displayNames.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.style); // "long"
console.log(usedOptions.type); // "region"
console.log(usedOptions.fallback); // "code"
js
const displayNames = new Intl.DisplayNames("en", {
  type: "language",
  languageDisplay: "standard",
});

const usedOptions = displayNames.resolvedOptions();
console.log(usedOptions.type); // "language"
console.log(usedOptions.languageDisplay); // "standard"

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.DisplayNames.prototype.resolvedOptions

Browser-Kompatibilität

Siehe auch