CKTIS / JavaScript
String.prototype.localeCompare — primerjanje besedila po jezikovnih pravilih
String.prototype.localeCompare primerja dva niza po jezikovnih pravilih razvrščanja. Znak rezultata določa njun vrstni red; locales in options prilagodita primerjavo v okoljih s podporo za ECMA-402.
Različica: 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 primerja niz prejemnika z compareString. Negativen rezultat pomeni, da je niz pred drugim, pozitiven, da je za njim, 0 pa pomeni enakovrednost v tej primerjavi, ne nujno enakega besedila. Preverite znak rezultata, ne natančnih vrednosti -1 in 1.
V okoljih z ECMA-402 locales zahteva prednostni jezik, na primer "en"; če ga izpustite, se uporabijo privzete nastavitve okolja. options prilagodi primerjavo: numeric: true razvrsti zaporedja števk glede na njihovo številsko vrednost. Pravila so odvisna od razpoložljivih jezikovnih podatkov; brez ECMA-402 podpore za te argumente ni mogoče zagotoviti.
Za razvrščanje podajte (a, b) => a.localeCompare(b, "en", options). Metode ne podajte same kot primerjalne funkcije: potrebuje ustrezen sprejemnik this. V primeru numeric: true postavi item2 pred item10; pričakovana vrstica je item1, item2, item10.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.