filter()

Обновлено: 09.03.2023

Приклад 1

Повертає масив усіх значень у ages[] віком від 18 років:

const ages = [32, 33, 16, 40];
const result = ages.filter(checkAdult);

function checkAdult(age) {
  return age >= 18;
}

Визначення та використання

Метод filter()створює новий масив, заповнений елементами, які проходять перевірку, надану функцією.

Метод filter()не виконує функцію для порожніх елементів.

Метод filter()не змінює вихідний масив.

Синтаксис

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

Параметри

Parameter Опис
function() Обов'язково. Функція, що буде виконуватись для кожного елементу масиву.
currentValue Потрібно. Значення поточного елементу.
index Опціонально. Індекс поточного елементу.
arr Необов'язково. Масив, який містить поточний елемент.
thisValue Опціонально. За замовчуванням - "undefined". Значення, передане до функції як його значення "this".

Повернене значення

Тип Опис
Масив Містить елементи, які проходять перевірку. Якщо жоден елемент не пройшов перевірку, він повертає порожній масив.

Приклад 2

Повертає значення в ages[], які перевищують певне число:

<p><input type="number" id="ageToCheck" value="30"></p>

<button onclick="myFunction()">Try it</button>

<p id="demo"></p>

<script>
const ages = [32, 33, 12, 40];

function checkAge(age) {
  return age > document.getElementById("ageToCheck").value;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.filter(checkAge);
}
</script>

Підтримка браузера

filter

Посмотреть совместимость на Can I use?

filter