CKTIS / JavaScript
Array.prototype.findIndex : indice de la première correspondance
findIndex renvoie le premier indice au callback truthy, ou -1, et visite les trous comme undefined.
Version : ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
array.findIndex(callbackFn[, thisArg])array.findIndex(callbackFn[, thisArg]) appelle callbackFn(value, index, array) dans l’ordre croissant et renvoie l’indice entier au premier résultat truthy, pas la valeur. Sans correspondance, le résultat non ambigu est -1 ; un élément undefined trouvé ne se confond donc pas avec l’échec.
La longueur est fixée au début, mais chaque indice, y compris un trou lu comme undefined, est visité. Les modifications avant visite sont visibles, les ajouts ultérieurs hors longueur non. Callback non appelable ou receveur nullish lève TypeError ; une exception interrompt la méthode. L’exemple trouve volontairement un trou puis montre -1.
Exemples
const values = ["A", , "C"];
console.log(values.findIndex(value => value === undefined));
console.log(values.findIndex(value => value === "missing"));Résultat
1 -1