Intl.Collator.prototype.compare() - JavaScript

Intl.Collator.prototype.compare() - JavaScript | MDN

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.

Die compare()-Methode von Intl.Collator Instanzen vergleicht zwei Strings entsprechend der Sortierreihenfolge dieses Collator-Objekts.

Probieren Sie es aus

const enCollator = new Intl.Collator("en");
const deCollator = new Intl.Collator("de");
const svCollator = new Intl.Collator("sv");

console.log(enCollator.compare("z", "a") > 0);
// Expected output: true

console.log(deCollator.compare("z", "ä") > 0);
// Expected output: true

console.log(svCollator.compare("z", "ä") > 0);
// Expected output: false

Syntax

compare(string1, string2)

Parameter

string1, string2: Die Strings, die miteinander verglichen werden sollen.

Rückgabewert

Eine Zahl, die angibt, wie string1 und string2 gemäß der Sortierreihenfolge dieses Intl.Collator-Objekts verglichen werden:

Ein negativer Wert, wenn string1 vor string2 kommt;
Ein positiver Wert, wenn string1 nach string2 kommt;
0, wenn sie als gleich angesehen werden.

Verwenden Sie die compare-Funktion zur Sortierung von Arrays. Beachten Sie, dass die Funktion an den Collator gebunden ist, von dem sie abgeleitet wurde, so dass sie direkt an Array.prototype.sort() übergeben werden kann.

const a = ["Offenbach", "Österreich", "Odenwald"];
const collator = new Intl.Collator("de-u-co-phonebk");
a.sort(collator.compare);
console.log(a.join(", ")); // "Odenwald, Österreich, Offenbach"

Verwendung von compare für Array-Suche

Verwenden Sie die compare-Funktion zur Suche nach passenden Strings in Arrays:

const a = ["Congrès", "congres", "Assemblée", "poisson"];
const collator = new Intl.Collator("fr", {
  usage: "search",
  sensitivity: "base",
});
const s = "congres";
const matches = a.filter((v) => collator.compare(v, s) === 0);
console.log(matches.join(", ")); // "Congrès, congres"

Spezifikationen

Spezifikation
ECMAScript® 2026 Internationalization API Specification # sec-intl.collator.prototype.compare

Browser-Kompatibilität

Siehe auch

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.