عرض مصدر JavaScript/RangeError

<noinclude>{{DISPLAYTITLE:الكائن <code>RangeError</code> في JavaScript}}</noinclude>
الكائن <code>RangeError</code> يُشير إلى حدوث خطأ وقع عندما تكون قيمة متغير رقمي أو معاملٍ ما خارج المجال المسموح.
==البنية العامة==
<syntaxhighlight lang="javascript">
new RangeError([message])

</syntaxhighlight>

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

== الوصف ==
سيرمى الخطأ <code>RangeError</code> عند محاولة تمرير رقم كوسيط إلى دالة لا تعدّ هذا الرقم ضمن المجال المسموح للقيم التي تقبلها؛ وسيحدث ذلك عند محاولة إنشاء مصفوفة لها طول (<code>[[JavaScript/Array/length|length]]</code>) غير صحيح باستخدام الدالة البانية <code>[[JavaScript/Array|Array]]</code>، أو عند تمرير قيم غير صالحة إلى الدوال <code>[[JavaScript/Number/toExponential|Number.toExponential()]]‎</code> أو <code>[[JavaScript/Number/toFixed|Number.toFixed()‎]]</code> أو <code>[[JavaScript/Number/toPrecision|Number.toPrecision()]]</code>‎.

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

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

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

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

== الكائن prototype ==
=== الخاصيات ===

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

==== <code>[[JavaScript/Error/message|RangeError.prototype.message]]</code> ====
رسالة الخطأ. وعلى الرغم من أنَّ مواصفة ECMAScript تقول أنَّه يجب أن يوفِّر كائن <code>RangeError</code> قيمةً خاصةً به للخاصية <code>message</code>، لكنه يرث الخاصية <code>[[JavaScript/Error/message|Error.prototype.message]]</code> في أغلب محركات JavaScript.

==== <code>[[JavaScript/Error/name|RangeError.prototype.name]]</code> ====
اسم الخطأ. هذه الخاصية موروثة من <code>[[JavaScript/Error/name|Error.prototype.name]]</code>.

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

== أمثلة ==
سنرمي في المثال الآتي الاستثناء <code>RangeError</code> إذا كان الوسيط المُمرَّر إلى الدالة خارج النطاق المسموح:<syntaxhighlight lang="javascript">
var check = function(num) {
  if (num < MIN || num > MAX) {
    throw new RangeError('Parameter must be between ' + MIN + ' and ' + MAX);
  }
};

try {
  check(500);
}
catch (e) {
  if (e instanceof RangeError) {
    // معالجة الخطأ
  }
}
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-native-error-types-used-in-this-standard-rangeerror ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-native-error-types-used-in-this-standard-rangeerror ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.11.6.2 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%203rd%20edition,%20December%201999.pdf ECMAScript 3rd Edition] . 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Error]]