CKTIS / JavaScript
String.prototype.localeCompare — usporedba teksta prema jezičnim pravilima
String.prototype.localeCompare uspoređuje dva niza prema jezičnim pravilima razvrstavanja. Predznak rezultata određuje njihov redoslijed; locales i options prilagođavaju usporedbu u okruženjima koja podržavaju ECMA-402.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
string.localeCompare(compareString, locales?, options?)String.prototype.localeCompare uspoređuje niz primatelja s compareString. Negativan rezultat znači da je niz ispred drugoga, pozitivan da je iza njega, a 0 označava jednakovrijednost u toj usporedbi, ne nužno istovjetan tekst. Provjerite predznak rezultata, a ne točne vrijednosti -1 i 1.
U okruženjima s ECMA-402, locales traži željeni jezik, primjerice "en"; ako se izostavi, koriste se zadane postavke okruženja. options prilagođava usporedbu: numeric: true razvrstava nizove znamenki prema njihovoj brojčanoj vrijednosti. Pravila ovise o dostupnim jezičnim podacima; bez ECMA-402 ne može se računati na podršku za ove argumente.
Za razvrstavanje proslijedite (a, b) => a.localeCompare(b, "en", options). Nemojte proslijediti samu metodu kao funkciju za usporedbu: potreban joj je ispravan primatelj this. U primjeru numeric: true stavlja item2 ispred item10; očekivani je redak item1, item2, item10.
Primjeri
const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));Rezultat
item1, item2, item10
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.