CKTIS / JavaScript
String.prototype.toString() — recuperare un valore stringa
String.prototype.toString() restituisce il valore primitivo di tipo stringa di una stringa o di un oggetto String. Non è un convertitore generico: un valore this non compatibile causa un TypeError.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
stringValue.toString()
String.prototype.toString.call(value)Il simbolo di catalogo String.toString indica qui String.prototype.toString(), chiamato su un valore stringa. Non va confuso con l’espressione String.toString(), che chiama un metodo sulla funzione String stessa.
Il metodo non accetta parametri. Per una stringa primitiva restituisce lo stesso valore; per un oggetto creato con new String(...), recupera il testo dallo slot interno [[StringData]]. Il risultato è un valore primitivo di tipo string, non un oggetto. Il metodo integrato String.prototype.valueOf() restituisce lo stesso valore.
Il metodo non è generico: String.prototype.toString.call(42) genera un TypeError, così come le chiamate con null, undefined o un normale oggetto privo di [[StringData]]. La sola presenza di un metodo toString personalizzato non è sufficiente. L’esempio mostra ricevitori validi e intercetta intenzionalmente l’errore per un numero.
Esempi
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);
}Risultato
true hello string true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.