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
oldToken
with.
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