Intl.Collator.prototype.compare()

Метод compare() объектов Intl.Collator сравнивает две строки в соответствии с порядком сортировки данного объекта Collator.

Попробуйте

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

Синтаксис

compare(string1, string2)

Параметры

string1, string2

Строки для сравнения друг с другом.

Возвращаемое значение

Число, указывающее, как string1 и string2 соотносятся друг с другом в соответствии с порядком сортировки данного объекта Intl.Collator:

• Отрицательное значение, если string1 предшествует string2;
• Положительное значение, если string1 следует за string2;
• 0, если они считаются равными.

Примеры

Использование compare для сортировки массива

Используйте функцию compare для сортировки массивов. Обратите внимание, что функция привязана к объекту Collator, от которого она была получена, поэтому ее можно передавать непосредственно в Array.prototype.sort().

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"

Использование compare для поиска в массиве

Используйте функцию compare для поиска совпадающих строк в массивах:

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"

Спецификации

Совместимость с браузерами

См. также

• Intl.Collator
• String.prototype.localeCompare()