WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.localeCompare — sprachabhängiger Textvergleich

String.prototype.localeCompare vergleicht zwei Zeichenfolgen nach sprachlichen Sortierregeln. Das Vorzeichen des Ergebnisses bestimmt ihre Reihenfolge; locales und options passen den Vergleich in Umgebungen mit ECMA-402 an.

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

string.localeCompare(compareString, locales?, options?)

String.prototype.localeCompare vergleicht die Zeichenfolge des Empfängers mit compareString. Ein negatives Ergebnis bedeutet, dass sie vor der anderen Zeichenfolge steht, ein positives, dass sie danach steht, und 0 bedeutet Gleichwertigkeit bei diesem Vergleich, nicht unbedingt identischen Text. Achte auf das Vorzeichen des Ergebnisses, nicht auf die exakten Werte -1 und 1.

In Umgebungen mit ECMA-402 fordert locales eine bevorzugte Sprache an, zum Beispiel "en"; wird es weggelassen, gelten die Standardeinstellungen der Umgebung. options passt den Vergleich an: numeric: true ordnet Ziffernfolgen nach ihrem Zahlenwert. Die Regeln hängen von den verfügbaren Gebietsschemadaten ab; ohne ECMA-402 kann die Unterstützung dieser Argumente nicht vorausgesetzt werden.

Zum Sortieren übergibst du (a, b) => a.localeCompare(b, "en", options). Übergib die Methode nicht selbst als Vergleichsfunktion: Sie benötigt den richtigen this-Empfänger. Im Beispiel setzt numeric: true item2 vor item10; die erwartete Zeile lautet item1, item2, item10.

Beispiele

const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));

Ergebnis

item1, item2, item10

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