The replace()
method of the DOMTokenList
interface replaces an existing token with a new token.
Syntax
tokenList.remove(oldToken,newToken);
Parameters
- oldToken
- A
DOMString
representing the token you want to replace. - newToken
- A
DOMString
representing the token you want to replace oldToken with.
Return value
Void.
Examples
In the following example we retrieve the list of classes set on a <span>
element as a DOMTokenList
using Element.classList
. We then replace a token in the list, and write the list 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; try { classes.replace("c", "z"); span.textContent = classes; } catch(e) { span.textContent = e; }
The output looks like this:
Specifications
Specification | Status | Comment |
---|---|---|
DOM The definition of 'replace()' in that specification. |
Living Standard | Initial definition |