روش detach() XML DOM

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

روش detach() یک موضوع Range را آزاد می‌کند.

نحوه‌ی استفاده:

detach()

پرتاب

مانند تمام روش‌های Range، اگر detach() موضوع Range که از قبل آزاد شده است فراخوانی شود، این روش استثنا‌ای با کد INVALID_STATE_ERR را پرتاب می‌کند. استثنا DOMException.

شرح

DOM تمام موضوعات Range‌ای که برای ایجاد مستند ایجاد شده را پیگیری می‌کند، زیرا در حال تغییر مرزهای موضوعات Range در حال تغییر مستند نیاز دارند. وقتی اطمینان حاصل کنید که موضوع Range دیگر استفاده نمی‌شود، می‌توانید روش detach() را فراخوانی کنید تا به سیستم اطلاع دهید که نیازی به پیگیری این موضوع نیست.

توجه:بعد از دعوت از روش detach() موضوع Range، استفاده مجدد از موضوع Range منجر به پرتاب استثنا می‌شود.

دعوت از detach() الزامی نیست، اما در صورت تغییر مستند، دعوت از آن می‌تواند عملکرد را بهبود بخشد.

موضوع Range فوری بازیافت نمی‌شود.