Metode XML DOM insertNode()
Definisi dan Penggunaan
Metode insertNode() menambahkan node di awal scope.
Sintaksis:
insertNode(newNode)
Parameter
| Parameter | Deskripsi |
|---|---|
| newNode | Node untuk disisipkan ke dokumen. |
Melempar
Jika newNode Adalah node Attr, Document, Entity, atau Nasion, metode ini akan melempar kode INVALID_NODE_TYPE_ERR Eksepsi RangeException.
Dalam kondisi berikut, metode ini juga akan melempar eksepsi DOMException kode:
- HIERARCHY_REQUEST_ERR - Noda yang berisi awal kisaran tidak boleh memiliki node anak, ia juga tidak boleh memiliki node anak jenis yang ditentukan, atau newNode Adalah cikal bakal node ini (atau node ini sendiri).
- NO_MODIFICATION_ALLOWED_ERR - Node yang mengandung titik awal rentang (atau cikal bakalnya) adalah hanya baca.
- WRONG_DOCUMENT_ERR - newNode Yang berbeda dengan dokumen yang dimiliki rentang.
Deskripsi
Metode ini akan memasukkan node yang ditentukan (dan semua cikal bakalnya) ke titik awal rentang dokumen. Saat metode ini kembali, rentang saat ini akan termasuk node yang baru dimasukkan. newNode Sudah menjadi bagian dari dokumen, maka ia akan dihapus dari posisi saat ini dan diinsert kembali ke titik awal rentang. Jika newNode Adalah Node DocumentFragment, maka yang dimasukkan bukan adalah itu sendiri, tetapi cikal bakalnya, yang dimasukkan berurutan dari titik awal rentang.
Jika node yang mengandung titik awal rentang adalah node teks, maka sebelum operasi pemasukan terjadi, ia akan dipotong menjadi dua node teks yang berdekatan. Jika newNode Adalah node teks, setelah dimasukkan ke dalam dokumen, ia tidak akan disatukan dengan node teks yang berdekatan. Untuk mensatukan node yang berdekatan, perlu memanggil Node.normalize() Metode.
