Método insertNode() del XML DOM
Definición y uso
El método insertNode() inserta un nodo en el principio del rango.
Sintaxis:
insertNode(newNode)
parámetro
| parámetro | Descripción |
|---|---|
| newNode | el nodo que se debe insertar en el documento. |
lanza
si newNode es un nodo Attr, Document, Entity o Notation, este método lanzará una excepción con el código INVALID_NODE_TYPE_ERR excepción RangeException.
Bajo las siguientes condiciones, este método también lanzará la excepción DOMException con el siguiente código:
- ERROR_DE_SOLICITUD_DE_HIERARQUÍA - El nodo de inicio del rango no puede tener nodos hijos, ni puede tener nodos hijos del tipo especificado, ni newNode Es un antepasado del nodo (o el nodo mismo).
- NO_MODIFICATION_ALLOWED_ERR - El nodo que contiene el punto de inicio del rango (o un antepasado del nodo) es de solo lectura.
- WRONG_DOCUMENT_ERR - newNode Diferente del documento al que pertenece el rango.
Descripción
Este método insertará el nodo especificado (y todos sus descendientes) en el punto de inicio del rango del documento. Al regresar este método, el rango actual incluirá los nodos insertados. Si newNode Ya es parte del documento, se eliminará desde la posición actual y se insertará nuevamente en el punto de inicio del rango. Si newNode Es Nodo DocumentFragment, entonces no se insertará él mismo, sino sus descendientes, insertados en orden en el punto de inicio del rango.
Si el nodo que contiene el punto de inicio del rango es un nodo Text, se dividirá en dos nodos adyacentes antes de la operación de inserción. Si newNode Es un nodo Text, después de insertar el documento, no se combinará con ningún nodo Text adyacente. Para combinar nodos adyacentes, es necesario llamar a Node.normalize() Métodos.
