عرض مصدر JavaScript/URIError

<noinclude>{{DISPLAYTITLE:الكائن <code>URIError</code> في JavaScript}}</noinclude>
الكائن <code>URIError</code> يُمثِّل أحد الأخطاء التي تقع عند تمرير وسائط غير صالحة إلى دالة <code>[[JavaScript/encodeURI|encodeURI()‎]]</code> (أو <code>[[JavaScript/encodeURIComponent|encodeURIComponent()‎]]</code>) أو <code>[[JavaScript/decodeURI|decodeURI()]]</code>‎ (أو <code>[[JavaScript/decodeURIComponent|decodeURIComponent()‎]]</code>)
==البنية العامة==
<syntaxhighlight lang="javascript">
new URIError([message])

</syntaxhighlight>

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

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

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

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

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

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

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

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

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

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

== أمثلة ==
سنحاول إنشاء شيفرة ترمي الخطأ <code>URIError</code> في المثال الآتي، وسنعالج الاستثناء باستخدام تعبير <code>[[JavaScript/try...catch|try...catch]]</code>:<syntaxhighlight lang="javascript">
try {
  decodeURIComponent('%');
} catch (e) {
  console.log(e instanceof URIError); // true
  console.log(e.message);             // "malformed URI sequence"
  console.log(e.name);                // "URIError"
}
</syntaxhighlight>سنبيّن مثالًا عن هذا الاستثناء برميه يدويًا باستخدام الكلمة المحجوزة <code>[[JavaScript/throw|throw]]</code>:<syntaxhighlight lang="javascript">
try {
  throw new URIError('Hello');
} catch (e) {
  console.log(e instanceof URIError); // true
  console.log(e.message);             // "Hello"
  console.log(e.name);                // "URIError"
}

</syntaxhighlight>

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