这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

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

语法

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

参数

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

例外

案例

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]);

规范

规范 状态 注释
DOM
ChildNode.replacewith()
Living Standard Initial definition.

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Edge Opera Safari
Basic support 54.0 49 (49) 未实现[1] 未实现 39.0 未实现
Feature Android Webview Firefox Mobile (Gecko) IE Mobile Edge Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? 49.0 (49) 未实现 ? 39.0 未实现 54.0

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

参阅

文档标签和贡献者

标签: 
 此页面的贡献者: VictorDu
 最后编辑者: VictorDu,