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 angegebene Testfunktion erfüllt. Wenn kein Wert die Testfunktion erfüllt, wird undefined zurückgegeben. Diese Methode verwendet 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

js
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 darauf hinzuweisen, 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 dem find() aufgerufen wurde.

thisArg Optional

Ein Wert, der als this verwendet wird, wenn callbackFn ausgeführt wird. Siehe iterative Methoden.

Rückgabewert

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

Beschreibung

Siehe Array.prototype.find() für weitere Details. Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen aufgerufen werden.

Beispiele

Finden Sie die erste Primzahl in einem typisierten Array

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

js
function isPrime(element, index, array) {
  let start = 2;
  while (start <= Math.sqrt(element)) {
    if (element % start++ < 1) {
      return false;
    }
  }
  return element > 1;
}

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch