ChildNode.replaceWith()

Syntaxe

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

Paramètres

nodes

Un ensemble de Node ou d'objets DOMString à remplacer.

Exceptions

• HierarchyRequestError: Le noeud ne peut pas être inséré au point spécifié dans la hiérarchie.

Exemples

Utiliser replaceWith()

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

enfant.replaceWith(span);

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

ChildNode.replaceWith() ne peut être contextualisée

La méthode replaceWith() n'est pas contextualisée dans l'expression with. Voir Symbol.unscopables pour plus d'informations.

with(node) { 
  replaceWith("foo");
}
// ReferenceError: replaceWith n'est pas défini 

Prothèse d'émulation

Vous pouvez émuler la méthode replaceWith( ) pour Internet Explorer 9 et plus avec le code suivant :

// source : 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]);

Spécifications

Compatibilité des navigateurs

Voir aussi

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