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

CKTIS / JavaScript

Node.textContent — ler e substituir texto

Node.textContent lê o texto de um nó ou substitui o seu conteúdo textual sem analisar HTML.

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.textContent
node.textContent = text

Node.textContent é uma propriedade do DOM, não uma funcionalidade de ECMAScript. Para Element e DocumentFragment, concatena os dados dos nós Text descendentes pela ordem da árvore, sem separadores e excluindo os comentários. Não filtra o texto de acordo com a visibilidade CSS.

Uma atribuição substitui todos os filhos por um único nó Text; '' ou null remove-os sem criar um novo. A marcação continua a ser texto. Para Attr, a propriedade lê ou altera o valor; para CharacterData, os dados. Para Document e DocumentType, a leitura devolve null e a escrita não produz qualquer efeito.

Exemplos

const box = document.createElement('div');
const child = document.createElement('span');
child.textContent = 'world';
box.append('Hello ', child);
console.log(box.textContent);
box.textContent = '<b>Literal</b>';
console.log(box.textContent);
console.log(box.childNodes.length, box.firstChild.nodeType);
box.textContent = null;
console.log(box.childNodes.length);

Resultado

Hello world
<b>Literal</b>
1 3
0

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