DOMTokenList: contains()-Methode

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.

Die contains()-Methode der DOMTokenList-Schnittstelle gibt einen booleschen Wert zurück — true, wenn die zugrunde liegende Liste das angegebene Token enthält, sonst false.

Syntax

js
contains(token)

Parameter

token

Ein String, der das Token darstellt, nach dessen Vorhandensein in der Liste Sie suchen möchten.

Rückgabewert

Ein boolescher Wert, der true ist, wenn die aufgerufene Liste token enthält, sonst false.

Beispiele

Im folgenden Beispiel rufen wir die Liste der Klassen ab, die an einem <span>-Element als DOMTokenList mit Element.classList gesetzt sind. Wir testen dann das Vorhandensein von "c" in der Liste und schreiben das Ergebnis in das Node.textContent des <span>.

Zuerst das HTML:

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

Nun das JavaScript:

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

Die Ausgabe sieht folgendermaßen aus:

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser