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.