KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Array.prototype.findIndex: index van de eerste treffer

findIndex retourneert de eerste index met truthy callback, of -1, en bezoekt gaten als undefined.

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

Syntax

array.findIndex(callbackFn[, thisArg])

array.findIndex(callbackFn[, thisArg]) roept callbackFn(value, index, array) oplopend aan en retourneert bij het eerste truthy resultaat de gehele index, niet de waarde. Zonder treffer is het eenduidige resultaat -1, zodat gevonden undefined niet wordt verward.

De lengte ligt eerst vast, maar elke index wordt bezocht, ook een gat gelezen als undefined. Wijzigingen vóór bezoek zijn zichtbaar; later toegevoegde indexen niet. Niet-aanroepbare callback of nullish ontvanger werpt TypeError; een uitzondering breekt af. Het voorbeeld vindt bewust een gat en toont afzonderlijk -1.

Voorbeelden

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

Resultaat

1
-1

Bronnen