Node

Node é uma interface da qual diversos tipos do DOM herdam, e que permite que esses tipos sejam tratados de forma similar, por exemplo, herdando os mesmos métodos ou sendo testados da mesma forma.

Todos os tipos a seguir herdam essa interface e seus métodos e propriedades (apesar de que alguns podem devolver null em casos particulares em que o método ou a propriedade não são relevantes; ou lançar uma exceção quando adicionando um filho a um tipo de nó que não pode ter filhos): Document, Element, Attr, CharacterData (do qual Text, Comment, e CDATASection herdam), ProcessingInstruction, DocumentFragment, DocumentType, Notation, Entity, EntityReference

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/pt-BR/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/pt-BR/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Propriedades

Herda propriedades de seus pais, EventTarget.^[1]

Node.baseURI Somente leitura

Retorna uma DOMString representando o URL base do nó. O conceito de URL base muda de uma linguagem para outra; no HTML, ela corresponde ao protocolo, ao nome de domínio e a estrutura de diretório; tudo isso até a última '/'.

Node.baseURIObject

Retorna um objeto nsIURI, representando o URL base do nó. (Indisponível para conteúdo Web)

Node.childNodes Somente leitura

Retorna um objeto NodeList "vivo" contendo todos os filhos deste nó. Dizer que um objeto NodeList é vivo significa que se houver alguma mudança em um dos filhos deste nó, o objeto NodeList é automaticamente atualizado com tais mudanças.

Node.firstChild Somente leitura

Retorna um Node representando o primeiro filho direto do nó ou null, caso o nó não tenha nenhum filho.

Node.lastChild Somente leitura

Retorna um Node representando o último filho direto do elemento ou null, caso o elemento não tenha nenhum filho.

Node.nextSibling Somente leitura

Retorna um Node representando o próximo elemento na árvore ou null, caso tal nó não exista.

Node.nodeName Somente leitura

Retorna uma DOMString contendo o nome do elemento, do Node. A estrutura do nome irá mudar conforme o tipo do elemento. Veja as diferenças na documentação do método Node.nodeName.  

Node.nodePrincipal

Uma interface nsIPrincipal representando o nó principal.

Node.nodeTypeSomente leitura

Retorna um unsigned short representando o tipo do nodo. Valores possíveis são:

Node.nodeValue

Retorna / Define o valor do nó atual

Node.ownerDocument Somente leitura

Retorna o Document qual esse nó pertence. Se o nó em si é um documento, retorna null.

Node.parentNode Somente leitura

Retorna um Node que é pai desse nó. Se não existe tal nó, como, por exemplo, se esse nó é o topo da árvore ou se ele não participa de uma árvore, essa propriedade retorna null.

Node.previousSibling Somente leitura

Retorna um Node representando o último nó em uma árvore ou null se não existe tal nodo.

Node.textContent

Retorna / Define o conteúdo textual de um elemento e de todos os seus descendentes.

 

Propriedades descontinuadas

Node.rootNode Somente leitura

Retorna um objeto Node representando o nó mais alto em uma árvore, ou o nó atual, se ele for o mais alto da árvore. Isso foi substituído por Node.getRootNode().

Propriedades obsoletas

Node.localName Somente leitura

Retorna um DOMString representando a parte local do nome qualificado de um elemento.

Nota: No Firefox 3.5 e nas versões anteriores, a propriedade coloca em caixa alta o nome local de elementos HTML (mas não elementos XHTML). Em versões posteriores, isso não acontece, então a propriedade está em caixa baixa para ambos HTML e XHTML.

Node.namespaceURI Somente leitura

O espaço de nomes URI desse nó, ou null se não estiver no espaço de nomes.

Nota: No Firefox 3.5 e nas versões anteriores, elementos HTML estão no espaço de nomes. Em versões posteriores, elementos HTML estão em http://www.w3.org/1999/xhtml/, nas árvores HTML e XML.

Node.prefix Somente leitura

É um DOMString representando o espaço de nomes do nó, ou null se nenhum prefixo é especificado.

Métodos

• Node.appendChild
• Node.cloneNode
• Node.compareDocumentPosition
• Node.contains
• Node.getFeature Obsolete since Gecko 7.0
• Node.getUserData Obsolete since Gecko 22.0
• Node.hasAttributes Obsolete since Gecko 22.0
• Node.hasChildNodes
• Node.insertBefore
• Node.isDefaultNamespace
• Node.isEqualNode
• Node.isSameNode Deprecated since Gecko 9.0 Obsolete since Gecko 10.0
• Node.isSupported Obsolete since Gecko 22.0
• Node.lookupPrefix
• Node.lookupNamespaceURI
• Node.normalize
• Node.removeChild
• Node.replaceChild
• Node.setUserData Obsolete since Gecko 22.0

Constantes

Veja também Node.nodeType

Exemplos de código

Recuperar todos os nós filhos

A função a seguir percorre todos os nós filhos de um nó recursivamente e executa uma função de callback em cada um deles (e no nó pai também).

function DOMComb (oParent, oCallback) {
  if (oParent.hasChildNodes()) {
    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
      DOMComb(oNode, oCallback);
    }
  }
  oCallback.call(oParent);
}

Sintaxe

DOMComb(parentNode, callbackFunction);

Descrição

Percorre todos os nós filhos de parentNode recursivamente e o próprio parentNode e executa a callbackFunction em cada um deles como this.

Parâmetros

parentNode

O nó pai (Object do tipo Node).

callbackFunction

A função de callback (Function).

Exemplo de uso

O exemplo a seguir envia para a função console.log o conteúdo textual do body:

function imprimeConteudo () {
  if (this.nodeValue) { console.log(this.nodeValue); }
}

onload = function () {
  DOMComb(document.body, imprimeConteudo);
};

Especificações

• DOM Level 1 Core: Node interface
• DOM Level 2 Core: Node interface
• DOM Level 3 Core: Node interface
• DOM Standard: Node Interface