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

CKTIS / JavaScript

String.prototype.toString() — získání řetězcové hodnoty

String.prototype.toString() vrací primitivní řetězcovou hodnotu řetězce nebo objektu String. Nejde o obecný převodník: nekompatibilní hodnota this vyvolá TypeError.

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

stringValue.toString()
String.prototype.toString.call(value)

Katalogový symbol String.toString zde označuje metodu String.prototype.toString() volanou na řetězcové hodnotě. Nezaměňujte ji s výrazem String.toString(), který volá metodu na samotné funkci String.

Metoda nepřijímá žádné parametry. U primitivního řetězce vrací tutéž hodnotu; u objektu vytvořeného pomocí new String(...) získá text z interního slotu [[StringData]]. Výsledkem je primitivní hodnota typu string, nikoli objekt. Vestavěná metoda String.prototype.valueOf() vrací stejnou hodnotu.

Metoda není generická: String.prototype.toString.call(42) vyvolá TypeError, stejně jako volání s null, undefined nebo běžným objektem bez [[StringData]]. Pouhá existence vlastní metody toString nestačí. Příklad ukazuje platné přijímače a záměrně zachytává chybu při použití čísla.

Příklady

const text = "hello";
const wrapped = new String(text);
const result = wrapped.toString();

console.log(text.toString() === text);
console.log(result, typeof result);
console.log(result === wrapped.valueOf());

try {
  String.prototype.toString.call(42);
} catch (error) {
  console.log(error instanceof TypeError);
}

Výsledek

true
hello string
true
true

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