Intl.Collator.prototype.resolvedOptions()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die Methode resolvedOptions() von Intl.Collator-Instanzen gibt ein neues Objekt zurück, dessen Eigenschaften die bei der Initialisierung dieses Collator-Objekts ermittelten Optionen widerspiegeln.
Probieren Sie es aus
const collator = new Intl.Collator("de-DE", { sensitivity: "base" });
const options = collator.resolvedOptions();
console.log(options.sensitivity);
// Expected output: "base"
console.log(options.usage);
// Expected output: "sort"
Syntax
resolvedOptions()
Parameter
Keine.
Rückgabewert
Ein neues Objekt mit Eigenschaften, die die anhand der an den Konstruktor Intl.Collator() ü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 kann nur die Unicode-Erweiterungsschlüssel
co,knundkfenthalten, sofern diese angefordert wurden und unterstützt werden. usage-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"sort"oder"search". Der Standardwert ist"sort". sensitivity-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"base","accent","case"oder"variant". Beiusage"sort"ist der Standardwert"variant"; beiusage"search"hängt er von der Locale ab. ignorePunctuation-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist ein boolescher Wert. Für Thai (th) ist der Standardwerttrue, für alle anderen Sprachenfalse. collation-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"co"angegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist ein für diese Locale unterstützter Kollationstyp. Der Standardwert ist"default". numeric-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"kn"angegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist ein boolescher Wert. Der Standardwert istfalse. Wenn die Implementierung diesen Unicode-Erweiterungsschlüssel nicht unterstützt, wird diese Eigenschaft weggelassen. caseFirst-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"kf"angegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"upper","lower"oder"false". Der Standardwert ist"false". Wenn die Implementierung diesen Unicode-Erweiterungsschlüssel nicht unterstützt, wird diese Eigenschaft weggelassen.
Beispiele
>Verwendung der Methode resolvedOptions
const de = new Intl.Collator("de", { sensitivity: "base" });
const usedOptions = de.resolvedOptions();
usedOptions.locale; // "de"
usedOptions.usage; // "sort"
usedOptions.sensitivity; // "base"
usedOptions.ignorePunctuation; // false
usedOptions.collation; // "default"
usedOptions.numeric; // false
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-intl.collator.prototype.resolvedoptions> |