XML DOM insertNode() Methode
Definition und Verwendung
Die insertNode() Methode fügt einen Knoten am Anfang des Bereichs ein.
Syntax:
insertNode(newNode)
Parameter
| Parameter | Beschreibung |
|---|---|
| newNode | der in das Dokument eingefügte Knoten sein soll. |
ausgeworfen
wenn newNode ist ein Attr-, Document-, Entity- oder Notation-Knoten, dann wird die Methode eine INVALID_NODE_TYPE_ERR-Ausnahme auswerfen RangeException-Ausnahme.
unter folgenden Bedingungen wird diese Methode eine DOMException-Ausnahme wie folgt auswerfen:
- HIERARCHY_REQUEST_ERR - Der Knoten am Anfang des Bereichs darf keine Unter Nodes haben, er darf auch keine Unter Nodes des angegebenen Typs haben oder newNode ist ein Vorfahrer dieses Knotens (oder der Knoten selbst).
- NO_MODIFICATION_ALLOWED_ERR - Der Knoten, der den Anfangspunkt des Bereichs enthält (oder ein Vorfahrer dieses Knotens), ist schreibgeschützt.
- WRONG_DOCUMENT_ERR - newNode unterschiedlich vom Dokument ist, zu dem der Bereich gehört.
Beschreibung
Diese Methode fügt den angegebenen Knoten (und alle seine Nachkommen) am Anfang des Dokumentbereichs ein. Wenn diese Methode zurückgegeben wird, umfasst der aktuelle Bereich die neu eingefügten Knoten. Wenn newNode bereits Teil des Dokuments, wird es von der aktuellen Position entfernt und dann am Anfang des Bereichs neu eingefügt. Wenn newNode ist DocumentFragment-Knoten, dann wird nicht es selbst, sondern seine Nachkommen nach Reihenfolge des Anfangspunkts des Bereichs eingefügt.
wenn der Knoten, der den Anfangspunkt des aktuellen Bereichs enthält, ein Text-Knoten ist, wird dieser vor der Insertionsoperation in zwei benachbarte Knoten gespalten. Wenn newNode ist ein Text-Knoten, der nach dem Einfügen in das Dokument nicht mit einem beliebigen benachbarten Text-Knoten zusammengefügt wird. Um benachbarte Knoten zu kombinieren, ist es erforderlich, Node.normalize() Methode.
