The contains()
method of the DOMTokenList
interface returns a Boolean
— true
if the underlying list contains the given token, otherwise false
.
tokenList.contains(token);
DOMString
representing the token you want to check for the existance of in the list.A Boolean
— true
if the underlying list contains the given token, otherwise false
.
In the following example we retrieve the list of classes set on a <span>
element as a DOMTokenList
using Element.classList
. We then test for the existance of "c" in the list, and write the result into the <span>
's Node.textContent
.
First, the HTML:
<span class="a b c"></span>
Now the JavaScript:
var span = document.querySelector("span"); var classes = span.classList; var result = classes.contains("c"); if(result) { span.textContent = "The classList contains 'c'"; } else { span.textContent = "The classList does not contain 'c'"; }
The output looks like this:
Specification | Status | Comment |
---|---|---|
DOM The definition of 'contains()' in that specification. | Living Standard | Initial definition |
Desktop | ||||||
---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | |
Basic support | Yes | 12 | Yes | 10 | Yes | Yes |
Mobile | |||||||
---|---|---|---|---|---|---|---|
Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
Basic support | Yes | Yes | ? | Yes | Yes | Yes | Yes |
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/contains