Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje