Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.find : première valeur qui satisfait la condition

find renvoie la première valeur dont le callback est truthy, ou undefined en l’absence de correspondance.

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

Syntaxe

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) appelle callbackFn(value, index, array) depuis l’indice 0 et s’arrête au premier résultat truthy. Il renvoie la valeur testée, pas le résultat du callback. Sans correspondance il renvoie undefined, impossible à distinguer d’un élément undefined trouvé à partir du seul résultat.

La longueur est mémorisée au début. Chaque indice est visité et un trou est lu comme undefined. Une modification d’un élément ultérieur avant sa visite est visible, contrairement à un ajout après la longueur initiale. Callback non appelable ou receveur null/undefined lève TypeError; une exception se propage. L’exemple montre l’arrêt anticipé et le trou visité.

Exemples

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

Résultat

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

Sources