DOMTokenList.replace()

The replace() method of the DOMTokenList interface replaces an existing token with a new token.

Syntax

tokenList.replace(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

Browser compatibility