ChildNode.replaceWith()

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

语法

[Throws, Unscopable] 
void ChildNode.replaceWith((Node or DOMString)... nodes);

参数

节点

一系列用来替换的Node 对象或者 DOMString 对象。

例外

• HierarchyRequestError: 无法在层次结构中的指定点插入节点。

案例

Using replaceWith()

var parent = document.createElement("div");
var child = document.createElement("p");
parent.appendChild(child);
var span = document.createElement("span");

child.replaceWith(span);

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

ChildNode.replaceWith() is unscopable

replaceWith()的方法并没有作用于with语句. 参考 Symbol.unscopables 获取更多信息.

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

Polyfill

你可以在IE9及更高级的浏览器中使用下面的代码向上兼容 replaceWith()的方法:

// from: https://github.com/jserz/js_piece/blob/master/DOM/ChildNode/replaceWith()/replaceWith().md
(function (arr) {
  arr.forEach(function (item) {
    if (item.hasOwnProperty('replaceWith')) {
      return;
    }
    Object.defineProperty(item, 'replaceWith', {
      configurable: true,
      enumerable: true,
      writable: true,
      value: function replaceWith() {
        var argArr = Array.prototype.slice.call(arguments),
          docFrag = document.createDocumentFragment();
        
        argArr.forEach(function (argItem) {
          var isNode = argItem instanceof Node;
          docFrag.appendChild(isNode ? argItem : document.createTextNode(String(argItem)));
        });
        
        this.parentNode.replaceChild(docFrag, this);
      }
    });
  });
})([Element.prototype, CharacterData.prototype, DocumentType.prototype]);

规范

浏览器兼容性

[1] IE浏览器支持非规范的HTMLElement.replaceNode方法; 参考 MSDN: replaceNode

参阅

• ChildNode 和 ParentNode
• Node.replaceChild()
• NodeList