XML DOM extractContents() metod

Definition och användning

extractContents() metoden tar bort dokumentinnehållet och returnerar det med DocumentFragment objektform returnerar det.

Syntaks:

extractContents()

Returvärde

en DocumentFragment-noderinnehåll som omger denna range.

kasta

om det dokumentinnehåll som ska extraheras är skrivskyddat, kommer denna metod att kasta ett undantag med koden NO_MODIFICATION_ALLOWED_ERR DOMException-undantag.

om den aktuella range:n inkluderar DocumentType-noderdenna metod kommer att kasta ett undantag med koden HIERARCHY_REQUEST_ERR DOMException-undantag.

Beskrivning

Denna metod kommer att ta bort den specificerade range:n i dokumentet och returnera en DocumentFragment som innehåller det borttagna innehållet (eller en kopia av det borttagna innehållet) DocumentFragment-noderNär denna metod returneras, kommer området att falda ihop och det kan uppstå närliggande Text-noder (med Node.normalize() kan kombineras).