Intl.Collator

Intl.Collator()

Erstellt ein neues Collator-Objekt.

Intl.Collator.supportedLocalesOf()

Gibt ein Array zurück, das diejenigen der angegebenen Locale enthält, die unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.

Diese Eigenschaften sind auf Intl.Collator.prototype definiert und werden von allen Intl.Collator-Instanzen geteilt.

Intl.Collator.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für Intl.Collator-Instanzen ist der anfängliche Wert der Intl.Collator-Konstruktor.

Intl.Collator.prototype[Symbol.toStringTag]

Der Anfangswert der [Symbol.toStringTag]-Eigenschaft ist der String "Intl.Collator". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Intl.Collator.prototype.compare()

Getter-Funktion, die zwei Zeichenfolgen gemäß der Sortierreihenfolge dieses Intl.Collator-Objekts vergleicht.

Intl.Collator.prototype.resolvedOptions()

Gibt ein neues Objekt mit Eigenschaften zurück, die die Locale- und Kollationsoptionen widerspiegeln, die während der Initialisierung des Objekts berechnet wurden.

Das folgende Beispiel zeigt die unterschiedlichen möglichen Ergebnisse für eine Zeichenfolge, die vor, nach oder auf dem gleichen Niveau wie eine andere auftritt:

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

Beachten Sie, dass die in diesem Beispielcode gezeigten Ergebnisse zwischen Browsern und Browserversionen variieren können. Dies liegt daran, dass die Werte implementierungsspezifisch sind. Die Spezifikation verlangt nur, dass die Vorher- und Nachher-Werte negativ bzw. positiv sind.

Die von Intl.Collator.prototype.compare() bereitgestellten Ergebnisse variieren zwischen Sprachen. Um die Sortierreihenfolge der Sprache zu erhalten, die in der Benutzeroberfläche Ihrer Anwendung verwendet wird, stellen Sie sicher, dass Sie diese Sprache (und möglicherweise einige Ersatzsprachen) mit dem locales-Argument angeben:

// in German, ä sorts with a
console.log(new Intl.Collator("de").compare("ä", "z"));
// -1, or some other negative value

// in Swedish, ä sorts after z
console.log(new Intl.Collator("sv").compare("ä", "z"));
// 1, or some other positive value

Die von Intl.Collator.prototype.compare() bereitgestellten Ergebnisse können mit dem options-Argument angepasst werden:

// in German, ä has a as the base letter
console.log(new Intl.Collator("de", { sensitivity: "base" }).compare("ä", "a"));
// 0

// in Swedish, ä and a are separate base letters
console.log(new Intl.Collator("sv", { sensitivity: "base" }).compare("ä", "a"));
// 1, or some other positive value

• Intl
• String.prototype.localeCompare()