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 = textNode.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.