Node.contains

概要

contains メソッドは指定ノードの子孫ノードに特定の子ノード（※自身も含む）が含まれるかどうかを示す真偽値を返します。

構文

node.contains( otherNode ) 

• node : 対象ノード
• otherNode : このノードが対象ノードの子孫ノードであるかを調べる

※ otherNode が node の子孫であるか node 自身の場合は戻り値は true に、その他の場合は false となります。

例

次の関数は、引数 (node) に指定した要素がそのページの body 要素の子孫であるかどうかを調べるものです。contains は自身をも含むため、isInPage という関数名の意図に沿うよう、明示的に body 要素を除外しています。

function isInPage(node) {
  return (node === document.body) ? false : document.body.contains(node);
}

ブラウザ実装状況

仕様

• DOM Level 4: contains

関連情報

• Node.hasChildNodes