CKTIS / JavaScript
Intl.Collator — comparer du texte selon les règles d’une langue
Intl.Collator compare des chaînes selon les règles d’une langue sélectionnée. Sa fonction compare peut être transmise directement au tri ; c’est le signe du résultat qui compte, et non une valeur numérique précise.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);Intl.Collator fait partie de la norme d’internationalisation ECMA-402, et non des interfaces DOM. Il crée un objet qui compare du texte en fonction des paramètres régionaux (locales) et des options (options). Indiquer explicitement une langue réduit la dépendance aux paramètres par défaut de l’environnement.
Intl.Collator.prototype.compare est un accesseur qui renvoie une fonction liée à l’instance. Vous pouvez transmettre directement collator.compare à array.sort(...), sans utiliser bind. Un résultat négatif signifie que la première chaîne précède la seconde ; un résultat positif signifie qu’elle la suit, et 0 indique une équivalence selon les règles de comparaison. Ne supposez pas que le résultat vaut exactement -1 ou 1 ; 0 ne signifie pas nécessairement que les chaînes sont identiques.
usage: "sort" sert à ordonner, tandis que usage: "search" sert à vérifier une équivalence, et non à trier. sensitivity détermine les différences prises en compte : "base", "accent", "case" ou "variant". numeric: true permet de comparer des suites de chiffres comme des nombres, si l’environnement le prend en charge.
Les données de langue et les détails de l’ordre dépendent de l’implémentation. Vérifiez la disponibilité de l’API et des paramètres régionaux nécessaires dans le navigateur cible ; sa disponibilité dans Node 24 ne prouve pas qu’elle est prise en charge par les navigateurs. Intl.Collator.supportedLocalesOf(...) permet de vérifier les paramètres régionaux, tandis que collator.resolvedOptions() indique les paramètres effectivement sélectionnés.
Exemples
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);Résultat
a,b,c true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.