عرض مصدر JavaScript/SyntaxError

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

</syntaxhighlight>

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

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

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

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

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

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

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

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

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

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

== أمثلة ==
سنحاول إنشاء شيفرة غير صحيحة بنيويًا باستخدام الدالة <code>[[JavaScript/eval|eval]]</code> في المثال الآتي، وسنعالج الاستثناء باستخدام تعبير <code>[[JavaScript/try...catch|try...catch]]</code>:<syntaxhighlight lang="javascript">
try {
  eval('hoo bar');
} catch (e) {
  console.log(e instanceof SyntaxError); // true
  console.log(e.message);                // "missing ; before statement"
  console.log(e.name);                   // "SyntaxError"
}
</syntaxhighlight>سنبيّن مثالًا عن هذا الاستثناء برميه يدويًا باستخدام الكلمة المحجوزة <code>[[JavaScript/throw|throw]]</code>:<syntaxhighlight lang="javascript">
try {
  throw new SyntaxError('Hello');
} catch (e) {
  console.log(e instanceof SyntaxError); // true
  console.log(e.message);                // "Hello"
  console.log(e.name);                   // "SyntaxError"
}

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-native-error-types-used-in-this-standard-syntaxerror ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-native-error-types-used-in-this-standard-syntaxerror ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.11.6.4 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]]