Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

CharacterData.data — leggere e modificare i dati di un nodo

La proprietà CharacterData.data consente di leggere o sostituire i dati testuali di un singolo nodo, come Text o Comment. Assegnare null imposta una stringa vuota.

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

node.data
node.data = value

CharacterData.data è una proprietà scrivibile che contiene i dati sotto forma di stringa di un nodo DOM. CharacterData è un’interfaccia astratta; la si usa tramite tipi concreti come Text, Comment, CDATASection e ProcessingInstruction.

La lettura di node.data restituisce i dati correnti. L’assegnazione di node.data = value sostituisce l’intero contenuto invece di aggiungere testo. Il caso particolare è null: diventa "", non la stringa "null". Per un Comment, il valore è costituito dai dati del commento senza i delimitatori.

Questa è un’API DOM, non una funzionalità di ECMAScript in sé. MDN indica che la proprietà è ampiamente disponibile nei browser da luglio 2015. La presenza di Node.js 24 in un repository non dimostra che questa API sia disponibile. L’esempio richiede un document del browser e usa nodi scollegati, quindi non modifica la pagina.

Esempi

const text = document.createTextNode("Hello");
const comment = document.createComment("note");
console.log(text.data);
text.data = "Updated";
console.log(text.data);
console.log(comment.data);
text.data = null;
console.log(JSON.stringify(text.data));

Risultato

Hello
Updated
note
""

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