JavaScript Array findIndex()

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

findIndex() این عملکرد شماره‌ی نشانی اولین عنصری را که از تست عبور می‌کند بازمی‌گرداند (به عنوان عملکرد ارائه شده)

findIndex() این عملکرد عملکرد را برای هر عنصر موجود در آرایه یک بار اجرا می‌کند:

  • اگر عنصر آرایه‌ای پیدا شود که ارزش true را به عملکرد بازمی‌گرداند، 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>

آزمایش کنید:

نحوه نوشتن:

آرایه.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

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

صفحات مرتبط

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

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

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

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

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