WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.Collator — Text nach Sprachregeln vergleichen

Intl.Collator vergleicht Zeichenfolgen nach den Regeln einer ausgewählten Sprache. Die compare-Funktion kann direkt zum Sortieren übergeben werden; entscheidend ist das Vorzeichen des Ergebnisses, nicht ein bestimmter Zahlenwert.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);

Intl.Collator gehört zum Internationalisierungsstandard ECMA-402 und nicht zu den DOM-Schnittstellen. Es erstellt ein Objekt, das Text anhand von Gebietsschemaeinstellungen (locales) und Optionen (options) vergleicht. Wenn Sie eine Sprache ausdrücklich angeben, sind Sie weniger von den Standardeinstellungen der Umgebung abhängig.

Intl.Collator.prototype.compare ist ein Accessor, der eine an die Instanz gebundene Funktion zurückgibt. Sie können collator.compare direkt an array.sort(...) übergeben, ohne bind zu verwenden. Ein negatives Ergebnis bedeutet, dass die erste Zeichenfolge vor der zweiten steht; ein positives bedeutet, dass sie danach steht, und 0 bedeutet Gleichwertigkeit gemäß den Vergleichsregeln. Gehen Sie nicht davon aus, dass genau -1 oder 1 zurückgegeben wird; 0 muss nicht identische Zeichenfolgen bedeuten.

usage: "sort" dient zum Ordnen, während usage: "search" zum Prüfen der Gleichwertigkeit und nicht zum Sortieren dient. sensitivity legt fest, welche Unterschiede berücksichtigt werden: "base", "accent", "case" oder "variant". numeric: true aktiviert den Vergleich von Ziffernfolgen als Zahlen, sofern die Umgebung dies unterstützt.

Gebietsschemadaten und Einzelheiten der Sortierreihenfolge hängen von der Implementierung ab. Prüfen Sie die Verfügbarkeit der API und der benötigten Gebietsschemas im Zielbrowser; die Verfügbarkeit in Node 24 belegt keine Browserunterstützung. Mit Intl.Collator.supportedLocalesOf(...) können Sie Gebietsschemas prüfen, während collator.resolvedOptions() die tatsächlich ausgewählten Einstellungen offenlegt.

Beispiele

const collator = new Intl.Collator("en", { usage: "sort" });
const words = ["c", "a", "b"];
console.log(words.sort(collator.compare).join(","));
console.log(collator.compare("a", "b") < 0);
console.log(collator.compare("a", "a") === 0);

Ergebnis

a,b,c
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen