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 mit Eigenschaften zurück, die die bei der Initialisierung dieses DisplayNames-Objekts ermittelten Optionen widerspiegeln.
Syntax
resolvedOptions()
Parameter
Keine.
Rückgabewert
Ein neues Objekt mit Eigenschaften, die die bei der Initialisierung dieses DisplayNames-Objekts ermittelten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften in der aufgeführten Reihenfolge:
locale-
Das 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, gegebenenfalls ergänzt um den Standardwert. 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. Diese 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> |