Проверяет все ли элементы в массиве соответствуют условию заданному в передаваемой функции.

Спецификация: ECMAScript 5.1 (ECMA-262)
array.every(callbackfn(currentValue, index, arr), thisValue)

Параметры

callbackfn
Функция обратного вызова, которая будет выполнена один раз для каждого элемента в массиве. Функция принимает следующие параметры:
  • currentValue – текущий обрабатываемый элемент массива.
  • index – индекс текущего обрабатываемого элемента массива.
  • arr – массив, к которому принадлежит текущий элемент (по которому происходит проход).
Если в качестве параметра метода передается что-то, что не является объектом функции, то будет вызвано исключение TypeError.
thisArg
Необязательный параметр. Объект, на который может ссылаться ключевое слово this в функции callbackfn. Если аргумент thisArg опущен, в качестве значения this используется undefined (в конечном счете this будет зависеть от обычных правил контекста выполнения функции).

Значение true, если функция callbackfn возвращает значение true для всех элементов массива; в противном случае – значение false. Если массив не содержит элементов, метод every возвращает значение true.

Метод every() вызывает функцию callbackfn, переданную ему в качестве аргумента, один раз для каждого элемента, присутствующего в массиве:

  • Если он находит элемент массива, в котором функция возвращает ложное значение (значение, становящееся равным false при приведении его к типу Boolean), every() возвращает false (и не проверяет оставшиеся значения).
  • Если функция callbackfn вернёт true для всех элементов массива, метод every() вернёт true.

Функция обратного вызова callbackfn вызывается только для индексов массива, имеющих присвоенные значения. Она не вызывается для индексов, значения которых были удалены или которым значения вообще не присваивались.

На заметку: Метод every() не меняет исходный массив

В следующем примере метод every() проверяет, является ли значение каждого элемента массива положительным числом. Поскольку массив не содержит отрицательных значений, эта метод возвращает true:

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

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

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

Комментарии

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