CKTIS / JavaScript
String.prototype.localeCompare — porównywanie tekstu według reguł językowych
String.prototype.localeCompare porównuje dwa napisy zgodnie z regułami językowymi. Znak wyniku określa kolejność; argumenty locales i options pozwalają sterować porównaniem w środowiskach obsługujących ECMA-402.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
string.localeCompare(compareString, locales?, options?)String.prototype.localeCompare porównuje napis odbiorcy z compareString. Wynik ujemny oznacza kolejność przed drugim napisem, dodatni — po nim, a 0 — równoważność w danym porównaniu, niekoniecznie identyczność tekstu. Sprawdzaj znak wyniku, nie dokładne wartości -1 i 1.
W środowiskach z ECMA-402 argument locales wskazuje preferowany język, np. "en"; jego pominięcie wybiera domyślne ustawienia środowiska. options dostosowuje porównanie: numeric: true porządkuje ciągi cyfr według wartości liczbowej. Reguły zależą od dostępnych danych językowych; bez ECMA-402 nie można polegać na obsłudze tych argumentów.
Do sortowania przekaż funkcję (a, b) => a.localeCompare(b, "en", options). Nie przekazuj samej metody jako funkcji porównującej: wymaga ona właściwego odbiorcy this. W przykładzie numeric: true umieszcza item2 przed item10; oczekiwany wiersz to item1, item2, item10.
Przykłady
const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));Wynik
item1, item2, item10
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.