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");
const classes = span.classList;
if (classes.contains("c")) {
  span.textContent = "classList に 'c' が含まれています";
} else {
  span.textContent = "classList に 'c' が含まれていません";
}

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

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser