Iterator.prototype.find()

callbackFn

Eine Funktion, die für jedes vom Iterator erzeugte Element ausgeführt wird. Sie sollte einen truthy Wert zurückgeben, um anzuzeigen, dass ein übereinstimmendes Element gefunden wurde, und einen falsy Wert andernfalls. Die Funktion wird mit den folgenden Argumenten aufgerufen:

element

Das aktuelle Element, das verarbeitet wird.

index

Der Index des aktuellen Elements, das verarbeitet wird.

Das erste Element, das vom Iterator erzeugt wird und die bereitgestellte Testfunktion erfüllt. Andernfalls wird undefined zurückgegeben.

find() iteriert über den Iterator und ruft die callbackFn-Funktion einmal für jedes Element auf. Es gibt das Element sofort zurück, wenn die Callback-Funktion einen truthy Wert zurückgibt. Andernfalls wird bis zum Ende des Iterators iteriert und undefined zurückgegeben. Wenn find() ein Element zurückgibt, wird der zugrunde liegende Iterator durch Aufrufen seiner return() Methode geschlossen.

Der Hauptvorteil der Iterator-Hilfsfunktionen gegenüber den Array-Methoden ist ihre Fähigkeit, mit unendlichen Iteratoren zu arbeiten. Bei unendlichen Iteratoren gibt find() das erste übereinstimmende Element zurück, sobald es gefunden wird. Wenn callbackFn immer einen falsy Wert zurückgibt, gibt die Methode nie zurück.

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().find(isEven)); // 2

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

Das Aufrufen von find() schließt immer den zugrunde liegenden Iterator, selbst wenn die Methode frühzeitig zurückkehrt. Der Iterator bleibt nie in einem halbfertigen Zustand.

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

• Polyfill von Iterator.prototype.find in core-js
• Iterator
• Iterator.prototype.every()
• Iterator.prototype.some()
• Array.prototype.find()