عرض مصدر JavaScript/String/search

<noinclude>{{DISPLAYTITLE:<code>String.prototype.search()‎</code>}}</noinclude>
الدالة <code>String.prototype.search()‎</code> تبحث عن تعبيرٍ نمطيٍ (regular expression) في سلسلةٍ نصية.
==البنية العامة==
<syntaxhighlight lang="javascript">
str.search(regexp)

</syntaxhighlight>
=== <code>regexp</code> ===
كائن التعابير النمطية، وإذا مُرِّرَ كائن <code>obj</code> ليس من النوع <code>[[JavaScript/RegExp|RegExp]]</code>، فسيحوَّل إليه ضمنيًا باستخدام الدالة البانية <code>new RegExp(obj)‎</code>.

=== القيمة المعادة ===
فهرس أوّل مطابقة للتعبير النمطي في السلسلة النصية، أو القيمة -1 إن لم تكن هنالك مطابقة.

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

== أمثلة ==

=== استخدام <code>search()‎</code> ===
المثال الآتي يبحث عن تعبيرين نمطيين في سلسلة نصية، ويرينا مثالًا عن نجاح عملية البحث، وعن فشلها:<syntaxhighlight lang="javascript">
var str = "hey JudE";
var re = /[A-Z]/g;
var re2 = /[.]/g;
console.log(str.search(re)); // القيمة 4، لأنها فهرس أوّل حرف كبير
console.log(str.search(re2)); // القيمة -1 لعدم وجود نقطة في السلسلة النصية
</syntaxhighlight>
== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-string.prototype.search ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-string.prototype.search ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.5.4.12 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 String|{{SUBPAGENAME}}]]