DOMTokenList.replace()

oldToken

置き換えたいトークンを表す文字列です。

newToken

oldToken を置き換えたいトークンを表す文字列です。

論理値で、 oldToken の置き換えに成功した場合は true、それ以外の場合は false です。

以下の例では、 <span> 要素に設定されたクラスのリストを DOMTokenList として受け取るのに Element.classList を使用しています。それからリスト内のトークンを置き換え、リストを <span> の Node.textContent に書き込みます。

最初に HTML です。

<span class="a b c"></span>

そして JavaScript です。

const span = document.querySelector("span");
const classes = span.classList;

const result = classes.replace("c", "z");

if (result) {
  span.textContent = classes;
} else {
  span.textContent = 'token not replaced successfully';
}

出力結果は以下のようになります。