DOMTokenList.replace()

DOMTokenList接口的 replace() 方法可以将列表中一个已存在的 token 替换为一个新 token。如果第一个参数 token 在列表中不存在, replace() 立刻返回false ,而不会将新 token 字符串添加到列表中。

语法

js
replace(oldToken, newToken)

参数

oldToken

DOMString类型,想要替换掉的字符串。

newToken

DOMString类型,表示要将oldToken字符串替换成的字符串。

返回值

boolean 类型,如果oldToken被成功替换,返回 true ,否则返回false

备注: In older browsers, replace() returns void.

示例

在下面的例子中,我们使用Element.classList方法,将设置在<span> 元素上的 class 列表检索为DOMTokenList 类型。接着我们替换一个字符串,并且将新列表写入到 <span> 的内容Node.textContent中。

首先,HTML 代码如下:

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

然后是 JavaScript:

js
let span = document.querySelector("span");
let classes = span.classList;

let result = classes.replace("c", "z");
console.log(result);

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

输出如下:

规范

Specification
DOM Standard
# ref-for-dom-domtokenlist-replace①

浏览器兼容性

BCD tables only load in the browser