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.