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

Element.replaceWith()

· 52CE 我爱测

`ChildNode.replaceWith()`** 的方法用一套 Node 对象或者字符串对象,替换了该节点父节点下的子节点。字符串对象被当做等效的 Text 节点插入。

DOM

ChildNode.replaceWith() 的方法用一套 Node 对象或者字符串对象,替换了该节点父节点下的子节点。字符串对象被当做等效的 Text 节点插入。

语法

replaceWith(param1)
replaceWith(param1, param2)
replaceWith(param1, param2, /* …, */ paramN)

参数

  • param1、…、paramN
    • : 一系列用来替换的 Node 对象或者字符串对象。

异常

  • HierarchyRequestError DOMException
    • : 无法在层次结构中的指定节点处插入节点时抛出。

示例

使用 replaceWith()

const div = document.createElement("div");
const p = document.createElement("p");
div.appendChild(p);
const span = document.createElement("span");

p.replaceWith(span);

console.log(div.outerHTML);
// "<div><span></span></div>"

replaceWith() 是不可绑定作用域方法

replaceWith() 方法不能作用于 with 语句。参考 Symbol.unscopables 获取更多信息。

with (node) {
  replaceWith("foo");
}
// ReferenceError: replaceWith is not defined

规范

浏览器兼容性

参见

  • Node.replaceChild()
  • NodeList

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

资料来源与适用范围

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

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

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