CharacterData: replaceWith() 方法

replaceWith() 是 CharacterData 接口的方法，它用一组 Node 对象或字符串替换其父级子列表中的此节点。

字符串作为 Text 节点插入；该字符串作为参数传递给 Text() 构造函数。

语法

js
replaceWith(...nodes)

参数

nodes 可选

一个用逗号分隔的 Node 对象或字符串列表，它们将替换当前节点。

注意：如果未传递任何参数，则此方法会将节点从 DOM 树中移除。

返回值

无 (undefined).

异常

HierarchyRequestError DOMException

当节点无法插入层次结构中的指定点时抛出。

示例

html
<p id="myText">Some text</p>
js
let text = document.getElementById("myText").firstChild;
let em = document.createElement("em");
em.textContent = "Italic text";

text.replaceWith(em); // Replace `Some text` by `Italic text`

规范

规范
DOM 标准
# ref-for-dom-childnode-replacewith①

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅