Array.prototype.findLastIndex()

Voir aussi la méthode findLast() qui renvoie la valeur du dernier élément qui satisfait au critère de la fonction de test (plutôt que son indice).

fnRappel

Une fonction utilisée pour tester les éléments du tableau.

La fonction est appelée avec les arguments suivants :

element

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

index

L'indice de l'élément courant dans le tableau.

array

Le tableau sur lequel findLastIndex() a été appelée.

La fonction de rappel doit renvoyer une valeur équivalente à true pour indiquer qu'un élément approprié a été trouvé. Ce sera l'indice de l'élément qui sera renvoyé par findLastIndex().

thisArg Facultatif

L'objet à utiliser comme valeur pour this lors de l'appel à fnRappel.

L'indice du dernier (celui avec l'indice le plus élevé) élément du tableau qui passe le test. Si aucun élément ne correspond, c'est -1 qui est renvoyé.

La méthode findLastIndex() exécute la fonction fnRappel une fois pour chaque élément du tableau, dans l'ordre décroissant des indices, jusqu'à ce que fnRappel renvoie une valeur équivalente à true. findLastIndex() renvoie alors l'indice de l'élément correspondant et arrête le parcours du tableau. Si fnRappel ne renvoie jamais de valeur équivalente à true, findLastIndex() renvoie -1.

fnRappel est appelée pour chaque indice du tableau et pas uniquement pour ceux pour lesquels une valeur a été affectée. Les emplacements vides des tableaux creux se comportent comme avec undefined.

Si un paramètre thisArg est fourni à findLastIndex(), il sera utilisé comme valeur pour this à chaque appel de fnRappel. S'il n'est pas fourni, undefined sera utilisé pour this.

La méthode findLastIndex() ne modifie pas le tableau sur lequel elle est appelée, mais la fonction fournie pour fnRappel peut le modifier. Les éléments traités par findLastIndex() sont fixés avant le premier appel à fnRappel. Ainsi :

• fnRappel ne parcourra pas les éléments ajoutés après le début de l'appel à findLastIndex().
• Les éléments qui sont affectés à des indices ayant déjà été visités ne seront pas revus par fnRappel.
• Les éléments qui sont affectés à des indices en dehors de l'intervalle du tableau ne seront pas parcourus par fnRappel.
• Si un élément existant du tableau et qui n'a pas encore été traité mais est modifié par fnRappel, la valeur qui sera passée à fnRappel sera la valeur au moment où findLastIndex() visite l'indice de l'élément.
• Les éléments qui sont supprimés avec delete sont tout de même parcourus.

La méthode findLastIndex() est générique. Elle s'attend uniquement à ce que la valeur this ait une propriété length et des propriétés dont les clés sont des entiers.

Dans l'exemple qui suit, on trouve l'indice du dernier élément du tableau qui est un nombre premier (ou on renvoie -1 si le tableau ne contient pas de nombre premier) :

function estPremier(element) {
  if (element % 2 === 0 || element < 2) {
    return false;
  }
  for (let diviseur = 3; diviseur <= Math.sqrt(element); diviseur += 2) {
    if (element % diviseur === 0) {
      return false;
    }
  }
  return true;
}

console.log([4, 6, 8, 12].findLastIndex(estPremier)); // -1, aucun nombre trouvé
console.log([4, 5, 7, 8, 9, 11, 12].findLastIndex(estPremier)); // 5

En cherchant undefined dans un tableau creux, on peut obtenir l'indice d'un emplacement vide.

console.log([1, , 3].findLastIndex((x) => x === undefined)); // 1

La méthode findLastIndex() lit la propriété length de this puis parcourt les propriétés dont les clés sont des nombres entiers.

const semblableTableau = {
  length: 3,
  0: 2,
  1: 7.3,
  2: 4,
};
console.log(
  Array.prototype.findLastIndex.call(semblableTableau, (x) =>
    Number.isInteger(x),
  ),
); // 2

• Une prothèse d'émulation pour Array.prototype.findLastIndex() dans la bibliothèque tierce core-js
• Array.prototype.findLast()
• Array.prototype.find()
• Array.prototype.indexOf()