Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.toLowerCase() — zamiana na małe litery

Metoda toLowerCase() zwraca napis przekształcony na małe litery według reguł Unicode, bez zmiany oryginału. Nie przyjmuje parametrów i nie dostosowuje wyniku do języka użytkownika.

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.toLowerCase()

String.prototype.toLowerCase() zwraca napis po zamianie liter na małe zgodnie z domyślnymi regułami Unicode. Wywołuj ją jako string.toLowerCase(), bez argumentów. Oryginalny napis pozostaje niezmieniony; aby zachować wynik, przypisz go do zmiennej.

Konwersja jest niezależna od ustawień regionalnych, ale może zależeć od kontekstu znaków. Nie należy traktować jej jako uniwersalnej reguły porównywania tekstów bez uwzględniania wielkości liter. Zamiana na wielkie litery, a następnie na małe nie musi dawać tego samego wyniku co bezpośrednie użycie toLowerCase().

Jeden znak może zostać przekształcony w kilka punktów kodowych, więc długość wyniku może się zmienić. W przykładzie \u0130 staje się sekwencją i\u0307, której length wynosi 2.

Metoda jest generyczna: wywołana przez String.prototype.toLowerCase.call(value) najpierw odrzuca null i undefined błędem TypeError, a pozostałe wartości konwertuje na napis. Sama konwersja również może zgłosić błąd.

Przykłady

const original = "HELLO ŁÓDŹ";
const lower = original.toLowerCase();
console.log(lower);
console.log(original);

const expanded = "\u0130".toLowerCase();
console.log(expanded === "i\u0307");
console.log(expanded.length);

Wynik

hello łódź
HELLO ŁÓDŹ
true
2

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła