Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti