DOMTokenList.replace()

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

语法

tokenList.replace(oldToken, newToken);

参数

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

返回值

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

Note: In older browsers, replace() returns void.

Examples

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

首先,HTML代码如下:

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

然后是JavaScript:

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 Status Comment
DOM
replace()
Living Standard Initial definition

浏览器兼容性

BCD tables only load in the browser