CKTIS / JavaScript
String — conversione esplicita in testo
String(value) converte un valore in una stringa primitiva. Chiamata senza argomenti, la funzione restituisce una stringa vuota. Se la conversione riesce, new String(value) crea un oggetto wrapper anziché un valore primitivo.
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
String(value)
String()
new String(value)String è una funzione integrata di ECMAScript, non un’API del browser. La chiamata String(value) restituisce una stringa primitiva se la conversione riesce. Il tipo String rappresenta sequenze immutabili di unità di codice a 16 bit, normalmente interpretate come UTF-16; una lettera visibile o un altro carattere non corrisponde necessariamente a una singola unità di codice.
Omettere l’argomento è diverso dal passare undefined: String() restituisce "", mentre String(undefined) restituisce "undefined". Analogamente, String(null) produce "null" e String(42) produce "42". Un argomento Symbol diretto riceve un trattamento speciale: String(Symbol("tag")) restituisce "Symbol(tag)".
Questo trattamento speciale si applica solo alle chiamate senza new: new String(Symbol("tag")) genera un’eccezione TypeError anziché creare un oggetto wrapper. Se la conversione riesce, new String(value) crea un oggetto wrapper. Di conseguenza, typeof String("hello") produce "string", mentre typeof new String("hello") produce "object". Il confronto rigoroso di questi valori con === produce false. Per la normale conversione in testo, usa String(value) senza new.
La conversione di un oggetto può invocare i suoi meccanismi di conversione, come [Symbol.toPrimitive] o toString, e può generare un’eccezione. String(value) non è né una serializzazione JSON né un modo per visualizzare in sicurezza oggetti arbitrari non attendibili senza eseguirne il codice.
Esempi
console.log(JSON.stringify([String(), String(undefined), String(null), String(42)]));
console.log(String(Symbol("tag")));
const text = String("hello");
const wrapped = new String("hello");
console.log(typeof text, typeof wrapped);
console.log(text === wrapped);Risultato
["","undefined","null","42"] Symbol(tag) string object false
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.