Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.localeCompare — comparaison de texte selon les règles linguistiques

String.prototype.localeCompare compare deux chaînes selon des règles de classement linguistiques. Le signe du résultat détermine leur ordre ; locales et options permettent de personnaliser la comparaison dans les environnements prenant en charge ECMA-402.

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

string.localeCompare(compareString, locales?, options?)

String.prototype.localeCompare compare la chaîne du récepteur à compareString. Un résultat négatif signifie qu’elle précède l’autre chaîne, un résultat positif qu’elle la suit, et 0 indique une équivalence dans cette comparaison, pas nécessairement un texte identique. Vérifiez le signe du résultat, et non les valeurs exactes -1 et 1.

Dans les environnements prenant en charge ECMA-402, locales demande une langue préférée, par exemple "en" ; si cet argument est omis, les paramètres par défaut de l’environnement sont utilisés. options personnalise la comparaison : numeric: true classe les suites de chiffres selon leur valeur numérique. Les règles dépendent des données de langue disponibles ; sans ECMA-402, la prise en charge de ces arguments n’est pas garantie.

Pour trier, passez (a, b) => a.localeCompare(b, "en", options). Ne passez pas la méthode elle-même comme fonction de comparaison : elle a besoin du bon récepteur this. Dans l’exemple, numeric: true place item2 avant item10 ; la ligne attendue est item1, item2, item10.

Exemples

const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));

Résultat

item1, item2, item10

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.

Sources