KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Array.prototype.find: eerste waarde die aan de voorwaarde voldoet

find retourneert de eerste waarde met een truthy callbackresultaat, of undefined als niets past.

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

Syntax

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) roept callbackFn(value, index, array) vanaf index 0 aan en stopt bij het eerste truthy resultaat. Het retourneert de geteste waarde, niet het callbackresultaat. Zonder treffer is dat undefined, zodat alleen de uitkomst geen onderscheid maakt met een gevonden element undefined.

De lengte wordt eerst vastgelegd. Elke index wordt bezocht en een gat als undefined gelezen. Een later element dat vóór bezoek wijzigt is zichtbaar; toevoegen voorbij de beginlengte niet. Niet-aanroepbare callback of ontvanger null/undefined werpt TypeError; uitzonderingen worden doorgegeven. Het voorbeeld toont vroeg stoppen en een bezocht gat.

Voorbeelden

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("|"));

Resultaat

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

Bronnen