JavaScript Array findIndex()

التعريف والاستخدام

findIndex() يعود الدالة إلى فهرس العنصر الأول الذي يمر بالاختبار في البنية (كما تم توفير الدالة).

findIndex() يتم تنفيذ الدالة مرة واحدة لكل عنصر موجود في البنية:

  • إذا تم العثور على عنصر في البنية يعود إلى صحيح بالدالة، فإن findIndex() يعود إلى فهرس هذا العنصر في البنية (ونقوم بعد ذلك بعدم التحقق من القيم المتبقية)
  • بعد ذلك يعود -1

التعليقات:findIndex() لن يؤدي إلى تنفيذ الدالة على عنصر البنية الذي لا يحتوي على قيمة.

التعليقات:findIndex() لن يغير البنية الأصلية.

مثال

مثال 1

الحصول على فهرس العنصر الأول في البنية التي يساوي أو يتجاوز 18

var ages = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}

تجربة شخصية

مثال 2

الحصول على مؤشر العنصر الأول في المجموعة الذي يكون قيمته أعلى من عدد معين:

<p>الحد الأدنى من العمر: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">تجربة</button>
<p>أي أعمار أعلى من: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
</script>

تجربة شخصية

القواعد

array.findIndex(function(currentValue, index, arr, thisValue)

قيمة المعلمات

المعلمات الوصف
function(currentValue, index, arr) مطلوب. الدالة التي سيتم تشغيلها على كل عنصر في المجموعة.

معلمات الدالة:

المعلمات الوصف
currentValue مطلوب. قيمة العنصر الحالي.
index اختياري. مؤشر العنصر الحالي في المجموعة.
arr اختياري. الجسم الذي ينتمي إليه العنصر الحالي.
thisValue

اختياري. القيمة التي سيتم إرسالها إلى الدالة لتكون "this" الخاصة بها.

إذا كان هذا المعامل فارغًا، فإن القيمة "undefined" ستكون قيمة "this" الخاصة به.

تفاصيل تقنية

القيمة المعدة: إذا كانت أي عنصر في المجموعة قد اجتاز الاختبار، فإنه يعود إلى مؤشر عنصر المجموعة، وإلا يعود إلى -1.
إصدار JavaScript: ECMAScript 6

دعم المتصفح

الرقم في الجدول يوضح إصدار المتصفح الأول الذي يدعم هذه الطريقة بالكامل.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
سبتمبر 2015 يوليو 2015 يوليو 2014 سبتمبر 2014 سبتمبر 2015

التعليقات:Internet Explorer لا يدعم findIndex() الطريقة.

الصفحات ذات الصلة

دروس:جداول JavaScript

دروس:Const جداول JavaScript

دروس:طرق جداول JavaScript

دروس:ترتيب جداول JavaScript

دروس:تكرار جداول JavaScript