DOMTokenList：replace() 方法

replace() 方法是 DOMTokenList 接口的一部分，用于将现有令牌替换为新令牌。如果第一个令牌不存在，则 replace() 会立即返回 false，而不会将新令牌添加到令牌列表中。

语法

js
replace(oldToken, newToken)

参数

oldToken

表示要替换的令牌的字符串。

newToken

表示要替换 oldToken 的令牌的字符串。

返回值

布尔值，如果 oldToken 成功替换，则为 true，否则为 false。

示例

在以下示例中，我们使用 Element.classList 从 <span> 元素上获取设置的类列表作为 DOMTokenList。然后我们替换列表中的一个令牌，并将列表写入 <span> 的 Node.textContent。

首先，HTML

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

现在是 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";

输出结果如下所示

规范

规范
DOM 标准
# ref-for-dom-domtokenlist-replace①

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。