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

CKTIS / JavaScript

Intl.Collator: чувствителност при сравнение и езикови правила за сортиране

Сравнявайте и сортирайте низове според правилата на избраната езикова настройка. Опцията `sensitivity` определя кои разлики влияят на сравнението.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

new Intl.Collator(locales, { sensitivity: "base" | "accent" | "case" | "variant", usage: "sort" | "search" })
collator.compare(a, b)
strings.sort(collator.compare)
Intl.Collator.supportedLocalesOf(locales)
collator.resolvedOptions()

The `|` notation lists alternatives; pass one string value per option. Both constructor arguments and both shown options are optional.

В Intl.Collator правилата за сортиране на действително използваната езикова настройка (locale) определят какво се смята за основна буква. При стандартното немско сортиране ä е разновидност на a, а при шведското е отделна буква. Затова при "base" двата низа могат да се смятат за равностойни в de, но не и в sv.

Различните основни букви се различават при всяка стойност на sensitivity. При разновидности на една и съща основна буква "base" пренебрегва диакритичните знаци и разликата между главни и малки букви; "accent" отчита диакритичните знаци, но не различава главни от малки букви; "case" прави обратното; "variant" отчита и двата вида разлики и може да отчита и други. Стойност извън този списък, например "ignore", предизвиква RangeError.

При режима по подразбиране usage: "sort" чувствителността по подразбиране е "variant". При usage: "search" тя зависи от езиковата настройка; в този режим използвайте compare(a, b) === 0 за проверка за съвпадение, а не за сортиране. При сортиране отрицателният резултат означава, че a е преди b, положителният — че е след него, а нулата — че сравнението ги смята за равностойни. Не разчитайте на точно -1 или 1. Функцията collator.compare е обвързана с екземпляра и може да се подаде направо на sort(). Резултат 0 не означава, че a === b.

Посочете изрично езикова настройка: ако никоя от заявените не съответства на налична настройка, средата използва своята настройка по подразбиране. Intl.Collator.supportedLocalesOf() проверява поддръжката, без да прибягва до настройката по подразбиране на средата, а resolvedOptions().locale показва действително използваната настройка. Данните за сортиране могат да се различават между среди и версии дори при еднакви действително използвани опции.

Примери

{
  const locales = ["en", "de", "sv"];
  if (typeof Intl === "undefined" || typeof Intl.Collator !== "function" ||
      Intl.Collator.supportedLocalesOf(locales).length !== locales.length) {
    console.log("Intl.Collator or required locales unavailable");
  } else {
    for (const sensitivity of ["base", "accent", "case", "variant"]) {
      const { compare } = new Intl.Collator("en", { sensitivity });
      console.log(`${sensitivity}: ${compare("a", "á") === 0}, ${compare("a", "A") === 0}`);
    }

    for (const locale of ["de", "sv"]) {
      const { compare } = new Intl.Collator(locale, { sensitivity: "base" });
      console.log(`${locale}: ${compare("a", "ä") === 0}`);
    }
  }
}

Резултат

base: true, true
accent: false, true
case: true, false
variant: false, false
de: true
sv: false

В първите четири реда `true` означава, че двойката се смята за равностойна: първо `a` и `á`, след това `a` и `A`. Последните два реда сравняват `a` с `ä` при `"base"` в `de` и `sv`. Показаният резултат предполага поддръжка на тези настройки и `en`, както и прилагане на описаните правила за сортиране по подразбиране.

Свързани уроци

  • JavaScript · Урок 24 · Средно · Версия: 3

Източници