CKTIS / JavaScript
String.prototype.toString() — pridobivanje vrednosti niza
String.prototype.toString() vrne primitivno vrednost niza za niz ali objekt String. Ne gre za splošni pretvornik: nezdružljiva vrednost this povzroči TypeError.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
stringValue.toString()
String.prototype.toString.call(value)Kataloški simbol String.toString se tukaj nanaša na String.prototype.toString(), klicano na vrednosti niza. Ne zamenjujte ga z izrazom String.toString(), ki pokliče metodo na sami funkciji String.
Metoda ne sprejema parametrov. Pri primitivnem nizu vrne isto vrednost; pri objektu, ustvarjenem z new String(...), pridobi besedilo iz notranje reže [[StringData]]. Rezultat je primitivna vrednost vrste string, ne objekt. Vgrajena metoda String.prototype.valueOf() vrne isto vrednost.
Metoda ni generična: String.prototype.toString.call(42) sproži TypeError, prav tako pa tudi klici z null, undefined ali običajnim objektom brez [[StringData]]. Zgolj lastna metoda toString ne zadostuje. Primer prikazuje veljavne sprejemnike in namenoma prestreže napako pri številu.
Primeri
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);
}Rezultat
true hello string true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.