Node.contains

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Sumário

Indica se um nó é um descendente de um dado nó.

Sintaxe

node.contains( otherNode )
  • node é o nó que está sendo comparado.
  • otherNode é o nó contra o qual está sendo comparado.

O valor de retorno é true se otherNode é um descendente de um nó ou o próprio nó. Caso contrário o valor de retorno é false.

Exemplo

Esta função verifica se um elemento está no corpo da página. As contains is inclusive and determining if the body contains itself isn't the intention of isInPage this case explicitly returns false.

js
function isInPage(node) {
  return node === document.body ? false : document.body.contains(node);
}
  • node é o nó que desejamos verificar se está no <body>.

Especificações

Specification
DOM Standard
# ref-for-dom-node-contains①

Compatibilidade com navegadores

BCD tables only load in the browser

Ver também