CKTIS / JavaScript
String.prototype.localeCompare — porovnávanie textu podľa jazykových pravidiel
String.prototype.localeCompare porovnáva dva reťazce podľa jazykových pravidiel triedenia. Znamienko výsledku určuje ich poradie; locales a options upravujú porovnávanie v prostrediach podporujúcich ECMA-402.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.localeCompare(compareString, locales?, options?)String.prototype.localeCompare porovnáva reťazec prijímateľa s compareString. Záporný výsledok znamená, že reťazec je pred druhým, kladný, že je za ním, a 0 znamená rovnocennosť v danom porovnaní, nie nevyhnutne totožný text. Sledujte znamienko výsledku, nie presné hodnoty -1 a 1.
V prostrediach s ECMA-402 určuje locales preferovaný jazyk, napríklad "en"; ak tento argument vynecháte, použije sa predvolené nastavenie prostredia. options upravuje porovnávanie: numeric: true triedi postupnosti číslic podľa ich číselnej hodnoty. Pravidlá závisia od dostupných jazykových údajov; bez ECMA-402 nemožno zaručiť podporu týchto argumentov.
Pri triedení odovzdajte (a, b) => a.localeCompare(b, "en", options). Neodovzdávajte samotnú metódu ako porovnávaciu funkciu: potrebuje správny prijímajúci objekt this. V príklade numeric: true umiestni item2 pred item10; očakávaný riadok je item1, item2, item10.
Príklady
const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));Výsledok
item1, item2, item10
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.