JavaScript Array find()

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

find() يعود الوظيفة إلى قيمة العنصر الأول الذي يمر بالاختبار (المقدم كوظيفة)

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

  • إذا وجد عنصر في المجموعة يعود الوظيفة إلى صحيح، فإن find() يعود إلى قيمة العنصر هذا (ولن يتحقق من القيم المتبقية)
  • إلا إذا كان العنصر المطلوب غير معرف

التعليقات:find() لا تقوم بتشغيل هذه الوظيفة على المجموعات الفارغة.

التعليقات:find() لن يغير المجموعة الأصلية.

المثال

مثال 1

الحصول على قيمة العنصر الأول في المجموعة التي تساوي أو تزيد عن 18:

var ages = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(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.find(checkAdult);
}
</script>

تجربة شخصية

القواعد

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

قيمة المعامل

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

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

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

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

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

تفاصيل تقنية

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

دعم المتصفح

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

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

التعليقات:مستعرض الإنترنت لا يدعم find() الطريقة.

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

دليل:قائمة JavaScript

دليل:مستقر JavaScript

دليل:طريقة القوائم JavaScript

دليل:ترتيب القوائم JavaScript

دليل:تكرار القوائم JavaScript