ChildNode.before()

La méthode ChildNode.before insère un ensemble d'objets Node (noeud) ou DOMString (chaîne de caractères) dans la liste des enfants du parent du ChildNode, juste avant ce ChildNode. Des objets DOMString sont insérés comme noeuds équivalents à Text.

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

nodes

Un ensemble d'objets Node (noeud) ou DOMString (chaîne de caractères) à insérer.

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

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

child.before(span);

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

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

child.before("Text");

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

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

child.before(span, "Text");

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

La méthode before() n'est pas comprise dans l'instruction with. Voir Symbol.unscopables pour plus d'informations.

with(node) {
  before("foo");
}
// ReferenceError: before is not defined (before n'est pas défini)

Vous pouvez utiliser un polyfill pour la méthode before() dans Internet Explorer 9 et supérieur avec le code suivant :

// from: https://github.com/jserz/js_piece/blob/master/DOM/ChildNode/before()/before().md
(function (arr) {
  arr.forEach(function (item) {
    if (item.hasOwnProperty('before')) {
      return;
    }
    Object.defineProperty(item, 'before', {
      configurable: true,
      enumerable: true,
      writable: true,
      value: function before() {
        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.insertBefore(docFrag, this);
      }
    });
  });
})([Element.prototype, CharacterData.prototype, DocumentType.prototype]);

• ChildNode et ParentNode
• ChildNode.after()
• ParentNode.append()
• Node.appendChild()
• Node.insertBefore()
• NodeList