DasIntl.Collator-Objekt ermöglicht einen sprachsensitiven String-Vergleich.

Probieren Sie es aus

console.log(["Z", "a", "z", "ä"].sort(new Intl.Collator("de").compare));// Expected output: Array ["a", "ä", "z", "Z"]console.log(["Z", "a", "z", "ä"].sort(new Intl.Collator("sv").compare));// Expected output: Array ["a", "z", "Z", "ä"]console.log(  ["Z", "a", "z", "ä"].sort(    new Intl.Collator("de", { caseFirst: "upper" }).compare,  ),);// Expected output: Array ["a", "ä", "Z", "z"]

Konstruktor

Intl.Collator()

Erstellt ein neuesCollator-Objekt.

Statische Methoden

Intl.Collator.supportedLocalesOf()

Gibt ein Array zurück, das diejenigen der bereitgestellten Lokalwerte enthält, die ohne Rückgriff auf die Standardlokale der Laufzeitumgebung unterstützt werden.

Instanzeigenschaften

Diese Eigenschaften sind aufIntl.Collator.prototype definiert und werden von allenIntl.Collator-Instanzen geteilt.

Intl.Collator.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. FürIntl.Collator-Instanzen ist der Anfangswert derIntl.Collator-Konstruktor.

Intl.Collator.prototype[Symbol.toStringTag]

Der anfängliche Wert der[Symbol.toStringTag]-Eigenschaft ist der String"Intl.Collator". Diese Eigenschaft wird inObject.prototype.toString() verwendet.

Instanzmethoden

Intl.Collator.prototype.compare()

Getter-Funktion, die zwei Strings gemäß der Sortierreihenfolge diesesIntl.Collator-Objekts vergleicht.

Intl.Collator.prototype.resolvedOptions()

Gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung des Objekts berechneten Lokale und Kollationsoptionen widerspiegeln.

Beispiele

Verwendung von Collator

Das folgende Beispiel zeigt die unterschiedlichen potenziellen Ergebnisse für einen String, der vor, nach oder auf der gleichen Ebene wie ein anderer auftritt:

console.log(new Intl.Collator().compare("a", "c")); // -1, or some other negative valueconsole.log(new Intl.Collator().compare("c", "a")); // 1, or some other positive valueconsole.log(new Intl.Collator().compare("a", "a")); // 0

Beachten Sie, dass die im obigen Code gezeigten Ergebnisse zwischen Browsern und Browserversionen variieren können. Das liegt daran, dass die Werte implementierungsspezifisch sind. Die Spezifikation verlangt nur, dass die Vorher- und Nachher-Werte negativ bzw. positiv sind.

Verwendung von Lokalwerten

Die vonIntl.Collator.prototype.compare() bereitgestellten Ergebnisse variieren zwischen Sprachen. Um die Sortierreihenfolge der in der Benutzeroberfläche Ihrer Anwendung verwendeten Sprache zu erhalten, geben Sie diese Sprache (und möglicherweise einige Rückfallsprachen) mit demlocales-Argument an:

// in German, ä sorts with aconsole.log(new Intl.Collator("de").compare("ä", "z"));// -1, or some other negative value// in Swedish, ä sorts after zconsole.log(new Intl.Collator("sv").compare("ä", "z"));// 1, or some other positive value

Verwendung von Optionen

Die vonIntl.Collator.prototype.compare() bereitgestellten Ergebnisse können mit demoptions-Argument angepasst werden:

// in German, ä has a as the base letterconsole.log(new Intl.Collator("de", { sensitivity: "base" }).compare("ä", "a"));// 0// in Swedish, ä and a are separate base lettersconsole.log(new Intl.Collator("sv", { sensitivity: "base" }).compare("ä", "a"));// 1, or some other positive value

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Intl
• String.prototype.localeCompare()