大网数据广告活动
Web 标准与前端开发

DOMTokenList.replace()

· 52CE 我爱测

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

DOM

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

语法

replace(oldToken, newToken)

参数

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

返回值

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

[!NOTE] In older browsers, replace() returns void.

示例

在下面的例子中,我们使用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";
}

输出如下:

示例

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。