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

CKTIS / JavaScript

String — explicitní převod na text

String(value) převádí hodnotu na primitivní řetězec. Při volání bez argumentu vrací prázdný řetězec. Pokud se převod podaří, new String(value) vytvoří obalový objekt, nikoli primitivní hodnotu.

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(value)
String()
new String(value)

String je vestavěná funkce ECMAScriptu, nikoli API prohlížeče. Volání String(value) vrátí primitivní řetězec, pokud se převod podaří. Typ String představuje neměnné posloupnosti 16bitových kódových jednotek, které se obvykle interpretují jako UTF-16; jeden viditelný znak nemusí odpovídat jediné kódové jednotce.

Vynechání argumentu se liší od předání hodnoty undefined: String() vrátí "", ale String(undefined) vrátí "undefined". Podobně String(null) vytvoří "null" a String(42) vytvoří "42". Přímý argument Symbol se zpracovává zvláštním způsobem: String(Symbol("tag")) vrátí "Symbol(tag)".

Toto zvláštní zpracování platí jen při volání bez new: new String(Symbol("tag")) vyvolá výjimku TypeError namísto vytvoření obalového objektu. Pokud se převod podaří, new String(value) vytvoří obalový objekt. Proto typeof String("hello") vrátí "string", zatímco typeof new String("hello") vrátí "object". Striktní porovnání těchto hodnot pomocí === vrátí false. Pro běžný převod na text používej String(value) bez new.

Převod objektu může zavolat jeho vlastní převodní mechanismy, například [Symbol.toPrimitive] nebo toString, a může vyvolat výjimku. String(value) není serializace JSON ani způsob, jak bezpečně zobrazit libovolné nedůvěryhodné objekty bez spuštění jejich kódu.

Příklady

console.log(JSON.stringify([String(), String(undefined), String(null), String(42)]));
console.log(String(Symbol("tag")));
const text = String("hello");
const wrapped = new String("hello");
console.log(typeof text, typeof wrapped);
console.log(text === wrapped);

Výsledek

["","undefined","null","42"]
Symbol(tag)
string object
false

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