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