Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Node.isConnected

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨janeiro de 2020⁩.

A propriedade somente-leitura isConnected da interface Node retorna um boleano indicando se um nó está conectado (direta ou indiretamente) ao contexto do objeto, por exemplo o objeto Document no caso da DOM normal, ou o ShadowRoot no caso de uma shadow DOM.

Sintaxe

var isItConnected = nodeObjectInstance.isConnected

Retorno

Um Boolean que é true se o nó está conectado ao contexto relevante do objeto, e false se não está.

Examples

Standard DOM

Um exemplo em um DOM padrão:

js
let test = document.createElement("p");
console.log(test.isConnected); // Returns false
document.body.appendChild(test);
console.log(test.isConnected); // Returns true

Shadow DOM

Um exemplo em um Shadow DOM:

js
// Cria um raíz Shadow
var shadow = this.attachShadow({ mode: "open" });

// Cria um CSS para aplicar a Shadow DOm
var style = document.createElement("style");
console.log(style.isConnected); // retorna false

style.textContent = `
.wrapper {
  position: relative;
}

.info {
  font-size: 0.8rem;
  width: 200px;
  display: inline-block;
  border: 1px solid black;
  padding: 10px;
  background: white;
  border-radius: 10px;
  opacity: 0;
  transition: 0.6s all;
  positions: absolute;
  bottom: 20px;
  left: 10px;
  z-index: 3
}
`;

// Anexa a estilização criada a Shadow DOM.

shadow.appendChild(style);
console.log(style.isConnected); // retorna true

Especificações

Specification
DOM
# ref-for-dom-node-isconnected①

Compatibilidade com navegadores