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