CKTIS / JavaScript
CharacterData.data — ler e alterar os dados de um nó
A propriedade CharacterData.data permite ler ou substituir os dados textuais de um único nó, como Text ou Comment. Atribuir null define uma cadeia vazia.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
node.data
node.data = valueCharacterData.data é uma propriedade que pode ser escrita e contém os dados em cadeia de caracteres de um nó DOM. CharacterData é uma interface abstrata; é utilizada através de tipos concretos, como Text, Comment, CDATASection e ProcessingInstruction.
A leitura de node.data devolve os dados atuais. Atribuir node.data = value substitui todo o conteúdo, em vez de acrescentar texto. O caso especial é null: torna-se "", não a cadeia "null". Num Comment, o valor corresponde aos dados do comentário, sem os delimitadores do comentário.
Esta é uma API DOM, não uma funcionalidade do próprio ECMAScript. A MDN indica que esta propriedade está amplamente disponível nos navegadores desde julho de 2015. A presença de Node.js 24 num repositório não prova que esta API esteja disponível. O exemplo requer um document de navegador e utiliza nós desligados, pelo que não altera a página.
Exemplos
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));Resultado
Hello Updated note ""
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.