DOMTokenList.replace() - Web API 接口参考 编辑

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

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.