Iterator.prototype.some()

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

Синтаксис

some(callbackFn)

Параметры

callbackFn

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

element

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

index

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

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

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

Описание

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

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

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

Примеры

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

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().some(isEven)); // true

const isNegative = (x) => x < 0;
console.log(fibonacci().take(10).some(isNegative)); // false
console.log(fibonacci().some(isNegative)); // Never completes

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

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

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

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

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

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