Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 = value

CharacterData.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.

Fontes