عرض مصدر JavaScript/RegExp/test

<noinclude>{{DISPLAYTITLE:<code>RegExp.prototype.test()‎</code>}}</noinclude>
الدالة <code>RegExp.prototype.test()‎</code> تجرى بحثًا عن مطابقة للتعبير النمطي في السلسلة النصية المُحدَّدة، وتُعيد <code>true</code> أو <code>false</code>.

== البنية العامة ==
<syntaxhighlight lang="javascript">
regexObj.test(str)

</syntaxhighlight>

=== <code>str</code> ===
السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها.

=== القيمة المعادة ===
إذا نجحت عملية المطابقة، فستُعيد الدالة <code>test()‎</code> القيمة <code>true</code>، وإن لم يكن التعبير النمطي موجودًا في السلسلة النصية فستُعيد القيمة <code>false</code>.

==الوصف==
الدالة <code>test()‎</code> تُحدِّد إن كان النمط موجودًا في السلسلة النصية أم لا، وستُعيد قيمة منطقيةً (<code>[[JavaScript/Boolean|Boolean]]</code>)، وذلك على النقيض من الدالة <code>[[JavaScript/String/search|String.prototype.search()‎]]</code> التي تُعيد فهرس المُطابَقة (أو القيمة ‎<code>-1</code> إن لم يكن التعبير النمطي موجودًا). للحصول على معلومات إضافية (لكن سيكون التنفيذ أبطأ) فاستخدم الدالة <code>[[JavaScript/RegExp/exec|exec()‎]]</code> (الشبيهة بالدالة <code>[[JavaScript/String/match|String.prototype.match()‎]]</code>).

وكما في الدالة <code>[[JavaScript/RegExp/exec|exec()‎]]</code>، يمكن استدعاء الدالة <code>test()‎</code> عدِّة مرات على كائن التعابير النمطية الذي ضُبِطَت فيه الراية "<code>g</code>" للحصول على المُطابَقة التالية للتعبير النمطي في السلسلة النصية.

== أمثلة ==

=== استخدام الدالة <code>test()‎</code> ===
هذا مثالٌ بسيطٌ يختبر وجود "hello" في بداية السلسلة النصية، وستُعيد الدالة قيمةً منطقيةً:<syntaxhighlight lang="javascript">
var str = 'hello world!';
var result = /^hello/.test(str);
console.log(result); // true
</syntaxhighlight>أما الدالة الآتية فتعرض رسالةً توضِّح إن كان النمط موجودًا في السلسلة النصية أم لا:<syntaxhighlight lang="javascript">
function testinput(re, str) {
  var midstring;
  if (re.test(str)) {
    midstring = ' contains ';
  } else {
    midstring = ' does not contain ';
  }
  console.log(str + midstring + re.source);
}

</syntaxhighlight>
=== استخدام الدالة <code>test()‎</code> مع تعبيرٍ نمطيٍ له الراية <code>g</code> ===
إذا امتلك التعبير النمطي الراية "<code>g</code>" (أي <code>[[JavaScript/RegExp/global|global]]</code>، التي تبحث عن جميع المطابقات في السلسلة النصية)، فستستكمل الدالة <code>test()‎</code> بحثها بدءًا من قيمة الخاصية <code>[[JavaScript/RegExp/lastIndex|lastIndex]]</code> التابعة لكائن <code>[[JavaScript/RegExp|RegExp]]</code>. المثال الآتي يوضِّح هذا السلوك: <syntaxhighlight lang="javascript">
var regex = /foo/g;

// regex.lastIndex: 0
regex.test('foo'); // true

// regex.lastIndex: 3
regex.test('foo'); // false

</syntaxhighlight>

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