Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.toUpperCase() — zamiana liter na wielkie

Metoda toUpperCase() zwraca tekst z literami zamienionymi na wielkie zgodnie z domyślnymi regułami Unicode. Nie zmienia oryginału, nie przyjmuje argumentów i może zmienić długość wyniku.

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

String.prototype.toUpperCase() zwraca wartość typu string po zamianie liter na wielkie według domyślnego algorytmu Unicode. Wywołuj ją jako string.toUpperCase(), bez argumentów. Oryginalny tekst pozostaje niezmieniony; aby użyć przekształconego tekstu, zachowaj lub przekaż zwróconą wartość.

Konwersja nie ogranicza się do ASCII. Jeden punkt kodowy może zostać zastąpiony kilkoma, więc długość wyniku może się zmienić: ß staje się SS. Cyfry i znaki interpunkcyjne z przykładu pozostają bez zmian. Konwersja na wielkie, a następnie małe litery nie musi odtworzyć oryginału.

Metoda nie uwzględnia wybranego języka ani ustawień regionalnych. Gdy potrzebujesz reguł zależnych od języka, rozważ toLocaleUpperCase(). Samo toUpperCase() nie jest ogólnym mechanizmem porównywania tekstów bez rozróżniania wielkości liter.

Metodę można też wywołać za pomocą String.prototype.toUpperCase.call(value), przekazując value jako odbiorcę. Metoda zgłasza TypeError dla null i undefined przed konwersją. W pozostałych przypadkach używa operacji ToString, która zgłasza TypeError dla wartości pierwotnej typu Symbol. Jest częścią standardowej biblioteki ECMAScript, a nie interfejsem DOM; specyfikacja języka nie stanowi tabeli zgodności przeglądarek.

Przykłady

const original = "Straße 123!";
const upper = original.toUpperCase();
console.log(original);
console.log(upper);
console.log(original.length, upper.length);

Wynik

Straße 123!
STRASSE 123!
11 12

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

Źródła