CharacterData: before() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

Die before()-Methode der CharacterData-Schnittstelle fügt eine Menge von Node-Objekten und Zeichenfolgen in die Kindliste des Elternteils der CharacterData just vor dem CharacterData Knoten ein.

Zeichenfolgen werden als Text-Knoten eingefügt; die Zeichenfolge wird als Argument an den Text()-Konstruktor übergeben.

Syntax

before(...nodes)

Parameter

nodes: Eine Menge von Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

Ausgelöst, wenn die neuen Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden können, d.h. wenn eine der folgenden Bedingungen erfüllt ist:

Wenn das Einfügen eines der hinzugefügten Knoten zu einem Zyklus führen würde, d.h. wenn einer von ihnen ein Vorfahr dieses CharacterData-Knoten ist.
Wenn einer der hinzugefügten Knoten kein DocumentFragment, kein DocumentType, kein Element oder keine CharacterData ist.
Wenn dieser CharacterData-Knoten tatsächlich ein Text-Knoten ist und dessen Elternteil ein Document ist.
Wenn das Elternteil dieses CharacterData-Knotens ein Document ist und einer der einzufügenden Knoten ein DocumentFragment mit mehr als einem Element-Kind ist oder ein Text-Kind hat.

Beispiele

Die before()-Methode erlaubt es Ihnen, neue Knoten vor einem CharacterData-Knoten einzufügen, ohne die bisherigen Daten des Knotens zu ändern.

const h1TextNode = document.querySelector("h1").firstChild;
h1TextNode.before("h1# ");

h1TextNode.parentElement.childNodes;
// NodeList [#text "h1# ", #text "CharacterData.before()"]

h1TextNode.data;
// "CharacterData.before()"

Spezifikationen

Specification
DOM # ref-for-dom-childnode-before①