عرض مصدر JavaScript/Symbol/match

<noinclude>{{DISPLAYTITLE:<code>Symbol.match</code>}}</noinclude>
الرمز المعروف <code>Symbol.match</code> يُحدِّد إذا كان تعبيرٌ نمطيٌ (regular expression) يُطابِق سلسلةً نصيةً؛ وهذه الدالة تُستخدَم من الدالة <code>[[JavaScript/String/match|String.prototype.match()‎]]</code>.
{| class="wikitable"
! colspan="2" |سمات الخاصية Symbol.match
|-
|قابلة للكتابة
|لا
|-
|قابلة للإحصاء
|لا
|-
|قابلة للضبط
|لا
|}

== الوصف ==
تُستخدَم هذه الدالة أيضًا لمعرفة إن كان بالإمكان أن تسلك الكائنات سلوك التعابير النمطية؛ فمثلًا الدوال <code>[[JavaScript/String/startsWith|String.prototype.startsWith()]]</code>‎ و <code>[[JavaScript/String/endsWith|String.prototype.endsWith()]]</code>‎ و <code>[[JavaScript/String/includes|String.prototype.includes()]]</code>‎ تتحقق إن كان أوّل وسيط هو تعبيرٌ نمطي وسترمي الاستثناء <code>[[JavaScript/TypeError|TypeError]]</code> إذا لم يكن كذلك.

إذا ضبطنا الرمز <code>match</code> إلى <code>false</code> فذلك سيُشير إلى أنَّه من غير المفترض استخدام الكائن ككائن تعابير نمطية.

== أمثلة ==

=== تعطيل التحقق من التعبير النمطي <code>isRegExp</code> ===
تنفيذ الشيفرة الآتية سيؤدي إلى رمي <code>[[JavaScript/TypeError|TypeError]]</code>، ذلك لأنَّ السلسلة النصية '/bar/' ستُعدّ على أنها كائن تعابير نمطية:<syntaxhighlight lang="javascript">
'/bar/'.startsWith(/bar/); 
</syntaxhighlight>لكن إذا غيّرنا قيمة <code>Symbol.match</code> إلى <code>false</code>، فإنَّ الاختبار <code>isRegExp</code> (الذي يستخدم الخاصية <code>match</code>) سيُشير إلى أنَّ الكائن ليس كائن تعابير نمطية؛ وبالتلي لن ترمي الدالتان <code>[[JavaScript/String/startsWith|startsWith]]</code> و <code>[[JavaScript/String/endsWith|endsWith]]</code> الخطأ <code>TypeError</code> كما في المثال السابق:<syntaxhighlight lang="javascript">
var re = /foo/;
re[Symbol.match] = false;
'/foo/'.startsWith(re); // true
'/baz/'.endsWith(re);   // false

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|50
|40
|غير مدعومة
|نعم
|نعم
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-symbol.match ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-symbol.match ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Symbol|{{SUBPAGENAME}}]]