Метод every()

Array.every()

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

Синтаксис

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() проверяет, является ли значение каждого элемента массива положительным числом. Поскольку массив не содержит отрицательных значений, эта метод возвращает true:

Примеры

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