Intl.Collator

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.

Das Intl.Collator-Objekt ermöglicht sprachabhängige Zeichenfolgenvergleiche.

Probieren Sie es aus

Konstruktor

Intl.Collator()

Erstellt ein neues Collator-Objekt.

Statische Methoden

Intl.Collator.supportedLocalesOf()

Gibt ein Array zurück, das diejenigen der bereitgestellten Locales enthält, die unterstützt werden, ohne auf die Standardsprache des Laufzeitsystems zurückgreifen zu müssen.

Instanz-Eigenschaften

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 Anfangswert 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.

Instanz-Methoden

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, das die während der Initialisierung des Objekts berechneten Locale- und Sortieroptionen widerspiegelt.

Beispiele

Verwendung von Collator

Das folgende Beispiel demonstriert die unterschiedlichen potenziellen Ergebnisse, wenn ein String vor, nach oder auf der gleichen Ebene wie ein anderer auftritt:

js
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 den obigen Code gezeigten Ergebnisse zwischen verschiedenen Browsern und Browserversionen variieren können. Dies liegt daran, dass die Werte implementationsspezifisch sind. Das heißt, die Spezifikation erfordert nur, dass die Vor- und Nachwerte negativ und positiv sind.

Verwendung von Locales

Die durch Intl.Collator.prototype.compare() bereitgestellten Ergebnisse variieren zwischen den 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:

js
// 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

Verwendung von Optionen

Die durch Intl.Collator.prototype.compare() bereitgestellten Ergebnisse können mithilfe des options-Arguments angepasst werden:

js
// 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

Spezifikationen

Specification
ECMAScript Internationalization API Specification
# collator-objects

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch