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

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 folgende Eigenschaften, in der Reihenfolge, in der sie aufgelistet sind:

locale

Das BCP 47 Sprach-Tag für die tatsächlich verwendete Sprache, bestimmt durch den Sprachen-Aushandlungsprozess. Nur die Unicode-Erweiterungsschlüssel co, kn und kf, wenn angefordert und unterstützt, können in der Ausgabe enthalten sein.

usage

Der in dem options-Argument angegebene Wert, mit standardmäßiger Auffüllung, falls notwendig. Er ist entweder "sort" oder "search". Der Standardwert ist "sort".

sensitivity

Der in dem options-Argument angegebene Wert, mit standardmäßiger Auffüllung, falls notwendig. Er ist entweder "base", "accent", "case" oder "variant". Der Standardwert ist "variant" für die Verwendung "sort"; es ist von der Sprache abhängig für die Verwendung "search".

ignorePunctuation

Der in dem options-Argument angegebene Wert, mit standardmäßiger Auffüllung, falls notwendig. Es ist ein boolean. Der Standardwert ist true für Thai (th) und false für alle anderen Sprachen.

collation

Der in dem options-Argument angegebene Wert oder mit dem Unicode-Erweiterungsschlüssel "co", mit standardmäßiger Auffüllung, falls notwendig. Es ist ein unterstützter Kollationstyp für diese Sprache. Der Standardwert ist "default".

numeric

Der in dem options-Argument angegebene Wert oder mit dem Unicode-Erweiterungsschlüssel "kn", mit standardmäßiger Auffüllung, falls notwendig. Es ist ein boolean. Der Standardwert ist false. Wenn die Implementierung diesen Unicode-Erweiterungsschlüssel nicht unterstützt, wird diese Eigenschaft ausgelassen.

caseFirst

Der in dem options-Argument angegebene Wert oder mit dem Unicode-Erweiterungsschlüssel "kf", mit standardmäßiger Auffüllung, falls notwendig. Es 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