TypedArray.prototype.find()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Die find() Methode von TypedArray-Instanzen gibt das erste Element im angegebenen typisierten Array zurück, das die bereitgestellte Testfunktion erfüllt. Wenn keine Werte die Testfunktion erfüllen, wird undefined zurückgegeben. Diese Methode hat denselben Algorithmus wie Array.prototype.find().

Probieren Sie es aus

function isNegative(element, index, array) {
  return element < 0;
}

const int8 = new Int8Array([10, 0, -10, 20, -30, 40, -50]);

console.log(int8.find(isNegative));
// Expected output: -10

Syntax

find(callbackFn)
find(callbackFn, thisArg)

Parameter

callbackFn

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

element: Das aktuelle Element, das im typisierten Array verarbeitet wird.
index: Der Index des aktuellen Elements, das im typisierten Array verarbeitet wird.
array: Das typisierte Array, auf das find() aufgerufen wurde.

thisArg Optional

Ein Wert, der als this verwendet wird, wenn callbackFn ausgeführt wird. Weitere Informationen finden Sie unter iterative Methoden.

Rückgabewert

Das erste Element im typisierten Array, das die bereitgestellte Testfunktion erfüllt. Andernfalls wird undefined zurückgegeben.

Beschreibung

Weitere Details finden Sie unter Array.prototype.find(). Diese Methode ist nicht generisch und kann nur auf typisierte Array-Instanzen aufgerufen werden.

Beispiele

Das erste Primzahl im typisierten Array finden

Das folgende Beispiel gibt das erste Element im typisierten Array zurück, das eine Primzahl ist, oder undefined, wenn es keine Primzahl gibt.

function isPrime(n) {
  if (n < 2) {
    return false;
  }
  if (n % 2 === 0) {
    return n === 2;
  }
  for (let factor = 3; factor * factor <= n; factor += 2) {
    if (n % factor === 0) {
      return false;
    }
  }
  return true;
}

const uint8 = new Uint8Array([4, 5, 8, 12]);
console.log(uint8.find(isPrime)); // 5

Hinweis: Die isPrime()-Implementierung dient nur zur Demonstration. Für eine reale Anwendung sollten Sie einen stark memoisierten Algorithmus wie das Sieb des Eratosthenes verwenden, um wiederholte Berechnungen zu vermeiden.

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.find