XML DOM insertNode() yöntemi
Tanım ve Kullanım
insertNode() yöntemi, kapsamın başlangıcına bir düğüm ekler.
Gramer:
insertNode(newNode)
Parametre
Parametre | tanımı |
---|---|
newNode | Dokümana eklenecek düğüm. |
atma
Eğer newNode Attr, Document, Entity veya Notal düğüm ise, INVALID_NODE_TYPE_ERR koduyla RangeException istisnası.
Aşağıdaki koşullarda, bu yöntem DOMException istisnasını aşağıdaki kodla atmaktadır:
- HIERARCHY_REQUEST_ERR - Kapsam başlangıç noktası düğümünün alt düğüm olmamalı, aynı zamanda belirtilen türdeki alt düğüm de olmamalıdır veya newNode bu düğümün ata düğümü (veya bu düğüm kendisi).
- NO_MODIFICATION_ALLOWED_ERR - Aralığın başlangıç noktasını içeren düğüm (veya onun ata düğümleri) yalnızca okunabilir.
- WRONG_DOCUMENT_ERR - newNode aralığın ait olduğu belge ile farklıdır.
tanımı
Bu yöntem, belirtilen düğümü (ve hepsinin soy düğümlerini) belge aralığının başlangıç noktasına ekleyecektir. Bu yöntem geri döndüğünde, mevcut aralık, yeni eklenen düğümleri içerecektir. Eğer newNode zaten belge parçası ise, mevcut konumundan çıkarılacak ve aralığın başlangıç noktasına yeniden eklenecektir. Eğer newNode şudur DocumentFragment düğümüise, ekleme işlemi kendisi değil, sırayla aralığın başlangıç noktasına eklenen soy düğümler olacaktır.
mevcut aralığın başlangıç noktasını içeren düğüm Text düğümü ise, ekleme işlemi öncesinde iki yan yana düğüm olarak bölünecektir. Eğer newNode Text düğümü, belgeye eklendikten sonra, herhangi bir yan yana Text düğümü ile birleştirilmeyecektir. Yan yana düğümleri birleştirmek için Node.normalize() Yöntem.