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

Спецификация: ECMAScript 5.1 (ECMA-262)
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() не вызывает функцию callback для элементов массива без значений.

Примечание: Метод some() не изменяет исходный массив.

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

Выполнить код »

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

Выполнить код »

Комментарии

пожелания к комментариям…
  • Приветствуются комментарии, соответствующие теме урока: вопросы, ответы, предложения.
  • Одну строчку кода оборачивайте в тег <code>, несколько строчек кода — в теги <pre><code>...ваш код...</code></pre>.
  • Допускаются ссылки на онлайн-песочницы (codepen, plnkr, JSBin и др.).