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

CKTIS / JavaScript

String.prototype.toLowerCase() — převod na malá písmena

Metoda toLowerCase() vrací řetězec převedený na malá písmena podle pravidel Unicode, aniž by změnila původní řetězec. Nepřijímá žádné parametry a nepřizpůsobuje výsledek jazyku uživatele.

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

String.prototype.toLowerCase() vrací řetězec, jehož písmena jsou převedena na malá podle výchozích pravidel Unicode pro převod velikosti písmen. Metodu zavolej bez argumentů jako string.toLowerCase(). Původní řetězec zůstane nezměněný; pokud chceš výsledek zachovat, přiřaď ho do proměnné.

Převod nezávisí na místním nastavení, může však záviset na kontextu okolních znaků. Nepovažuj ho za univerzální pravidlo pro porovnávání textu bez rozlišování velikosti písmen. Převod na velká a následně na malá písmena nemusí dát stejný výsledek jako přímé zavolání toLowerCase().

Jeden znak se může převést na několik bodů kódu, takže délka výsledku se může změnit. V příkladu se \u0130 změní na posloupnost i\u0307, jejíž length je 2.

Metoda je generická: při zavolání přes String.prototype.toLowerCase.call(value) nejprve odmítne null a undefined chybou TypeError a potom převede ostatní hodnoty na řetězec. I tento převod může vyvolat chybu.

Příklady

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);

Výsledek

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

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