WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.find: erster Wert mit passender Bedingung

find liefert den ersten Wert mit truthy Callback-Ergebnis oder undefined, wenn nichts passt.

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

Syntax

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) ruft callbackFn(value, index, array) ab Index 0 auf und stoppt beim ersten truthy Ergebnis. Zurückgegeben wird der geprüfte Wert, nicht das Callback-Ergebnis. Ohne Treffer ist das Ergebnis undefined; allein daran lässt sich kein Treffer des Werts undefined erkennen.

Die Länge wird anfangs gespeichert. Jeder Index wird besucht, eine Lücke als undefined gelesen. Eine Änderung eines späteren Elements vor dessen Besuch ist sichtbar, ein Anhängen hinter der Anfangslänge nicht. Nicht aufrufbarer Callback oder Empfänger null/undefined löst TypeError aus; Callbackfehler werden weitergegeben. Das Beispiel zeigt frühen Abbruch und eine besuchte Lücke.

Beispiele

const values = [, 4, 8, 12];
const visited = [];
const found = values.find((value, index) => { visited.push(`${index}:${value}`); return value >= 8; });
console.log(found);
console.log(visited.join("|"));

Ergebnis

8
0:undefined|1:4|2:8

Quellen