Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.toUpperCase() — převod písmen na velká

Metoda toUpperCase() vrací text, ve kterém jsou písmena převedena na velká podle výchozích pravidel Unicode. Původní text nemění, nepřijímá žádné argumenty a délka výsledku se může změnit.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

string.toUpperCase()

String.prototype.toUpperCase() vrací hodnotu typu string s písmeny převedenými na velká podle výchozího algoritmu Unicode. Volejte ji jako string.toUpperCase() bez argumentů. Původní text zůstává beze změny; chcete-li převedený text použít, uložte nebo předejte vrácenou hodnotu.

Převod se neomezuje na ASCII. Jeden znak může být nahrazen několika znaky, takže se délka výsledku může změnit: ß se změní na SS. Číslice a interpunkční znaménka v příkladu zůstávají beze změny. Převod na velká a následně na malá písmena nemusí obnovit původní text.

Metoda nezohledňuje zvolený jazyk ani místní nastavení. Pokud potřebujete pravidla převodu závislá na jazyce, zvažte toLocaleUpperCase(). Samotné toUpperCase() není obecným mechanismem pro porovnávání textu bez ohledu na velikost písmen.

Metodu lze také zavolat pomocí String.prototype.toUpperCase.call(value) s hodnotou value jako příjemcem. Pro null a undefined vyvolá TypeError ještě před převodem. V ostatních případech použije operaci ToString, která u primitivní hodnoty typu Symbol vyvolá TypeError. Patří do standardní knihovny ECMAScript, nikoli do DOM; specifikace jazyka není tabulkou kompatibility prohlížečů.

Příklady

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

Výsledek

Straße 123!
STRASSE 123!
11 12

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje