← 返回首页
TypedArray.prototype.find() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Basculer la barre latérale
  1. Web
  2. JavaScript
  3. Référence
  4. Objets natifs standards
  5. TypedArray
  6. TypedArray.prototype.find()
Thème
  • Automatique
  • Clair
  • Sombre
Français
Se souvenir de la langue En savoir plus

Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

TypedArray.prototype.find()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis 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).

Dans cet article

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

js
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éthode find a été appelée.

thisArg

Paramètre optionnel, il correspond à l'objet à utiliser en tant que this lors de l'exécution de la fonction callback.

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).

js
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

Spécification
ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.find

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?
Oui Non
Apprendre à contribuer

Cette page a été modifiée le 24 juin 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu
  1. Objets natifs standards
  2. TypedArray
  3. Méthodes statiques
    1. TypedArray.from()
    2. TypedArray.of()
  4. Propriétés statiques
    1. TypedArray.BYTES_PER_ELEMENT
    2. get TypedArray[@@species]
  5. Méthodes d'instance
    1. TypedArray.prototype.at()
    2. TypedArray.prototype.copyWithin()
    3. TypedArray.prototype.entries()
    4. TypedArray.prototype.every()
    5. TypedArray.prototype.fill()
    6. TypedArray.prototype.filter()
    7. TypedArray.prototype.find()
    8. TypedArray.prototype.findIndex()
    9. findLast()
    10. findLastIndex()
    11. TypedArray.prototype.forEach()
    12. TypedArray.prototype.includes()
    13. TypedArray.prototype.indexOf()
    14. TypedArray.prototype.join()
    15. TypedArray.prototype.keys()
    16. TypedArray.prototype.lastIndexOf()
    17. TypedArray.prototype.map()
    18. TypedArray.prototype.reduce()
    19. TypedArray.prototype.reduceRight()
    20. TypedArray.prototype.reverse()
    21. TypedArray.prototype.set()
    22. TypedArray.prototype.slice()
    23. TypedArray.prototype.some()
    24. TypedArray.prototype.sort()
    25. TypedArray.prototype.subarray()
    26. TypedArray.prototype.toLocaleString()
    27. toReversed()
    28. toSorted()
    29. TypedArray.prototype.toString()
    30. TypedArray.prototype.values()
    31. with()
    32. TypedArray.prototype[@@iterator]()
  6. Propriétés d'instance
    1. TypedArray.prototype.buffer
    2. TypedArray.prototype.byteLength
    3. TypedArray.prototype.byteOffset
    4. TypedArray.prototype.length
  7. Héritage
  8. Object/Function
  9. Méthodes statiques
    1. apply()
    2. bind()
    3. call()
    4. toString()
    5. [Symbol.hasInstance]()
  10. Propriétés statiques
    1. displayName
    2. length
    3. name
    4. prototype
    5. arguments
    6. caller
  11. Méthodes d'instance
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  12. Propriétés d'instance
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
  13. Pages similaires
  14. BigInt64Array
  15. BigUint64Array
  16. Float16Array
  17. Float32Array
  18. Float64Array
  19. Int8Array
  20. Int16Array
  21. Int32Array
  22. Uint8Array
  23. Uint8ClampedArray
  24. Uint16Array
  25. Uint32Array

Votre modèle pour un internet meilleur.

MDN Contribuer Développeur·euse·s

Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.