DOMTokenList: replace() 方法

Baseline 已广泛支持

此功能已成熟,可跨多种设备和浏览器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有浏览器中可用。

DOMTokenList 接口的 replace() 方法用一个新令牌替换一个现有令牌。如果第一个令牌不存在,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①

浏览器兼容性