La méthodefind() renvoie unevaleur du tableau typé si un élément du tableau remplit la condition définie par la fonction de test fournie. Si aucun élément ne remplit la condition, la valeurundefined sera renvoyée. Pour la suite de cet articleTypedArray correspond à l'un destypes de tableaux typés.

Voir également la page sur la méthohdefindIndex() qui renvoie l'indice de l'élément trouvé (et non sa valeur).

Exemple interactif

function isNegative(element, index, array) {  return element < 0;}const int8 = new Int8Array([10, 0, -10, 20, -30, 40, -50]);console.log(int8.find(isNegative));// Expected output: -10

Syntaxe

typedarray.find(callback[, thisArg])

Paramètres

callback

La fonction à exécuter pour chaque valeur du tableau typé. Elle prend trois arguments :

élément

L'élément du tableau typé en cours de traitement.

index

L'indice de l'élément du tableau typé en cours de traitement.

array

Le tableau sur lequel la méthodefind a été appelée.

thisArg

Paramètre optionnel, il correspond à l'objet à utiliser en tant quethis lors de l'exécution de la fonctioncallback.

Valeur de retour

Une valeur du tableau qui remplit la condition définie par la fonction de rappel,undefined sinon.

Description

La méthodefind exécute la fonctioncallback une fois pour chacun des éléments présents dans le tableau typé jusqu'à ce que la fonctioncallback renvoie une valeur vraie. Si un tel élément est trouvé,find retourne immédiatement la valeur de cet élément, sinonfind renvoieundefined.callback est appelée uniquement pour les indices du tableau typé qui possèdent une valeur, elle n'est pas appelée pour les indices qui ont été supprimés ou qui ne possèdent pas de valeurs.

callback est invoquée avec trois arguments : la valeur de l'élément, son indice et le tableau typé parcouru.

Si la paramètrethisArg est utilisé, il sera utilisé en tant quethis pour chaque appel àcallback. S'il n'est pas fourni, la valeurundefined sera utilisée.

find ne modifie pas le tableau typé sur lequel elle est appelé.

La liste des éléments traités parfind est définie avant le premier appel àcallback. Les éléments qui sont ajoutés au tableau typé après que l'appel àfind ait commencé ne seront pas traités parcallback. Si un élément du tableau qui n'a pas encore été traité est modifié par un appel précédent decallback, la valeur utilisée au moment où il est traité est celle qu'il aura lorsquefind atteindra cet indice. Les éléments qui sont supprimés ne sont pas traités par la fonction.

Exemples

Trouver un nombre premier

Dans l'exemple qui suit, on cherche un élément d'un tableau typé qui est un nombre premier (on renvoieundefined s'il n'y a pas de nombre premier).

function estPremier(élément, index, array) {  var début = 2;  while (début <= Math.sqrt(élément)) {    if (élément % début++ < 1) {      return false;    }  }  return élément > 1;}var uint8 = new Uint8Array([4, 5, 8, 12]);console.log(uint8.find(estPremier)); // 5

Spécifications

Compatibilité des navigateurs

Voir aussi

• TypedArray.prototype.findIndex()
• TypedArray.prototype.every()