طريقة extractContents() من DOM XML

دليل مرجعي لـ Range

التعريف والاستخدام

ستقوم طريقة extractContents() بإزالة محتوى المستند وستعيد محتوى نود DocumentFragmentسيتم إرجاعها في شكل

النص

extractContents()

القيمة المعدة

نود نود DocumentFragment، يحتوي على محتوى النطاق

طرح

إذا كان المحتوى الذي يتم استخراجه من المستند قابلاً للقراءة فقط، ستقوم الطريقة بطرح استثناء يحتوي على رمز NO_MODIFICATION_ALLOWED_ERR استثناء DOMException.

إذا كان النطاق الحالي يشمل نود DocumentType، ستقوم الطريقة بطرح استثناء يحتوي على رمز HIERARCHY_REQUEST_ERR استثناء DOMException.

الوصف

ستقوم هذه الطريقة بإزالة النطاق المحدد من المستند وستعيد نودا تحتوي على المحتوى المزيل (أو نسخة من المحتوى المزيل) نود DocumentFragment. عند استدعاء هذه الطريقة، سيتم طي النطاق، ويمكن أن تظهر في المستند نودات Text متصلة (باستخدام طريقة normalize() للـ Node يمكن دمجها).

دليل مرجعي لـ Range