TypedArray.prototype.find()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since septembre 2016.
La méthode find() renvoie une valeur 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 valeur undefined sera renvoyée. Pour la suite de cet article TypedArray correspond à l'un des types de tableaux typés.
Voir également la page sur la méthohde findIndex() 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
Valeur de retour
Une valeur du tableau qui remplit la condition définie par la fonction de rappel, undefined sinon.
Description
La méthode find exécute la fonction callback une fois pour chacun des éléments présents dans le tableau typé jusqu'à ce que la fonction callback renvoie une valeur vraie. Si un tel élément est trouvé, find retourne immédiatement la valeur de cet élément, sinon find renvoie undefined. 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ètre thisArg est utilisé, il sera utilisé en tant que this pour chaque appel à callback. S'il n'est pas fourni, la valeur undefined sera utilisée.
find ne modifie pas le tableau typé sur lequel elle est appelé.
La liste des éléments traités par find 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 par callback. Si un élément du tableau qui n'a pas encore été traité est modifié par un appel précédent de callback, la valeur utilisée au moment où il est traité est celle qu'il aura lorsque find 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 renvoie undefined 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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.find |
Compatibilité des navigateurs
Loading…