TypedArray.prototype.findIndex()

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 findIndex() Methode von TypedArray Instanzen gibt den Index des ersten Elements in einem Typ-Array zurück, das die bereitgestellte Testfunktion erfüllt. Wenn kein Element die Testfunktion erfüllt, wird -1 zurückgegeben. Diese Methode hat denselben Algorithmus wie Array.prototype.findIndex().

Probieren Sie es aus

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

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

console.log(int8.findIndex(isNegative));
// Expected output: 1

Syntax

js
findIndex(callbackFn)
findIndex(callbackFn, thisArg)

Parameter

callbackFn

Eine Funktion, die für jedes Element im Typ-Array 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 im Typ-Array verarbeitet wird.

index

Der Index des aktuellen Elements, das im Typ-Array verarbeitet wird.

array

Das Typ-Array, auf das findIndex() angewendet wurde.

thisArg Optional

Ein Wert, der als this beim Ausführen von callbackFn verwendet wird. Siehe iterative Methoden.

Rückgabewert

Der Index des ersten Elements im Typ-Array, das den Test besteht. Andernfalls -1.

Beschreibung

Siehe Array.prototype.findIndex() für mehr Details. Diese Methode ist nicht generisch und kann nur auf Typ-Array-Instanzen angewendet werden.

Beispiele

Finden Sie den Index der ersten Primzahl in einem Typ-Array

Das folgende Beispiel gibt den Index des ersten Elements im Typ-Array zurück, das eine Primzahl ist, oder -1, 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, 6, 8, 12]);
const uint16 = new Uint16Array([4, 6, 7, 12]);

console.log(uint8.findIndex(isPrime)); // -1, not found
console.log(uint16.findIndex(isPrime)); // 2

Spezifikationen

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

Browser-Kompatibilität

Siehe auch