Iterator.prototype.every()

Метод every() экземпляров Iterator похож на Array.prototype.every(): он возвращает false, если находит элемент, который не удовлетворяет предоставленной тестовой функции. В противном случае, если итератор исчерпан без нахождения такого элемента, он возвращает true.

Синтаксис

every(callbackFn)

Параметры

callbackFn

Функция, выполняемая для каждого элемента, сгенерированного итератором. Она должна возвращать истинное (truthy) значение, чтобы указать, что элемент проходит тест, и ложное (falsy) значение в противном случае. Функция вызывается со следующими аргументами:

element

Текущий обрабатываемый элемент.

index

Индекс текущего обрабатываемого элемента.

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

true, если callbackFn возвращает истинное (truthy) значение для каждого элемента. В противном случае, false.

Описание

every() итерирует итератор и вызывает функцию callbackFn один раз для каждого элемента. Он немедленно возвращает false, если функция обратного вызова возвращает ложное (falsy) значение. В противном случае он итерирует до конца итератора и возвращает true. Если every() возвращает false, базовый итератор закрывается путем вызова его метода return().

Основное преимущество вспомогательных функций итератора перед методами массива заключается в том, что они являются ленивыми, то есть они производят следующее значение только по запросу. Это позволяет избежать ненужных вычислений, а также позволяет использовать их с бесконечными итераторами. С бесконечными итераторами every() возвращает false, как только найдено первое ложное (falsy) значение. Если callbackFn всегда возвращает истинное (truthy) значение, метод никогда не возвращается.

Вызов every() всегда закрывает базовый итератор, даже если метод возвращает значение досрочно. Итератор никогда не остается в промежуточном состоянии.

Примеры

Использование every()

function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

const isEven = (x) => x % 2 === 0;
console.log(fibonacci().every(isEven)); // false

const isPositive = (x) => x > 0;
console.log(fibonacci().take(10).every(isPositive)); // true
console.log(fibonacci().every(isPositive)); // Never completes

Метод закрывает итератор после возврата.

const seq = fibonacci();
console.log(seq.every(isEven)); // false
console.log(seq.next()); // { value: undefined, done: true }

Спецификации

Совместимость с браузерами

Смотрите также

• Полифил Iterator.prototype.every в core-js
• Полифил es-shims для Iterator.prototype.every
• Iterator
• Iterator.prototype.find()
• Iterator.prototype.some()
• Array.prototype.every()