روش extractContents() DOM

تعریف و استفاده

روش extractContents() محتوای مستند را حذف می‌کند و با موضوع DocumentFragmentدر این شکل بازمی‌گردد.

شرح:

extractContents()

مقدار بازگشتی

یک Node DocumentFragment، شامل محتوای این محدوده.

پرتاب

اگر محتوایی که می‌خواهید استخراج کنید فقط خوانا است، این روش خطایی با کد NO_MODIFICATION_ALLOWED_ERR خواهد داشت. DOMException خطا.

اگر محدوده فعلی شامل Node DocumentType، این روش خطایی با کد HIERARCHY_REQUEST_ERR خواهید داشت. DOMException خطا.

توضیح

این روش محدوده مشخص شده در مستند را حذف می‌کند و یک Node شامل محتوای حذف شده (یا نسخه‌ای از محتوای حذف شده) را بازمی‌گرداند. Node DocumentFragmentوقتی که به این روش بازگردد، محدوده‌ها خمیده می‌شوند و ممکن است در مستند نزدیک به هم Text Node‌ها (با Node.normalize() می‌توانند با هم ترکیب شوند).