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

<noinclude>{{DISPLAYTITLE:<code>String.prototype.indexOf()‎</code>}}</noinclude>
الدالة <code>String.prototype.indexOf()‎</code> تُعيد الفهرس الموجود ضمن كائن <code>[[JavaScript/String|String]]</code> الذي يستدعي الدالة والذي يكون موضع أوّل مُطابَقة للقيمة المُحدَّدة لهذه الدالة بدءًا من <code>fromIndex</code>، أو القيمة <code>‎-1</code> إن لم يُعثَر عليها.
==البنية العامة==
<syntaxhighlight lang="javascript">
str.indexOf(searchValue[, fromIndex])

</syntaxhighlight>
=== <code>searchValue</code> ===
السلاسل النصية التي نريد البحث عنها ومعرفة فهرسها.

=== <code>fromIndex</code> ===
قيمة اختيارية، وهي عددٌ صحيحٌ يُمثِّل الفهرس الذي سيبدأ البحث منه، والقيمة الافتراضية هي <code>0</code>. إذا كانت قيمة <code>fromIndex</code> أقل من <code>0</code> أو أكبر من <code>str.length</code>، فسيبدأ البحث عند الفهرس <code>0</code> أو <code>str.length</code> على التوالي وبالترتيب.

=== القيمة المعادة ===
فهرس موضع أوّل مطابَقة للسلسلة النصية <code>searchValue</code>، أو القيمة <code>‎-1</code> إن لم يُعثَر عليها.

== الوصف ==
تُرقَّم المحارف من بداية السلسلة النصية (أي من اليسار إلى اليمين في لغات LTR مثل الإنكليزية، ومن اليمين إلى اليسار في لغات RTL مثل العربية)، ويكون فهرس أوّل محرف هو <code>0</code>، ومحرف آخر عنصر هو <code>str.length -1</code>.<syntaxhighlight lang="javascript">
'Blue Whale'.indexOf('Blue');     //  0
'Blue Whale'.indexOf('Blute');    // -1
'Blue Whale'.indexOf('Whale', 0); //  5
'Blue Whale'.indexOf('Whale', 5); //  5
'Blue Whale'.indexOf('Whale', 7); // -1
'Blue Whale'.indexOf('');         //  0
'Blue Whale'.indexOf('', 9);      //  9
'Blue Whale'.indexOf('', 10);     // 10
'Blue Whale'.indexOf('', 11);     // 10

</syntaxhighlight>لاحظ أنَّ الدالة <code>indexOf()‎</code> حساسةٌ لحالة الأحرف، أي أنَّ التعبير الآتي سيُعيد القيمة ‎<code>-1</code>:<syntaxhighlight lang="javascript">
'Blue Whale'.indexOf('blue'); // -1

</syntaxhighlight>

=== التحقق من وجود سلسلة نصية ===
لاحظ أنَّ القيمة 0 لا تتحوّل إلى <code>true</code> والقيمة -1 لن تتحول إلى <code>false</code>؛ وبالتالي إذا أردنا التحقق من وجود سلسلة نصية داخل سلسلة نصية أخرى، فعلينا كتابة الشيفرة الآتية:<syntaxhighlight lang="javascript">
'Blue Whale'.indexOf('Blue') !== -1; // true
'Blue Whale'.indexOf('Bloe') !== -1; // false

</syntaxhighlight>انظر إلى الدالة <code>[[JavaScript/String/includes|String.prototype.includes()‎]]</code>، فهي تعمل نفس عمل الشيفرة السابقة، لكنها أُضيفَت إلى معيار ECMAScript 2015.

== أمثلة ==

=== استخدام <code>indexOf()‎</code> و <code>[[JavaScript/String/lastIndexOf|lastIndexOf()‎]]</code> ===
المثال الآتي يوظِّف الدالتين <code>indexOf()‎</code> و <code>[[JavaScript/String/lastIndexOf|lastIndexOf()‎]]</code> لتحديد مواضع القيم في السلسلة النصية <code>"Brave new world"</code>:<syntaxhighlight lang="javascript">
var anyString = 'Brave new world';

console.log('The index of the first w from the beginning is ' + anyString.indexOf('w'));
// 8
console.log('The index of the last w from the beginning is ' + anyString.lastIndexOf('w'));
// 10

console.log('The index of "new" from the beginning is ' + anyString.indexOf('new'));
// 6
console.log('The index of "new" from the end is ' + anyString.lastIndexOf('new'));
// 6

</syntaxhighlight>

=== حساسية حالة الأحرف ===
المثال الآتي يُعرِّف سلسلتين نصيتين، اللتان تحتويا على العبارة نفسها لكن مع بعض الاختلافات بحالة الأحرف. لاحظ من الناتج أنَّ الدالة <code>indexOf()‎</code> حساسة لحالة الأحرف:<syntaxhighlight lang="javascript">
var myString    = 'brie, pepper jack, cheddar';
var myCapString = 'Brie, Pepper Jack, Cheddar';

console.log('myString.indexOf("cheddar") is ' + myString.indexOf('cheddar'));
// 19
console.log('myCapString.indexOf("cheddar") is ' + myCapString.indexOf('cheddar'));
// -1

</syntaxhighlight>

=== إحصاء عدد مرات تكرار أحد المحارف ===
يمكننا استخدام الدالة <code>indexOf()‎</code> لمعرفة كم مرّة تكرر المحرف في السلسلة النصية، وذلك بإنشاء متغير باسم <code>count</code> الذي يحتوي على عدد مرات تكرار المحرف <code>e</code> في السلسلة النصية <code>str</code>، وباستخدام المعامل <code>fromIndex</code>:<syntaxhighlight lang="javascript">
var str = 'To be, or not to be, that is the question.';
var count = 0;
var pos = str.indexOf('e');

while (pos !== -1) {
  count++;
  pos = str.indexOf('e', pos + 1);
}

console.log(count); // 4

</syntaxhighlight>

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