The remove()
method of the DOMTokenList
interface removes the specified tokens from the list.
Syntax
tokenList.remove(token1[, token2[, ...tokenN]]);
Parameters
tokenN
- A
DOMString
representing the token you want to remove from the list. If the string is not in the list, no error is thrown, and nothing happens.
Return value
undefined
Examples
In the following example we retrieve the list of classes set on a <span>
element as a DOMTokenList
using Element.classList
. We then remove a token from the list, and write the list into the <span>
's Node.textContent
.
First, the HTML:
<span class="a b c"></span>
Now the JavaScript:
let span = document.querySelector("span"); let classes = span.classList; classes.remove("c"); span.textContent = classes;
The output looks like this:
To remove multiple classes at once, you can supply multiple tokens. The order you supply the tokens doesn't have to match the order they appear in the list:
let span2 = document.getElementsByTagName("span")[0] let classes2 = span.classList; classes2.remove("c", "b"); span2.textContent = classes;
Specifications
Specification | Status | Comment |
---|---|---|
DOM The definition of 'remove()' in that specification. |
Living Standard | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
remove | Chrome Full support 1 | Edge Full support 12 | Firefox Full support Yes | IE Full support 10 | Opera Full support Yes | Safari Full support 5.1 | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android Full support Yes | Safari iOS Full support 5.1 | Samsung Internet Android Full support Yes |
Multiple arguments for remove() | Chrome Full support 24 | Edge Full support 12 | Firefox Full support 26 | IE No support No | Opera Full support 15 | Safari Full support 7 | WebView Android Full support ≤37 | Chrome Android Full support 25 | Firefox Android Full support 26 | Opera Android Full support 14 | Safari iOS Full support 7 | Samsung Internet Android Full support 1.5 |
Legend
- Full support
- Full support
- No support
- No support