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

CKTIS / JavaScript

Node — um nó DOM

Node é a interface comum dos nós DOM, incluindo elementos e texto. Permite consultar as relações na árvore, ler o tipo de um nó e alterar os seus filhos.

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.contains(other)
node.firstChild
node.parentElement
node.insertBefore(newNode, referenceNode)
node.normalize()
node.parentNode
node.isConnected
node.nodeType
node.nodeValue
node.childNodes
Node.TEXT_NODE
Node.ELEMENT_NODE

Node representa um nó DOM, não apenas um elemento. nodeType distingue, entre outros, Node.ELEMENT_NODE (1) e Node.TEXT_NODE (3). nodeValue expõe dados de texto ou comentário e valores de atributos, mas devolve null para um elemento; atribuir-lhe um valor num elemento não produz qualquer efeito.

childNodes é uma NodeList viva de todos os filhos diretos, incluindo nós de texto com espaços em branco e comentários. As alterações à árvore atualizam a coleção. firstChild devolve o primeiro filho, seja de que tipo for, ou null. parentNode devolve o nó pai, seja de que tipo for, ou null se não houver pai; parentElement só devolve o nó pai se este for um elemento. Caso contrário, devolve null.

contains(other) verifica se other é o mesmo nó ou um descendente; devolve false para null. Não atravessa o limite de uma árvore shadow. isConnected indica a ligação a um documento, também através de uma árvore shadow, e não a visibilidade no ecrã.

insertBefore(newNode, referenceNode) devolve newNode. Se newNode for um DocumentFragment, o método insere os filhos do fragmento em vez do próprio fragmento e devolve esse mesmo fragmento, agora vazio. Caso contrário, insere o próprio newNode. A referência tem de ser um filho direto; null explícito significa o fim da lista. Um nó existente é movido, não copiado. Um elemento-pai da referência inválido causa NotFoundError, e uma hierarquia não permitida causa HierarchyRequestError. normalize() remove os nós Text comuns vazios na subárvore e combina nós Text comuns adjacentes, mantendo o primeiro nó não vazio de cada sequência combinada. Não remove nem combina nós CDATASection, mesmo que estejam vazios; estes separam as sequências de nós Text comuns. Não remove espaços em branco de texto não vazio.

Executa o exemplo num browser com DOM. Usar Node 24 num repositório não comprova, por si só, o suporte desta API de browser.

Identificadores de referência abrangidos por esta entrada: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.

Exemplos

(() => {
  const root = document.createElement('div');
  const text = document.createTextNode('A');
  root.insertBefore(text, null);
  root.insertBefore(document.createTextNode('B'), null);
  const children = root.childNodes;

  console.log(children.length);
  console.log(root.nodeType === Node.ELEMENT_NODE);
  console.log(text.nodeType === Node.TEXT_NODE);
  console.log(text.parentNode === root, text.parentElement === root);
  console.log(root.contains(text), root.contains(root), root.contains(null));
  console.log(root.isConnected);

  root.normalize();
  console.log(children.length, root.firstChild.nodeValue);
  console.log(root.nodeValue === null);
})();

Resultado

2
true
true
true true
true true false
false
1 AB
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