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

TypedArray.prototype.findIndex() - 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.findIndex()

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 findIndex() renvoie un indice d'un lment d'un tableau typ si cet lment remplit une condition dfinie par une fonction de test donne. S'il n'y a aucun lment satisfaisant, -1 sera renvoy.

Voir aussi la mthode find() qui renvoie la valeur de l'lment trouv (au lieu de son indice).

Dans cet article

Exemple interactif

function isNegative(element, index, array) {
  return element < 0;
}

const int8 = new Int8Array([10, -20, 30, -40, 50]);

console.log(int8.findIndex(isNegative));
// Expected output: 1

Syntaxe

js
typedarray.findIndex(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 typ sur lequel la mthode findIndex a t appele.

thisArg

Paramtre optionnel, l'objet utiliser en tant que this pour les appels callback.

Valeur de retour

Un indice du tableau pour lequel l'lment remplit la condition dcrite par la fonction, -1 sinon.

Description

La mthode findIndex excute la fonction callback une fois pour chacun des lments prsent dans le tableau typ jusqu' ce que callback renvoie une valeur vraie pour un lment. Si un tel lment est trouv, findIndex retournera immdiatement l'indice de cet lment. Sinon, findIndex renverra -1. callback est appel uniquement pour les lments du tableau qui possdent une valeur, les lments qui ont t supprims ou qui n'ont pas de valeur ne sont pas traits.

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

Si un paramtre thisArg a t fourni findIndex, celui-ci sera utilis en tant que this pour chaque appel de callback. Dans le cas contraire, la valeur undefined sera utilise.

findIndex ne modifie pas le tableau typ sur lequel elle a t appele.

La liste des lments traits par findIndex est dfinie avant le premier appel callback. Les lments qui sont ajouts au tableau typs aprs que findIndex ait dbut ne sont pas traits par callback. Si un lment est modifi par un appel callback prcdent, la valeur passe callback lors du traitement sera celle au moment o findIndex traite l'indice de l'lment. Les lments qui sont supprims ne sont pas pris en compte.

Exemples

Dans l'exemple suivant, on utilise la mthode pour trouver l'indice d'un nombre premier dans le tableau typ (ou -1 dans le cas o 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, 6, 8, 12]);
var uint16 = new Uint16Array([4, 6, 7, 12]);

console.log(uint8.findIndex(estPremier)); // -1, non trouv
console.log(uint16.findIndex(estPremier)); // 2

Spcifications

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

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page