Thereplace() method of theDOMTokenList interfacereplaces an existing token with a new token.If the first token doesn't exist,replace() returnsfalse immediately,without adding the new token to the token list.

Syntax

replace(oldToken, newToken)

Parameters

oldToken

A string representing the token you want to replace.

newToken

A string representing the token you want to replaceoldToken with.

Return value

A boolean value, which istrue ifoldToken wassuccessfully replaced, orfalse if not.

Examples

In the following example we retrieve the list of classes set on a<span> element as aDOMTokenList usingElement.classList. We then replace a token in the list, and write thelist into the<span>'sNode.textContent.

First, the HTML:

<span></span>

Now the #"span");const classes = span.classList;const result = classes.replace("c", "z");span.textContent = result ? classes : "token not replaced successfully";