عرض مصدر JavaScript/Error

<noinclude>{{DISPLAYTITLE:الكائن <code>Error</code> في JavaScript}}</noinclude>
الدالة البانية <code>Error</code> تُنشِئ كائن خطأ، والنسخ الكائنات من النوع <code>Error</code> ستُرمى عند حدوث أخطاء في وقت التنفيذ (runtime errors)؛ لاحظ أنَّ الكائن <code>Error</code> يُستخدَم أيضًا ككائن أساس للاستثناءات التي يُعرَّفها المستخدم. انظر أدناه للحصول على قائمة بأنواع الأخطاء القياسية المُضمَّنة في اللغة.
==البنية العامة==
<syntaxhighlight lang="javascript">
new Error([message])

</syntaxhighlight>

=== <code>message</code> ===
وسيط اختياري، وهو وصفٌ نصيٌّ للخطأ موجَّهٌ للبشر.

== الوصف ==
الأخطاء التي تحدث في وقت التنفيذ (runtime errors) تؤدي إلى إنشاء ورمي كائنات <code>Error</code> جديدة. 

=== أنواع الأخطاء ===
بجانب الدالة البانية <code>Error</code> العامة، هنالك ست دوال بانية للأخطاء الرئيسية في JavaScript.

==== <code>[[JavaScript/EvalError|EvalError]]</code> ====
إنشاء كائن يُمثِّل أحد الأخطاء التي تقع عند استخدام الدالة العامة <code>[[JavaScript/eval|eval()‎]]</code>.

==== <code>[[JavaScript/RangeError|RangeError]]</code> ====
إنشاء كائن يُمثِّل أحد الأخطاء التي تقع عندما تكون قيمة متغير رقمي أو معاملٍ ما خارج المجال المسموح.

==== <code>[[JavaScript/ReferenceError|ReferenceError]]</code> ====
إنشاء كائن يُمثِّل أحد الأخطاء التي تقع عند محاولة الإشارة إلى مرجعية غير صحيحة.

==== <code>[[JavaScript/SyntaxError|SyntaxError]]</code> ====
إنشاء كائن يُمثِّل أحد الأخطاء التي تقع عند تفسير الشيفرات في الدالة  <code>[[JavaScript/eval|eval()]]‎</code>.

==== <code>[[JavaScript/TypeError|TypeError]]</code> ====
إنشاء كائن يُمثِّل أحد الأخطاء التي تقع عندما يكون نوع المتغير أو المعامل غير صحيح.

==== <code>[[JavaScript/URIError|URIError]]</code> ====
إنشاء كائن يُمثِّل أحد الأخطاء التي تقع عند تمرير وسائط غير صالحة إلى دالة <code>[[JavaScript/encodeURI|encodeURI()‎]]</code> أو <code>[[JavaScript/decodeURI|decodeURI()]]</code>‎.

== الخاصيات والدوال التابعة للدالة البانية <code>Error</code> ==

=== الخاصيات ===

==== <code>[[JavaScript/Error/prototype|Error.prototype]]</code> ====
تُمثِّل هذه الخاصية كائن prototype التابعة للكائن <code>Error</code>.

=== الدوال ===
الدالة البانية <code>Error</code> لا تملك أيّة دوال تابعة لها مباشرةً، وإنما ترث بعض الخاصيات عبر سلسلة prototype.

== الكائن prototype ==
جميع الكائنات من النوع <code>Error</code> ترث من الكائن <code>Error.prototype</code>؛ وكما في جميع الدوال البانية، يمكنك إجراء تغييرات إلى كائن prototype في الدالة البانية لكي تنعكس تلك التعديلات إلى جميع نسخ الكائن <code>Error</code>.

=== الخاصيات ===

==== <code>Error.prototype.constructor</code> ====
تُحديد الدالة التي ستُنشِئ كائن prototype لكائنات <code>Error</code>؛ راجع صفحة الخاصية<code>[[JavaScript/Object/constructor|Object.prototype.constructor]]</code> لمزيدٍ من التفاصيل.

==== <code>[[JavaScript/Error/message|Error.prototype.message]]</code> ====
رسالة الخطأ.

==== <code>[[JavaScript/Error/name|Error.prototype.name]]</code> ====
اسم الخطأ.

=== الدوال ===

====<code>[[JavaScript/Error/toString|Error.prototype.toString()‎]]</code>====
إعادة سلسلة نصيّة تُمثِّل الكائن المعني، وهي إعادة تعريف للدالة <code>[[JavaScript/Object/toString|Object.prototype.toString]]</code>.
== أمثلة ==

=== رمي خطأ عام ===
عادةً ما نُنشِئ كائنات <code>Error</code> لرميها باستخدام الكلمة المحجوزة <code>[[JavaScript/throw|throw]]</code>، يمكنك التعامل مع الخطأ باستخدام البنية <code>[[JavaScript/try...catch|try...catch]]</code>:<syntaxhighlight lang="javascript">
try {
  throw new Error('Whoops!');
} catch (e) {
  console.log(e.name + ': ' + e.message);
}

</syntaxhighlight>

=== التعامل مع خطأ من نوعٍ معيّن ===
إذا كنت تريد معالجة أخطاء من نوعٍ معيّن، فيمكنك اختبار نوع الخطأ باستخدام الخاصية <code>[[JavaScript/Object/constructor|constructor]]</code> التابعة لكائن الخطأ، أو باستخدام الكلمة المحجوزة <code>[[JavaScript/instanceof|instanceof]]</code>:<syntaxhighlight lang="javascript">
try {
  foo.bar();
} catch (e) {
  if (e instanceof EvalError) {
    console.log(e.name + ': ' + e.message);
  } else if (e instanceof RangeError) {
    console.log(e.name + ': ' + e.message);
  }
  // ...
}

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|6
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-error-objects ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-error-objects ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.11 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] . 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Error|{{SUBPAGENAME}}]]