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

CKTIS / JavaScript

document.createTextNode() — criar um nó de texto

document.createTextNode(data) cria um nó Text com o conteúdo fornecido, sem o interpretar como marcação.

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

document.createTextNode(data)

document.createTextNode(data) devolve um novo nó Text pertencente ao documento. O argumento obrigatório data especifica o seu conteúdo.

Inicialmente, o nó não tem pai. Utilize appendChild() para o anexar; a criação, por si só, não altera a página. O seu conteúdo continua a ser texto, e não uma estrutura de elementos.

O exemplo anexa o texto a um elemento desligado e verifica o seu conteúdo e o tipo de nó. Esta é uma API DOM, não uma funcionalidade do próprio ECMAScript.

Exemplos

const container = document.createElement('p');
const text = document.createTextNode('<b>Hello</b> & welcome');
console.log(text.parentNode === null);
container.appendChild(text);
console.log(container.textContent);
console.log(container.childNodes.length);
console.log(container.firstChild.nodeType === Node.TEXT_NODE);

Resultado

true
<b>Hello</b> & welcome
1
true

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