База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Intl.Collator — сравняване на текст според езиковите правила

Intl.Collator сравнява низове според правилата на избран език. Функцията compare може да се подаде директно за сортиране; важен е знакът на резултата, а не конкретна числова стойност.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

Intl.Collator е част от стандарта за интернационализация ECMA-402, а не от DOM интерфейсите. Той създава обект, който сравнява текст според регионалните настройки (locales) и опциите (options). Изричното посочване на език намалява зависимостта от настройките по подразбиране на средата.

Intl.Collator.prototype.compare е аксесор, който връща функция, обвързана с екземпляра. Можете да подадете collator.compare директно на array.sort(...), без да използвате bind. Отрицателен резултат означава, че първият низ предхожда втория; положителен означава, че следва след него, а 0 означава еквивалентност според правилата за сравнение. Не приемайте, че резултатът е точно -1 или 1; 0 не означава непременно, че низовете са идентични.

usage: "sort" служи за подреждане, докато usage: "search" служи за проверка на еквивалентност, а не за сортиране. sensitivity определя кои разлики се вземат предвид: "base", "accent", "case" или "variant". numeric: true позволява последователности от цифри да се сравняват като числа, ако средата го поддържа.

Езиковите данни и подробностите за подредбата зависят от реализацията. Проверете наличността на API и необходимите езици в целевия браузър; наличността в Node 24 не доказва поддръжка от браузърите. Intl.Collator.supportedLocalesOf(...) помага да проверите езиците, а collator.resolvedOptions() показва действително избраните настройки.

Примери

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);

Резултат

a,b,c
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници