DOMTokenList: contains() メソッド

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

構文

js
contains(token)

引数

token

リストの中に存在するかどうかを調べたいトークンを表す文字列です。

返値

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

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

最初に HTML です。

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

そして JavaScript です。

js
const span = document.querySelector("span");
span.textContent = span.classList.contains("c")
  ? "classList に 'c' が含まれています"
  : "classList に 'c' が含まれていません";

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

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser