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 Optionen widerspiegeln, die während der Initialisierung dieses DisplayNames-Objekts berechnet wurden.

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 hat die folgenden Eigenschaften, in der Reihenfolge, wie sie aufgelistet sind:

locale

Der BCP 47-Sprachcode für das tatsächlich verwendete Gebietsschema, bestimmt durch den locale negotiation-Prozess. Kein Unicode-Erweiterungsschlüssel wird in die Ausgabe aufgenommen.

style

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit Standards, die bei Bedarf ausgefüllt wurden. Es ist entweder "narrow", "short" oder "long". Der Standard ist "long".

type

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde. Es ist entweder "language", "region", "script", "currency", "calendar" oder "dateTimeField". Es ist erforderlich, daher gibt es keinen Standard.

fallback

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde. Es ist entweder "code" oder "none". Der Standard ist "code".

languageDisplay

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde. Es ist entweder "dialect" oder "standard". Der Standard ist "dialect".

Beispiele

Verwenden 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® 2025 Internationalization API Specification
# sec-Intl.DisplayNames.prototype.resolvedOptions

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
resolvedOptions

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch