JavaScript Array filter()

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

filter() این روش آرایه‌ای ایجاد می‌کند که با تمام عناصر آرایه‌ای که از تست عبور کرده‌اند (به عنوان تابع ارائه شده) پر شده است.

نکته:filter() این تابع برای عناصر آرایه‌ای که هیچ مقداری ندارند، اجرا نمی‌شود.

نکته:filter() این آرایه اصلی را تغییر نمی‌دهد.

مثال

مثال 1

بازگرداندن آرایه‌ای از همه‌ی مقادیر خاصی که در آرایه ages قرار دارند:

var ages = [32, 33, 16, 40];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}

آزمایش کنید

مثال 2

بازگرداندن آرایه‌ای از همه‌ی مقادیر خاصی که در آرایه ages قرار دارند:

<p>سن حداقل: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">آزمایش کنید</button>
<p>تمام سن‌های بالاتر از حداقل: <span id="demo"></span></p>
<script>
var ages = [32, 33, 12, 40];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}
</script>

آزمایش کنید

قوانین دستور زبان

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

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

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

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

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

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

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

جزئیات فنی

مقدار بازگشتی: یک آرایه از تمام عناصر آرایه‌ای که از تست عبور کرده‌اند. اگر هیچ عنصری از تست عبور نکند، یک آرایه خالی بازمی‌گرداند.
نسخه JavaScript: ECMAScript 5

حمایت مرورگر

همه مرورگرها به طور کامل از آن حمایت می‌کنند filter() روش:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی 9.0 پشتیبانی پشتیبانی پشتیبانی پشتیبانی

صفحات مرتبط

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

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

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

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

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