CKTIS / JavaScript
String.prototype.toString() — získanie reťazcovej hodnoty
String.prototype.toString() vracia primitívnu reťazcovú hodnotu reťazca alebo objektu String. Nie je to všeobecný prevodník: nekompatibilná hodnota this vyvolá TypeError.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
stringValue.toString()
String.prototype.toString.call(value)Katalógový symbol String.toString tu označuje metódu String.prototype.toString() volanú na reťazcovej hodnote. Nezamieňajte si ju s výrazom String.toString(), ktorý volá metódu na samotnej funkcii String.
Metóda neprijíma žiadne parametre. Pri primitívnom reťazci vracia tú istú hodnotu; pri objekte vytvorenom pomocou new String(...) získa text z interného slotu [[StringData]]. Výsledkom je primitívna hodnota typu string, nie objekt. Vstavaná metóda String.prototype.valueOf() vracia tú istú hodnotu.
Metóda nie je generická: String.prototype.toString.call(42) vyvolá TypeError, rovnako ako volania s null, undefined alebo bežným objektom bez [[StringData]]. Samotná existencia vlastnej metódy toString nestačí. Príklad ukazuje platné prijímače a zámerne zachytáva chybu pri použití čísla.
Prí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ýsledok
true hello string true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.