--- title: Node.isConnected slug: Web/API/Node/isConnected translation_of: Web/API/Node/isConnected ---
A propriedade somente-leitura isConnected da interface {{domxref("Node")}} retorna um boleano indicando se um nó está conectado (direta ou indiretamente) ao contexto do objeto, por exemplo o objeto {{domxref("Document")}} no caso da DOM normal, ou o {{domxref("ShadowRoot")}} no caso de uma shadow DOM.
var isItConnected = nodeObjectInstance.isConnected
Um {{domxref("Boolean")}} que é true se o nó está conectado ao contexto relevante do objeto, e false se não está.
Um exemplo em um DOM padrão:
let test = document.createElement('p');
console.log(test.isConnected); // Returns false
document.body.appendChild(test);
console.log(test.isConnected); // Returns true
Um exemplo em um Shadow DOM:
// 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
Node.isConnected pode ser polyfilled com o seguinte código para IE10 e EdgeHTML:
/*
* Node.isConnected polyfill para IE and EdgeHTML
* 2020-02-04
*
* Por Eli Grey, https://eligrey.com
* Domínio Público.
* NENHUMA GARANTIA É EXPRESSADA OU IMPLÍCITA. USE AO SEU PRÓPRIO RISCO.
*/
if (!('isConnected' in Node.prototype)) {
Object.defineProperty(Node.prototype, 'isConnected', {
get() {
return (
!this.ownerDocument ||
!(
this.ownerDocument.compareDocumentPosition(this) &
this.DOCUMENT_POSITION_DISCONNECTED
)
);
},
});
}
| Especificação | Status | Comentários |
|---|---|---|
| {{SpecName('DOM WHATWG','#dom-node-isconnected','isConnected')}} | {{Spec2('DOM WHATWG')}} | Definição Inicial. |
{{Compat("api.Node.isConnected")}}