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 zurück, dessen Eigenschaften die während der Initialisierung dieses Collator-Objekts berechneten Optionen widerspiegeln.

Probieren Sie es aus

Syntax

js
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 angegebenen Reihenfolge:

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, wenn angefordert und unterstützt, können in der Ausgabe enthalten sein.

usage

Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wird, wobei Standardwerte bei Bedarf ergänzt werden. Er ist entweder "sort" oder "search". Der Standardwert ist "sort".

sensitivity

Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wird, wobei Standardwerte bei Bedarf ergänzt werden. Er ist entweder "base", "accent", "case" oder "variant". Der Standardwert ist "variant" für die Verwendung "sort"; es ist vom Gebietsschema abhängig für die Verwendung "search".

ignorePunctuation

Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wird, wobei Standardwerte bei Bedarf ergänzt werden. Es ist ein boolean. 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 wird, oder unter Verwendung des Unicode-Erweiterungsschlüssels "co", wobei Standardwerte bei Bedarf ergänzt werden. 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 bereitgestellt wird, oder unter Verwendung des Unicode-Erweiterungsschlüssels "kn", wobei Standardwerte bei Bedarf ergänzt werden. Es ist ein boolean. Der Standardwert ist false. Wenn die Implementierung diesen Unicode-Erweiterungsschlüssel nicht unterstützt, wird diese Eigenschaft ausgelassen.

caseFirst

Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wird, oder unter Verwendung des Unicode-Erweiterungsschlüssels "kf", wobei Standardwerte bei Bedarf ergänzt werden. Er ist entweder "upper", "lower" oder "false". Der Standardwert ist "false". Wenn die Implementierung diesen Unicode-Erweiterungsschlüssel nicht unterstützt, wird diese Eigenschaft ausgelassen.

Beispiele

Verwendung der Methode resolvedOptions

js
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 Internationalization API Specification
# sec-intl.collator.prototype.resolvedoptions

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch