CKTIS / JavaScript
Intl.Collator : sensibilité et règles de tri propres à la locale
Comparez et triez des chaînes selon les règles de la locale choisie. L’option `sensitivity` détermine quelles différences influencent la comparaison.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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.Avec Intl.Collator, les règles de tri de la locale effectivement utilisée déterminent ce qui constitue une lettre de base. Dans le tri allemand par défaut, ä est une variante de a ; dans le tri suédois, c’est une lettre distincte. C’est pourquoi "base" peut traiter les deux chaînes comme équivalentes avec de, mais pas avec sv.
Les lettres de base différentes restent distinctes quelle que soit la valeur de sensitivity. Pour une même lettre de base, "base" ignore les signes diacritiques et la casse ; "accent" tient compte des diacritiques, mais pas de la casse ; "case" fait l’inverse ; "variant" tient compte des deux et peut prendre en compte d’autres différences. Une valeur hors de cette liste, comme "ignore", déclenche une RangeError.
Avec usage: "sort", le mode par défaut, la sensibilité vaut par défaut "variant". Avec usage: "search", elle dépend de la locale ; dans ce mode, utilisez compare(a, b) === 0 pour tester une correspondance, et non pour ordonner les chaînes. Lors d’un tri, un résultat négatif place a avant b, un résultat positif le place après, et zéro indique que les chaînes sont traitées comme équivalentes. Ne comptez pas sur exactement -1 ou 1. La fonction collator.compare est liée à son instance : vous pouvez la passer directement à sort(). Un résultat de 0 n’implique pas a === b.
Demandez explicitement une locale : si aucune des locales demandées ne peut être retenue, l’environnement utilise sa locale par défaut. Intl.Collator.supportedLocalesOf() vérifie la prise en charge sans repli sur cette locale par défaut, et resolvedOptions().locale indique la locale effective. Les données de tri peuvent varier selon l’environnement et sa version, même avec les mêmes options effectives.
Exemples
{
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}`);
}
}
}Résultat
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
Dans les quatre premières lignes, `true` signifie que la paire est traitée comme équivalente : d’abord `a` et `á`, puis `a` et `A`. Les deux dernières lignes comparent `a` à `ä` avec `"base"` dans `de` et `sv`. La sortie affichée suppose la prise en charge de ces locales et de `en`, avec les règles de tri par défaut décrites.
Leçons associées
- JavaScript · Leçon 24 · Intermédiaire · Version : 3