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 resolvedOptions()-Methode 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 Reihenfolge, in der sie aufgeführt sind:

locale: Der BCP 47-Sprachcode für das tatsächlich verwendete Gebietsschema, bestimmt durch den Sprachverhandlungsprozess. 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 bereitgestellt wurde, wobei der Standardwert bei Bedarf ausgefüllt wird. Es ist entweder "sort" oder "search". Der Standardwert ist "sort".
sensitivity: Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wurde, wobei der Standardwert bei Bedarf ausgefüllt wird. Es ist entweder "base", "accent", "case" oder "variant". Der Standardwert ist "variant" für "sort"; es ist für "search" gebietsabhängig.
ignorePunctuation: Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wurde, wobei der Standardwert bei Bedarf ausgefüllt wird. 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 bereitgestellt oder mithilfe des Unicode-Erweiterungsschlüssels "co" festgelegt wurde, wobei der Standardwert bei Bedarf ausgefüllt wird. Es ist ein unterstützter Sortiertyp für dieses Gebietsschema. Der Standardwert ist "default".
numeric: Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt oder mithilfe des Unicode-Erweiterungsschlüssels "kn" festgelegt wurde, wobei der Standardwert bei Bedarf ausgefüllt wird. 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 bereitgestellt oder mithilfe des Unicode-Erweiterungsschlüssels "kf" festgelegt wurde, wobei der Standardwert bei Bedarf ausgefüllt wird. 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