DOMTokenList: contains() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("DOM")}}

The **contains()** method of the {{domxref("DOMTokenList")}} interface returns a boolean value — true if the underlying list contains the given token, otherwise false.

Syntax

js-nolint
contains(token)

Parameters

  • token
  • : A string representing the token

you want to check for the existence of in the list.

Return value

A boolean value, which is true if the calling list contains token, otherwise false.

Examples

In the following example we retrieve the list of classes set on a {{htmlelement("span")}} element as a DOMTokenList using {{domxref("Element.classList")}}. We then test for the existence of "c" in the list, and write the result into the <span>'s {{domxref("Node.textContent")}}.

First, the HTML:

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

Now the JavaScript:

js
const span = document.querySelector("span");
span.textContent = span.classList.contains("c")
  ? "The classList contains 'c'"
  : "The classList does not contain 'c'";

The output looks like this:

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}