DOMTokenList: 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.

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
# ref-for-dom-domtokenlist-contains①

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
contains

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support