DOMTokenList: replace() method
The replace() method of the DOMTokenList interface
replaces an existing token with a new token.
If the first token doesn't exist, replace() returns false immediately,
without adding the new token to the token list.
Syntax
js
replace(oldToken, newToken)
Parameters
oldToken-
A string representing the token you want to replace.
newToken-
A string representing the token you want to replace
oldTokenwith.
Return value
A boolean value, which is true if oldToken was
successfully replaced, or false if not.
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:
html
<span class="a b c"></span>
Now the JavaScript:
js
const span = document.querySelector("span");
const classes = span.classList;
const result = classes.replace("c", "z");
span.textContent = result ? classes : "token not replaced successfully";
The output looks like this:
Specifications
| Specification |
|---|
| DOM Standard # ref-for-dom-domtokenlist-replace① |
Browser compatibility
BCD tables only load in the browser