método XML DOM insertNode()
definição e uso
O método insertNode() insere um nó no início do intervalo.
sintaxe:
insertNode(newNode)
parâmetro
| parâmetro | Descrição |
|---|---|
| newNode | o nó a ser inserido no documento. |
lançar
se newNode é nó Attr, Document, Entity ou Notation, o método lançará exceção com código INVALID_NODE_TYPE_ERR exceção RangeException.
nas seguintes condições, o método também lançará a exceção DOMException com o seguinte código:
- ERRO_DE_REQUISIÇÃO_DE_HIERARQUIA - O nó de início do intervalo não pode ter filhos, nem pode ter filhos do tipo especificado, nem newNode É um ancestral do nó (ou o próprio nó).
- NO_MODIFICATION_ALLOWED_ERR - O nó que contém o ponto de início do intervalo (ou seu ancestral) é só leitura.
- WRONG_DOCUMENT_ERR - newNode Diferente do documento ao qual o intervalo pertence.
Descrição
Este método inserirá o nó especificado (e todos seus descendentes) no ponto de início do intervalo do documento. Quando este método retornar, o intervalo atual incluirá os nós novos inseridos. Se newNode Se já for parte do documento, ele será removido da posição atual e reinsertido no ponto de início do intervalo. Se newNode É Nó DocumentFragmententão a inserção não será feita no próprio, mas em seus descendentes, inserindo os pontos de início do intervalo na ordem.
Se o nó que contém o ponto de início do intervalo é um nó Text, ele será dividido em dois nós adjacentes antes da operação de inserção. Se newNode É um nó Text, após a inserção do documento, ele não se fundirá com qualquer nó Text adjacente. Para fundir nós adjacentes, é necessário chamar Node.normalize() Métodos.
