XML DOM insertNode() メソッド
定義と使用方法
insertNode() メソッドは範囲の先頭にノードを挿入します。
文法：
insertNode(newNode)
パラメータ
| パラメータ | 説明 |
|---|---|
| newNode | ドキュメントに挿入するノード。 |
スローします。
もし newNode Attr、Document、Entity、または Notation ノードの場合、INVALID_NODE_TYPE_ERR コードの RangeException 例外
以下の条件において、このメソッドは DOMException 例外をスローします：
- HIERARCHY_REQUEST_ERR - 複数の範囲の開始点のノードは子ノードを持つことができず、指定されたタイプの子ノードも持つことができません。 newNode はその祖先ノード（またはそのノード自身）です。
- NO_MODIFICATION_ALLOWED_ERR - 範囲の開始ポイントを含むノード（またはその祖先ノード）が読み取り専用である。
- WRONG_DOCUMENT_ERR - newNode 範囲が属するドキュメントと異なります。
説明
このメソッドは、指定されたノード（およびそのすべての孫ノード）をドキュメント範囲の開始ポイントに挿入します。このメソッドが返るとき、現在の範囲は新しい挿入されたノードを含みます。以下の条件が newNode 既にドキュメントの一部である場合、それが現在の場所から削除され、範囲の開始ポイントに再挿入されます。以下の条件が newNode は DocumentFragment ノード、
が含まれる現在の範囲の開始ポイントのノードが Text ノードである場合、挿入操作が発生する前に、それが2つの隣接するノードに分割されます。以下の条件が newNode は Text ノードであり、ドキュメントに挿入された後、隣接する Text ノードと合併しません。隣接するノードを合併するには、 Node.normalize() メソッド。
