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

CKTIS / JavaScript

Nós do DOM: tipo, valor e nós filhos

Distingue nós de texto de elementos, lê o valor de um nó e percorre os seus filhos diretos tendo em conta que a lista se atualiza automaticamente.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

node.nodeType
node.nodeValue
node.nodeValue = text
node.childNodes
node.nodeType === Node.TEXT_NODE
node.nodeType === Node.ELEMENT_NODE

A propriedade só de leitura node.nodeType devolve um inteiro que identifica o tipo de nó. Compara-o com as constantes da interface Node através de ===: Node.TEXT_NODE (3) identifica um nó de texto e Node.ELEMENT_NODE (1) identifica um elemento. Um elemento e o texto que contém são nós distintos. Estas API do DOM pertencem à plataforma Web, não ao ECMAScript 2024; um ambiente de execução JavaScript não tem de disponibilizar o DOM.

node.nodeValue refere-se ao próprio nó. Num nó de texto, permite ler o texto; atribuir-lhe uma cadeia de caracteres substitui esse texto sem interpretar a cadeia como HTML. Um comentário também tem uma cadeia de caracteres como valor. Num elemento, a propriedade devolve null e uma atribuição não tem efeito, mesmo que o elemento contenha texto. Para ler o texto combinado dos descendentes de um elemento, excluindo comentários e instruções de processamento, usa element.textContent.

A propriedade só de leitura node.childNodes devolve uma NodeList dinâmica dos filhos diretos, não de todos os descendentes. A lista tem índices a partir de zero e não é um array. Inclui elementos, nós de texto e comentários. A indentação e as quebras de linha no HTML podem criar nós de texto compostos apenas por carateres de espaço em branco, pelo que childNodes[0] não é necessariamente um elemento. Para obter apenas os filhos diretos que são elementos, usa element.children.

Se guardares uma referência à lista, esta continua a refletir a adição e a remoção de filhos. Remover um nó durante um percurso por ordem crescente pode deslocar os índices e fazer com que saltes o nó seguinte. Se precisares de percorrer um conjunto fixo de entradas, usa Array.from(node.childNodes) antes de fazer alterações. O array contém referências aos mesmos nós, não clones.

Exemplos

{
  const { document, Node } = globalThis.document && globalThis.Node
    ? globalThis
    : createExampleDOM();

  const parent = document.createElement("div");
  const children = parent.childNodes;
  console.log(children.length);

  const text = document.createTextNode(" ");
  const span = document.createElement("span");
  span.appendChild(document.createTextNode("inside"));
  parent.appendChild(text);
  parent.appendChild(span);
  console.log(children.length);

  for (const child of children) {
    const type = child.nodeType;
    const kind = type === Node.TEXT_NODE ? "text" :
      type === Node.ELEMENT_NODE ? "element" : "other";
    console.log(JSON.stringify([kind, type, child.nodeValue]));
  }

  span.nodeValue = "ignored";
  console.log(span.textContent);
  text.nodeValue = "outside";
  console.log(text.nodeValue);

  // Plain Node.js has no DOM. This local model implements only the
  // element, text, and live-list operations used by this example.
  function createExampleDOM() {
    class ExampleNode {
      static TEXT_NODE = 3;
      static ELEMENT_NODE = 1;

      #type;
      #value;
      #children = [];
      #list;

      constructor(type, value = null) {
        this.#type = type;
        this.#value = value;
        const children = this.#children;
        this.#list = {
          get length() { return children.length; },
          [Symbol.iterator]() { return children[Symbol.iterator](); }
        };
      }

      get nodeType() { return this.#type; }
      get childNodes() { return this.#list; }
      get nodeValue() { return this.#value; }
      set nodeValue(value) {
        if (this.#type === ExampleNode.TEXT_NODE) {
          this.#value = value === null ? "" : String(value);
        }
      }

      get textContent() {
        if (this.#type === ExampleNode.TEXT_NODE) return this.#value;
        return this.#children.map(child => child.textContent).join("");
      }

      appendChild(child) {
        this.#children.push(child);
        return child;
      }
    }

    return {
      Node: ExampleNode,
      document: {
        createElement: () => new ExampleNode(ExampleNode.ELEMENT_NODE),
        createTextNode: value => new ExampleNode(ExampleNode.TEXT_NODE, String(value))
      }
    };
  }
}

Resultado

0
2
["text",3," "]
["element",1,null]
inside
outside

Executa o código na consola do navegador numa página HTML. A lista guardada passa de `0` para `2`, embora o nó pai não esteja ligado à página. A linha JSON do nó de texto mostra um único espaço entre aspas.

Lições relacionadas

  • JavaScript · Lição 16 · Avançado · Versão: 4

Fontes