DOMTokenList.contains()

contains()DOMTokenList インターフェイスのメソッドで、 Boolean を返します。 true は渡された token がそのリストに含まれていることを表し、そうでなければ false になります。

構文

tokenList.contains(token);

引数

token
DOMString で、リストの中に存在するかどうかを調べたいトークンを表します。

返値

Boolean で、 true は呼び出し元のリストに token が含まれていることを表し、そうでなければ false になります。

次の例は、 <span> 要素に設定されたクラスのリストを Element.classList を使用して DOMTokenList として返します。 "c" がリスト中に存在することを確認し、その <span>Node.textContent の中に結果を書き込みます。

最初に HTML です。

<span class="a b c"></span>

そして JavaScript です。

let span = document.querySelector("span");
let classes = span.classList;
let result = classes.contains("c");
if (result) {
  span.textContent = "The classList contains 'c'";
} else {
   span.textContent = "The classList does not contain 'c'";
}

出力結果は以下のようになります。

仕様書

仕様書 状態 備考
DOM
contains() の定義
現行の標準 初回定義

ブラウザーの互換性

BCD tables only load in the browser