[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/find [Back]  [Original]

TypedArray.prototype.find() - JavaScript | MDN

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 mthode find() renvoie une valeur du tableau typ si un lment du tableau remplit la condition dfinie par la fonction de test fournie. Si aucun lment ne remplit la condition, la valeur undefined sera renvoye. Pour la suite de cet article TypedArray correspond l'un des types de tableaux typs.

Voir galement la page sur la mthohde findIndex() qui renvoie l'indice de l'lment 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])

Paramtres

callback

La fonction excuter pour chaque valeur du tableau typ. Elle prend trois arguments :

lment

L'lment du tableau typ en cours de traitement.

index

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

array

Le tableau sur lequel la mthode find a t appele.

thisArg

Paramtre optionnel, il correspond l'objet utiliser en tant que this lors de l'excution de la fonction callback.

Valeur de retour

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

Description

La mthode find excute la fonction callback une fois pour chacun des lments prsents dans le tableau typ jusqu' ce que la fonction callback renvoie une valeur vraie. Si un tel lment est trouv, find retourne immdiatement la valeur de cet lment, sinon find renvoie undefined. callback est appele uniquement pour les indices du tableau typ qui possdent une valeur, elle n'est pas appele pour les indices qui ont t supprims ou qui ne possdent pas de valeurs.

callback est invoque avec trois arguments : la valeur de l'lment, son indice et le tableau typ parcouru.

Si la paramtre thisArg est utilis, il sera utilis en tant que this pour chaque appel callback. S'il n'est pas fourni, la valeur undefined sera utilise.

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

La liste des lments traits par find est dfinie avant le premier appel callback. Les lments qui sont ajouts au tableau typ aprs que l'appel find ait commenc ne seront pas traits par callback. Si un lment du tableau qui n'a pas encore t trait est modifi par un appel prcdent de callback, la valeur utilise au moment o il est trait est celle qu'il aura lorsque find atteindra cet indice. Les lments qui sont supprims ne sont pas traits par la fonction.

Exemples

Trouver un nombre premier

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

js
function estPremier(lment, index, array) {
  var dbut = 2;
  while (dbut <= Math.sqrt(lment)) {
    if (lment % dbut++ < 1) {
      return false;
    }
  }
  return lment > 1;
}

var uint8 = new Uint8Array([4, 5, 8, 12]);
console.log(uint8.find(estPremier)); // 5

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-%typedarray%.prototype.find

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page