CKTIS / JavaScript
String.prototype.localeCompare — porovnávání textu podle jazykových pravidel
String.prototype.localeCompare porovnává dva řetězce podle jazykových pravidel řazení. Znaménko výsledku určuje jejich pořadí; locales a options upravují porovnání v prostředích podporujících ECMA-402.
Verze: 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 porovnává řetězec příjemce s compareString. Záporný výsledek znamená, že je řetězec před druhým, kladný, že je za ním, a 0 znamená rovnocennost v daném porovnání, nikoli nutně totožný text. Sledujte znaménko výsledku, ne přesné hodnoty -1 a 1.
V prostředích s ECMA-402 určuje locales preferovaný jazyk, například "en"; pokud tento argument vynecháte, použije se výchozí nastavení prostředí. options upravuje porovnávání: numeric: true řadí posloupnosti číslic podle jejich číselné hodnoty. Pravidla závisejí na dostupných jazykových datech; bez ECMA-402 nelze podporu těchto argumentů zaručit.
Při řazení předejte (a, b) => a.localeCompare(b, "en", options). Nepředávejte samotnou metodu jako porovnávací funkci: potřebuje správný přijímající objekt this. V příkladu numeric: true zařadí item2 před item10; očekávaný řádek je item1, item2, item10.
Příklady
const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));Výsledek
item1, item2, item10
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.