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:
<div id="ab" class="a b c"></div>
<div id="a" class="a b c"></div>
Now the JavaScript:
let span = document.getElementById("ab");
let classes = span.classList;
classes.remove("c");
span.textContent = classes;
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.getElementById("a")
let classes2 = span2.classList;
classes2.remove("c", "b");
span2.textContent = classes2;
The output looks like this:
Specifications
Specification | Status | Comment |
---|---|---|
DOMThe 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
remove
|
Chrome
Full support 8 |
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 3 |
Chrome Android
Full support 18 |
Firefox Android
Full support Yes |
Opera Android
Full support Yes |
Safari iOS
Full support 5.1 |
Samsung Internet Android
Full support 1.0 |
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
DOMTokenList.remove() by Mozilla Contributors is licensed under CC-BY-SA 2.5.