★ wanayoo — archive 1999 https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/Array/lastIndexOfNouvelle recherche | Portail wanayoo
Vos résultats de recherche

    Méthode lastIndexOf

    Résumé

    Retourne le dernier index auquel l'élément renseigné peut être trouvé dans le tableau, ou -1 si il est absent. Le tableau est parcouru à l'envers, en commençant par fromIndex.

    Méthode de Array
    Implementé dans JavaScript 1.6
    Édition ECMAScript ECMAScript 5e édition

    Syntaxe

    array.lastIndexOf(searchElement[, fromIndex])

    Paramètre

    searchElement
    L'élément à chercher dans le tableau.
    fromIndex
    L'index à partir duquel commencer la recherche à l'envers. Par défaut la longueur du tableau, le tableau sera alors parcouru dans sa totalité. Si l'index est plus grand ou égal à la longueur du tableau, le tableau sera parcouru en entier. Si l'index est négatif, la recherche commencera d'autant d'éléments, à partir de la fin du tableau. A noter que même si l'index est négatif, la recherche s'effectue toujours de la fin jusqu'au début du tableau. Si l'index calculé est inférieur à 0, la méthode retournera -1, le tableau ne sera pas parcouru.

    Description

    lastIndexOf compare searchElement aux éléments contenus dans le tableau en utilisant une égalité stricte (la même méthode utilisée par l'opérateur ===).

    Compatibilité

    lastIndexOf est un ajout récent au standard ECMA-262 ; il peut donc ne pas être présent dans tous les navigateurs web. Vous pouvez contourner ce problème en insérant le code suivant au début de vos scripts. Il permet l'usage de lastIndexOf dans les navigateurs ne le supportant pas nativement. L'algorithme est le même que celui spécifié dans ECMA-262, 5e édition, assumant que Object, TypeError, Number, Math.floor, Math.abs, et Math.max ont leurs valeurs originales

    if (!Array.prototype.lastIndexOf)
    {
      Array.prototype.lastIndexOf = function(searchElement /*, fromIndex*/)
      {
        "use strict";
    
        if (this == null)
          throw new TypeError();
    
        var t = Object(this);
        var len = t.length >>> 0;
        if (len === 0)
          return -1;
    
        var n = len;
        if (arguments.length > 1)
        {
          n = Number(arguments[1]);
          if (n != n)
            n = 0;
          else if (n != 0 && n != (1 / 0) && n != -(1 / 0))
            n = (n > 0 || -1) * Math.floor(Math.abs(n));
        }
    
        var k = n >= 0
              ? Math.min(n, len - 1)
              : len - Math.abs(n);
    
        for (; k >= 0; k--)
        {
          if (k in t && t[k] === searchElement)
            return k;
        }
        return -1;
      };
    }
    

    Notez que cette implémentation vise une compatibilité absolue de lastIndexOf dans Firefox et le moteur JavaScript SpiderMonkey, incluant plusieurs cas très particuliers. Si vous comptez l'utiliser dans une application, vous devriez pouvoir calculer from avec un code beaucoup moins compliqué.

    Exemples

    Exemple: Utiliser lastIndexOf

    L'exemple suivant utilise lastIndexOf pour localiser des valeurs dans un tableau.

    var array = [2, 5, 9, 2];
    var index = array.lastIndexOf(2);
    // index est 3
    index = array.lastIndexOf(7);
    // index est -1
    index = array.lastIndexOf(2, 3);
    // index est 3
    index = array.lastIndexOf(2, 2);
    // index est 0
    index = array.lastIndexOf(2, -2);
    // index est 0
    index = array.lastIndexOf(2, -1);
    // index est 3
    

    Exemple: Trouver toutes les occurences d'un élément

    L'exemple suivant utilise lastIndexOf pour trouver tous les index d'un élément au sein d'un tableau, utilisant push pour les ajouter à un nouveau tableau à chaque occurence trouvé.

    var indices = [];
    var idx = array.lastIndexOf(element);
    
    while (idx != -1) {
      indices.push(idx);
      idx = (idx > 0 ? array.lastIndexOf(element, idx - 1) : -1);
    }
    

    Notez qu'il nous faut ici  prendre en compte le cas idx == 0 séparément, car l'élément sera toujours trouvé quelque que soit le paramètre fromIndex, si c'est le premier élément du tableau. Ceci est différent de la méthode indexOf.

    Compatibilité navigateurs

    Fonction Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Support de base (Oui) (Oui) 9 (Oui) (Oui)
    Fonction Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Support de base ? ? ? ? ? ?

    Voir aussi

    • indexOf, pour chercher à partir du début du tableau

    Étiquettes et contributeurs liés au document

    Contributeurs ayant participé à cette page : tregagnon, teoli
    Dernière mise à jour par : teoli,