WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.findIndex: Index des ersten Treffers

findIndex liefert den ersten Index mit truthy Callback oder -1 und besucht Lücken als undefined.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.findIndex(callbackFn[, thisArg])

array.findIndex(callbackFn[, thisArg]) ruft callbackFn(value, index, array) aufsteigend auf und liefert beim ersten truthy Ergebnis den ganzzahligen Index, nicht den Elementwert. Ohne Treffer ist das eindeutige Ergebnis -1; ein gefundenes undefined wird daher nicht verwechselt.

Die Länge steht anfangs fest, doch jeder Index darin wird besucht, auch eine als undefined gelesene Lücke. Änderungen vor dem Besuch sind sichtbar, später angehängte Indizes nicht. Nicht aufrufbarer Callback oder nullish Empfänger löst TypeError aus; eine Ausnahme bricht ab. Das Beispiel findet absichtlich eine Lücke und zeigt getrennt -1.

Beispiele

const values = ["A", , "C"];
console.log(values.findIndex(value => value === undefined));
console.log(values.findIndex(value => value === "missing"));

Ergebnis

1
-1

Quellen