--- title: DOMTokenList.contains() slug: Web/API/DOMTokenList/contains tags: - API - Contains - DOM - DOMTokenList - Method - Reference translation_of: Web/API/DOMTokenList/contains ---

{{APIRef("DOM")}}

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

構文

tokenList.contains(token);

引数

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

返値

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

次の例は、 {{htmlelement("span")}} 要素に設定されたクラスのリストを {{domxref("Element.classList")}} を使用して DOMTokenList として返します。 "c" がリスト中に存在することを確認し、その <span> の {{domxref("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'";
}

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

{{ EmbedLiveSample('Examples', '100%', 60) }}

仕様書

仕様書 状態 備考
{{SpecName('DOM WHATWG','#dom-domtokenlist-contains','contains()')}} {{Spec2('DOM WHATWG')}} 初回定義

ブラウザーの互換性

{{Compat("api.DOMTokenList.contains")}}