Сводка
Метод find()
возвращает значение первого найденного в массиве элемента, которое удовлетворяет условию переданному в callback функции. В противном случае возвращается undefined
.
Также смотрите метод findIndex()
, который возвращает индекс найденного в массиве элемента вместо его значения.
Если вам нужно найти позицию элемента или наличие элемента в массиве, используйте Array.prototype.indexOf()
или Array.prototype.includes()
соответственно.
Синтаксис
arr.find(callback[, thisArg])
Параметры
callback
- Функция, вызывающаяся для каждого значения в массиве, принимает три аргумента:
element
- Текущий обрабатываемый элемент в массиве.
index
- Индекс текущего обрабатываемого элемента в массиве.
array
- Массив, по которому осуществляется проход.
thisArg
- Необязательный параметр. Значение, используемое в качестве
this
при выполнении функцииcallback
.
Возвращаемое значение
Значение элемента из массива, если элемент прошёл проверку, иначе undefined
.
Описание
Метод find
вызывает переданную функцию callback
один раз для каждого элемента, присутствующего в массиве, до тех пор, пока она не вернёт true
. Если такой элемент найден, метод find
немедленно вернёт значение этого элемента. В противном случае, метод find
вернёт undefined
. До Firefox 34 функция callback
не вызывалась для «дырок» в массивах (bug 1058394).
Функция callback
вызывается с тремя аргументами: значением элемента, индексом элемента и массивом, по которому осуществляется проход.
Если в метод find
был передан параметр thisArg
, при вызове callback
он будет использоваться в качестве значения this
. В противном случае в качестве значения this
будет использоваться значение undefined
.
Метод find
не изменяет массив, для которого он был вызван.
Диапазон элементов, обрабатываемых методом find
, устанавливается до первого вызова функции callback
. Элементы, добавленные в массив после начала выполнения метода find
, не будут посещены функцией callback
. Если существующие, непосещённые элементы массива изменяются функцией callback
, их значения, переданные в функцию, будут значениями на тот момент времени когда метод find
посетит их; удалённые элементы все еще будут посещены.
Примеры
Пример: поиск простого числа в массиве
Следующий пример находит в массиве положительных чисел элемент, являющийся простым числом (либо возвращает undefined
, если в массиве нет простых чисел).
function isPrime(element, index, array) {
var start = 2;
while (start <= Math.sqrt(element)) {
if (element % start++ < 1) {
return false;
}
}
return element > 1;
}
console.log([4, 6, 8, 12].find(isPrime)); // undefined, не найдено
console.log([4, 5, 8, 12].find(isPrime)); // 5
Полифилл
Этот метод был добавлен в спецификации ECMAScript 6 и пока может быть недоступен во всех реализациях JavaScript. Однако, вы можете использовать следующий сниппет в качестве полифилла:
// https://tc39.github.io/ecma262/#sec-array.prototype.find
if (!Array.prototype.find) {
Object.defineProperty(Array.prototype, 'find', {
value: function(predicate) {
// 1. Let O be ? ToObject(this value).
if (this == null) {
throw new TypeError('"this" is null or not defined');
}
var o = Object(this);
// 2. Let len be ? ToLength(? Get(O, "length")).
var len = o.length >>> 0;
// 3. If IsCallable(predicate) is false, throw a TypeError exception.
if (typeof predicate !== 'function') {
throw new TypeError('predicate must be a function');
}
// 4. If thisArg was supplied, let T be thisArg; else let T be undefined.
var thisArg = arguments[1];
// 5. Let k be 0.
var k = 0;
// 6. Repeat, while k < len
while (k < len) {
// a. Let Pk be ! ToString(k).
// b. Let kValue be ? Get(O, Pk).
// c. Let testResult be ToBoolean(? Call(predicate, T, « kValue, k, O »)).
// d. If testResult is true, return kValue.
var kValue = o[k];
if (predicate.call(thisArg, kValue, k, o)) {
return kValue;
}
// e. Increase k by 1.
k++;
}
// 7. Return undefined.
return undefined;
},
configurable: true,
writable: true
});
}
Спецификации
Спецификация | Статус | Комментарии |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) Определение 'Array.prototype.find' в этой спецификации. |
Стандарт | Изначальное определение. |
ECMAScript (ECMA-262) Определение 'Array.prototype.find' в этой спецификации. |
Живой стандарт |
Совместимость с браузерами
BCD tables only load in the browser