Метод some()

Array.some()

Определяет, возвращает ли заданная функция обратного вызова значение true хо­тя­ бы­ для­ од­но­го­ эле­мен­та­ мас­си­ва­.

Синтаксис

array.some(function callback(currentValue, index, arr), thisValue)

Параметры

callback

Функцию обратного вызова, которая вызывается для каждого элемента в массиве, пока callback не вернет значение true или не будет достигнут конец массива, принимает три аргумента:

• currentValue – значение текущего элемента
• index – индекс массива текущего элемента.
• arr – массив, к которому принадлежит текущий элемент (по которому происходит проход).

thisValue

Необязательный параметр. Объект, на который может ссылаться ключевое слово this внутри функции обратного вызова. Если параметр thisValue не используется, то в качестве значения this будет использоваться undefined (в конечном итоге, значение this, наблюдаемое из функции callback, определяется согласно обычным правилам определения this, видимого из функции).

Возвращаемое значение

Значение true, если функция callback возвращает значение true для какого-либо элемента массива, в противном случае – значение false.

Описание

Метод some() вызывает функцию callback для каждого элемента массива (в порядке возрастания индекса), пока функция callback не вернет значение true. Если элемент, для которого функция callback возвращает значение true, найден, метод some() немедленно возвращает значение true (и не проверяет оставшиеся значения). Если обратный вызов не возвращает значения true ни для одного элемента, метод some() возвращает значение false.

Примеры

В следующем примере используется метод some(), чтобы выяснить, есть ли в массиве чётные числа:

В следующем примере показано использование второго параметра thisValue, задающего объект, к которому может относиться ключевое слово this внутри функции обратного вызова. Выполняется проверка, есть ли в массиве числа, находящиеся вне диапазона, предоставленного переданным объектом: