JavaScript Array find()

تعریف و استفاده

find() این روش مقدار اولین عنصر آرایه‌ای که تست را پذیرفته را بازمی‌گرداند (به عنوان تابع ارائه شده)

find() این روش تابع را بر روی هر عنصر موجود در آرایه یک بار اجرا می‌کند:

  • اگر عناصر آرایه‌ای پیدا شود که تابع به بازگشت true دارد، find() مقدار عناصر آرایه را بازمی‌گرداند (و ارزش‌های باقی‌مانده را بررسی نمی‌کند)
  • در غیر این صورت undefined برمی‌گرداند

توضیحات:find() این تابع بر روی آرایه خالی اجرا نمی‌شود.

توضیحات:find() این تغییر در آرایه اصلی ایجاد نمی‌کند.

مثال

مثال 1

مقدار اولین عناصر آرایه که بزرگتر یا برابر با 18 است را بدست آورید:

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

آزمایش کنید:

نحوه استفاده:

آرایه.find(function(currentValue, index, arr, thisValue)

مقدار پارامتر

پارامترها: توضیحات:
تابع(currentValue, index, arr) ضروری. توابعی که برای هر عنصر موجود در آرایه اجرا می‌شود.

پارامترهای تابع:

پارامترها: توضیحات:
currentValue ضروری. مقدار عنصر فعلی.
index اختیاری. شماره‌ی شروع از آرایه‌ای که عنصر فعلی در آن قرار دارد.
arr اختیاری. آرایه‌ای که عنصر فعلی به آن تعلق دارد.
thisValue

اختیاری. مقداری که باید به عنوان مقدار "this" به تابع منتقل شود.

اگر این پارامتر خالی باشد، مقدار "undefined" به عنوان مقدار "this" به آن منتقل می‌شود.

جزئیات فنی

مقدار بازگشتی: اگر هیچ یک از عناصر موجود در آرایه از طریق تست عبور کند، مقدار عناصر آرایه را برمی‌گرداند، در غیر این صورت undefined را برمی‌گرداند.
نسخه جاوااسکریپت: ECMAScript 6

پشتیبانی مرورگر

اعداد در جدول نشان‌دهنده نسخه اولین مرورگر هستند که این روش را کاملاً پشتیبانی می‌کند.

کروم اندروید فایرفاکس سافاری اپرا
کروم 45 اندروید 12 فایرفاکس 25 سافاری 7.1 اپرا 32
شهریور 1394 شهریور 1394 مرداد 1393 شهریور 1393 شهریور 1394

توضیحات:اینترنت اکسپلورر پشتیبانی نمی‌کند find() روش.

صفحات مرتبط

آموزش:آرایه JavaScript

آموزش:ثابت آرایه JavaScript

آموزش:روش‌های آرایه JavaScript

آموزش:ترتیب‌دهی آرایه‌های JavaScript

آموزش:تکرار آرایه‌های JavaScript