Intl.DisplayNames.prototype.resolvedOptions()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.
Die Methode resolvedOptions() von Intl.DisplayNames-Instanzen gibt ein neues Objekt zurück, dessen Eigenschaften die bei der Initialisierung dieses DisplayNames-Objekts ermittelten Optionen widerspiegeln.
Syntax
resolvedOptions()
Parameter
Keine.
Rückgabewert
Ein neues Objekt mit Eigenschaften, die die anhand der an den Konstruktor Intl.DisplayNames() übergebenen Argumente ermittelten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften in der aufgeführten Reihenfolge:
locale-
Der BCP-47-Sprach-Tag für die tatsächlich verwendete Locale, die durch den Prozess der Locale-Aushandlung bestimmt wurde. Die Ausgabe enthält keinen Unicode-Erweiterungsschlüssel.
style-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, wobei bei Bedarf der Standardwert eingesetzt wird. Der Wert ist entweder"narrow","short"oder"long". Der Standardwert ist"long". type-
Der für diese Eigenschaft im Argument
optionsangegebene Wert. Der Wert ist entweder"language","region","script","currency","calendar"oder"dateTimeField". Die Angabe ist erforderlich; es gibt keinen Standardwert. fallback-
Der für diese Eigenschaft im Argument
optionsangegebene Wert. Der Wert ist entweder"code"oder"none". Der Standardwert ist"code". languageDisplayOptional-
Der für diese Eigenschaft im Argument
optionsangegebene Wert. Die Eigenschaft ist nur vorhanden, wenntypeden Wert"language"hat. Der Wert ist entweder"dialect"oder"standard". Der Standardwert ist"dialect".
Beispiele
>resolvedOptions verwenden
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"
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
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-Intl.DisplayNames.prototype.resolvedOptions> |