کدنویسی

XML DOM - شیء DOMException

اخطارها یا اطلاعیه‌هایی به اشیاء هسته‌ای DOM اطلاع داده می‌شوند.

مقدار مقدارهای ثابت زیر تعریف‌کننده‌های DOMException هستند: code

مقدارهای مجاز برای ویژگی‌ها.توضیح:

این متغیرهای ثابت جزئیات DOMException هستند، نه ویژگی هر خطای خاص.

توضیح اینکه خطای پرش از محدوده برای شمارنده‌های آرایه یا رشته‌ها انجام شده است.

DOMSTRING_SIZE_ERR

توضیح اینکه درخواست شده برای متن خیلی بزرگ است، و محدوده مشخص شده برای DOMString مناسب نیست.

HIERARCHY_REQUEST_ERR

توضیح اینکه عمل غیرقانونی برای قرار دادن یک نقطه در یک مکان غیرقانونی در ساختار درختی مستند انجام شده است.

WRONG_DOCUMENT_ERR

توضیح اینکه از یک نقطه در خارج از مستند ایجاد شده برای استفاده از آن نقطه استفاده شده است.

INVALID_CHARACTER_ERR

توضیح اینکه از کاراکترهای غیرقانونی استفاده شده است (مثلاً در نام یک عنصر).

NO_DATA_ALLOWED_ERR

تعیین داده برای یک Node که از داده‌های پشتیبانی نمی‌کند.

NO_MODIFICATION_ALLOWED_ERR

توضیح اینکه عمل تغییر یک نقطه خوانا و غیرقابل تغییر انجام شده است.

NOT_FOUND_ERR

توضیح اینکه نقطه مورد نظر در مکان مورد انتظار پیدا نشده است.

NOT_SUPPORTED_ERR

توضیح اینکه فعالیتی که در حال حاضر پشتیبانی نمی‌شود، برای یک ویژگی یا روش انجام شده است.

INUSE_ATTRIBUTE_ERR

توضیح اینکه وقتی یک نقطه Attr به یک نقطه Element متصل شده است، عمل متصل کردن یک نقطه Attr به یک نقطه Element انجام شده است.

INVALID_STATE_ERR

توضیح استفاده از اشیایی که در حال حاضر در حالت غیر مجاز قرار دارند یا دیگر مجاز نیستند.

SYNTAX_ERR

توضیح خطایی که شامل خطاهای گرامری است. معمولاً توسط بیان CSS属性 استفاده می‌شود.

INVALID_MODIFICATION_ERR

توضیح عملیاتی که شامل CSSRule اشیاء یا CSSValue اشیاء است.

NAMESPACE_ERR

توضیح خطایی که شامل نام‌ فضای یک عنصر یا ویژگی است.

INVALID_ACCESS_ERR

توضیح دسترسی به روشی که فعلاً توسط یک اجرا نمی‌پذیرفته شود.

ویژگی code

کد خطا. جزئیات دقیق دلیل ایجاد استثنا را ارائه می‌دهد. مقادیر مجاز این ویژگی (و معانی آنها) توسط متغیرهای ثابت ذکر شده در بالا تعریف شده‌اند.

توضیح

هنگامی که از یک属性 یا روش DOM به طور نادرست یا در محیط ناپسند استفاده می‌شود، یک استثنا DOMException پرتاب می‌شود. مقادیر property code توضیح می‌دهد که نوع استثنا رخ داده است. توجه داشته باشید که در هنگام خواندن یا نوشتن مقادیر属性 اشیاء یا فراخوانی روش‌های اشیاء، ممکن است استثنا DOMException پرتاب شود.

در بخش توضیحات属性 و روش‌های اشیاء در کتابخانه مرجع XML DOM ارائه شده توسط CodeW3C.com، استثناهایی که ممکن است پرتاب شوند لیست شده‌اند.

توجه داشته باشید که تمامی استثناهای DOM از DOMException اطلاع داده نمی‌شوند: استثناهایی که شامل ماژول DOM Range هستند، منجر به پرتاب استثنای RangeException می‌شوند.