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

<noinclude>{{DISPLAYTITLE:<code>RegExp.lastIndex</code>}}</noinclude>
الخاصية <code>RegExp.lastIndex</code> هي خاصيةٌ عدديةٌ تابعةٌ للكائنات من النوع <code>[[JavaScript/RegExp|RegExp]]</code> وتقبل القراءة والكتابة وتُحدِّد الفهرس الذي ستبدأ منه عملية البحث عن مطابقة.
{| class="wikitable"
! colspan="2" |سمات الخاصية RegExp.lastIndex
|-
|قابلة للكتابة
|نعم
|-
|قابلة للإحصاء
|لا
|-
|قابلة للضبط
|لا
|}
==البنية العامة==
<syntaxhighlight lang="javascript">
regExpObj.lastIndex

</syntaxhighlight>
== الوصف ==
ستُضبَط هذه الخاصية إذا احتوى التعبير النمطي على الراية "<code>g</code>" للإشارة إلى أنَّ البحث سيكون عامًّا في كامل السلسلة النصية، وستُطبَّق القواعد الآتية: 
* إذا كانت قيمة <code>lastIndex</code> أكبر من طول السلسلة النصية، فلن تعمل الدالتان <code>[[JavaScript/RegExp/test|test()‎]]</code> و <code>[[JavaScript/RegExp/exec|exec()‎]]</code> وبالتالي ستُضبَط قيمة <code>lastIndex</code> إلى <code>0</code>. 
* إذا كانت قيمة <code>lastIndex</code> تساوي طول السلسلة النصية، وإذا كان التعبير النمطي يُطابِق سلسلةً نصيةً فارغةً، فسيُطابِق التعبير النمطية السلسلة النصية بدءًا من <code>lastIndex</code>. 
* إذا كانت قيمة <code>lastIndex</code> تساوي طول السلسلة النصية وإذا لم يطابق التعبير النمطي السلسلةَ النصية الفارغة، فلن يُطابِق التعبير النمطي المدخلات، وسيُعاد ضبط <code>lastIndex</code> إلى <code>0</code>. 
* فيما عدا ذلك، ستُضبَط قيمة الخاصية <code>lastIndex</code> إلى الموضع التالي الذي فيه آخر مُطابَقة للتعبير النمطي. 

== أمثلة ==
لتكن لدينا السلسلة المتعاقبة من التعابير البرمجية:<syntaxhighlight lang="javascript">
var re = /(hi)?/g;

</syntaxhighlight>سيُطابِق هذا النمط:<syntaxhighlight lang="javascript">
console.log(re.exec('hi'));
console.log(re.lastIndex);

</syntaxhighlight>وسيُعيد <code>["hi", "hi"]</code> وستكون قيمة <code>lastIndex</code> مساويةً إلى <code>2</code>.<syntaxhighlight lang="javascript">
console.log(re.exec('hi'));
console.log(re.lastIndex);

</syntaxhighlight>سيُعيد <code>‎["", undefined]</code>‎، ويكون أوّل عنصر في هذه المصفوفة هو السلسلة النصية المُطابَقة، وهي سلسلة نصية فارغة في هذه الحالة، ذلك لأنَّ قيمة <code>lastIndex</code> كانت <code>2</code>، وطول السلسلة النصية <code>"hi"</code> هو <code>2</code>.

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