Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła