★ wanayoo — archive 1999 https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOfNouvelle recherche | Portail wanayoo

Help us test GitHub Sign-in on our stage server.

mozilla
Your Search Results

    Array.prototype.indexOf()

    Сводка

    Метод indexOf() возвращает первый индекс, по которому данный элемент может быть найден в массиве или -1, если такого индекса нет.

    Синтаксис

    arr.indexOf(searchElement[, fromIndex = 0])

    Параметры

    searchElement
    Искомый элемент в массиве.
    fromIndex
    Индекс, с которого начинать поиск. Если индекс больше или равен длины массива, возвращается -1, что означает, что массив даже не просматривается. Если индекс является отрицательным числом, он трактуется как смещение с конца массива. Обратите внимание: если индекс отрицателен, массив всё равно просматривается от начала к концу. Если рассчитанный индекс оказывается меньше 0, поиск ведётся по всему массиву. Значение по умолчанию равно 0, что означает, что просматривается весь массив.

    Описание

    Метод indexOf сравнивает искомый элемент searchElement с элементами в массиве, используя строгое сравнение (тот же метод используется оператором ===, тройное равно).

    Примеры

    Пример: использование indexOf

    В следующем примере indexOf используется для поиска значений в массиве.

    var array = [2, 5, 9];
    var index = array.indexOf(2);
    // index равен 0
    index = array.indexOf(7);
    // index равен -1
    index = array.indexOf(9, 2);
    // index равен 2
    index = array.indexOf(2, -1);
    // index равен -1
    index = array.indexOf(2, -3);
    // index равен 0
    

    Пример: нахождение всех вхождений элемента

    В следующем примере indexOf используется для поиска всех индексов элемента в указанном массиве, которые с помощью push добавляются в другой массив.

    var indices = [];
    var array = ['a', 'b', 'a', 'c', 'a', 'd'];
    var element = 'a';
    var idx = array.indexOf(element);
    while (idx != -1) {
      indices.push(idx);
      idx = array.indexOf(element, idx + 1);
    }
    
    console.log(indices);
    // [0, 2, 4]
    

    Полифилл

    Метод indexOf был добавлен к стандарту ECMA-262 в 5-м издании; поэтому он может отсутствовать в других реализациях стандарта. Вы можете работать с ним, добавив следующий код в начало ваших скриптов, он позволяет использовать indexOf в реализациях, которые не поддерживают этот метод. Этот алгоритм является точно тем, что описан в ECMA-262 5-го издания; он предполагает, что TypeError и Math.abs имеют свои первоначальные значения.

    // Шаги алгоритма ECMA-262, 5-е издание, 15.4.4.14
    // Ссылка (en): http://es5.github.io/#x15.4.4.14
    // Ссылка (ru): http://es5.javascript.ru/x15.4.html#x15.4.4.14
    if (!Array.prototype.indexOf) {
      Array.prototype.indexOf = function(searchElement, fromIndex) {
        var k;
    
        // 1. Положим O равным результату вызова ToObject с передачей ему
        //    значения this в качестве аргумента.
        if (this == null) {
          throw new TypeError('"this" is null or not defined');
        }
    
        var O = Object(this);
    
        // 2. Положим lenValue равным результату вызова внутреннего метода Get
        //    объекта O с аргументом "length".
        // 3. Положим len равным ToUint32(lenValue).
        var len = O.length >>> 0;
    
        // 4. Если len равен 0, вернём -1.
        if (len === 0) {
          return -1;
        }
    
        // 5. Если был передан аргумент fromIndex, положим n равным
        //    ToInteger(fromIndex); иначе положим n равным 0.
        var n = +fromIndex || 0;
    
        if (Math.abs(n) === Infinity) {
          n = 0;
        }
    
        // 6. Если n >= len, вернём -1.
        if (n >= len) {
          return -1;
        }
    
        // 7. Если n >= 0, положим k равным n.
        // 8. Иначе, n<0, положим k равным len - abs(n).
        //    Если k меньше нуля 0, положим k равным 0.
        k = Math.max(n >= 0 ? n : len - Math.abs(n), 0);
    
        // 9. Пока k < len, будем повторять
        while (k < len) {
          // a. Положим Pk равным ToString(k).
          //   Это неявное преобразование для левостороннего операнда в операторе in
          // b. Положим kPresent равным результату вызова внутреннего метода
          //    HasProperty объекта O с аргументом Pk.
          //   Этот шаг может быть объединён с шагом c
          // c. Если kPresent равен true, выполним
          //    i.  Положим elementK равным результату вызова внутреннего метода Get
          //        объекта O с аргументом ToString(k).
          //   ii.  Положим same равным результату применения
          //        Алгоритма строгого сравнения на равенство между
          //        searchElement и elementK.
          //  iii.  Если same равен true, вернём k.
          if (k in O && O[k] === searchElement) {
            return k;
          }
          k++;
        }
        return -1;
      };
    }
    

    Спецификации

    Спецификация Статус Комментарии
    ECMAScript 5.1 (ECMA-262)
    Определение 'Array.prototype.indexOf' в этой спецификации.
    Стандарт Изначальное определение. Реализована в JavaScript 1.6.
    ECMAScript 6 (ECMA-262)
    Определение 'Array.prototype.indexOf' в этой спецификации.
    Черновик  

    Совместимость с браузерами

    Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Базовая поддержка (Да) 1.5 (1.8) 9 (Да) (Да)
    Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Базовая поддержка (Да) (Да) 1.0 (1.8) (Да) (Да) (Да)

    Смотрите также

    Метки документа и участники

    На данную страницу внесли свой вклад: Mingun
    Обновлялась последний раз: Mingun,