Intl.Collator.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 September 2017.

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

Probieren Sie es aus

const numberDe = new Intl.NumberFormat("de-DE");
const numberAr = new Intl.NumberFormat("ar");

console.log(numberDe.resolvedOptions().numberingSystem);
// Expected output: "latn"

console.log(numberAr.resolvedOptions().numberingSystem);
// Expected output: "arab"

Syntax

resolvedOptions()

Parameter

Keine.

Rückgabewert

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

locale: Das BCP 47-Sprachtag für das tatsächlich verwendete Gebietsschema, ermittelt durch den Locale-Verhandlungsprozess. Nur die Unicode-Erweiterungsschlüssel co, kn und kf, falls angefordert und unterstützt, können in der Ausgabe enthalten sein.
usage: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit Standardwert bei Bedarf ergänzt. Es ist entweder "sort" oder "search". Der Standardwert ist "sort".
sensitivity: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit Standardwert bei Bedarf ergänzt. Es ist entweder "base", "accent", "case" oder "variant". Der Standardwert ist "variant" für die Verwendung "sort"; es ist lokalabhängig für die Verwendung "search".
ignorePunctuation: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit Standardwert bei Bedarf ergänzt. Es ist ein boolescher Wert. Der Standardwert ist true für Thai (th) und false für alle anderen Sprachen.
collation: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, oder unter Verwendung des Unicode-Erweiterungsschlüssels "co", mit Standardwert bei Bedarf ergänzt. Es ist ein unterstützter Kollationstyp für dieses Gebietsschema. Der Standardwert ist "default".
numeric: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, oder unter Verwendung des Unicode-Erweiterungsschlüssels "kn", mit Standardwert bei Bedarf ergänzt. Es ist ein boolescher Wert. Der Standardwert ist false. Wenn die Implementierung diesen Unicode-Erweiterungsschlüssel nicht unterstützt, wird diese Eigenschaft weggelassen.
caseFirst: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, oder unter Verwendung des Unicode-Erweiterungsschlüssels "kf", mit Standardwert bei Bedarf ergänzt. Es 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

Specification
ECMAScript® 2026 Internationalization API Specification # sec-intl.collator.prototype.resolvedoptions

Browser-Kompatibilität

Siehe auch

Intl.Collator