Array.prototype.lastIndexOf()
Метод lastIndexOf()
возвращает последний индекс, по которому данный элемент может быть найден в массиве или -1, если такого индекса нет. Массив просматривается от конца к началу, начиная с индекса fromIndex
.
Интерактивный пример
Синтаксис
arr.lastIndexOf(searchElement[, fromIndex = arr.length])
Параметры
searchElement
-
Искомый элемент в массиве.
fromIndex
-
Необязательный параметр. Индекс, с которого начинать поиск в обратном направлении. Если индекс больше или равен длине массива, просматривается весь массив. Если индекс является отрицательным числом, он трактуется как смещение с конца массива. Обратите внимание: если индекс отрицателен, массив всё равно просматривается от конца к началу. Если рассчитанный индекс оказывается меньше 0, массив даже не просматривается. Значение по умолчанию равно длине массива, что означает, что просматривается весь массив.
Описание
Метод lastIndexOf()
сравнивает искомый элемент searchElement
с элементами в массиве, используя строгое сравнение (en-US) (тот же метод используется оператором ===
, тройное равно).
Примеры
Пример: использование lastIndexOf()
В следующем примере метод lastIndexOf()
используется для поиска значений в массиве.
js
var array = [2, 5, 9, 2];
array.lastIndexOf(2); // 3
array.lastIndexOf(7); // -1
array.lastIndexOf(2, 3); // 3
array.lastIndexOf(2, 2); // 0
array.lastIndexOf(2, -2); // 0
array.lastIndexOf(2, -1); // 3
Пример: нахождение всех вхождений элемента
В следующем примере метод lastIndexOf()
используется для поиска всех индексов элемента в указанном массиве, которые с помощью метода push()
добавляются в другой массив.
js
var indices = [];
var array = ["a", "b", "a", "c", "a", "d"];
var element = "a";
var idx = array.lastIndexOf(element);
while (idx != -1) {
indices.push(idx);
idx = idx > 0 ? array.lastIndexOf(element, idx - 1) : -1;
}
console.log(indices);
// [4, 2, 0]
Обратите внимание, что мы обрабатываем случай idx == 0
отдельно, поскольку элемент всегда будет найден, независимо от параметра fromIndex
, если он является первым элементом в массиве. Этим он отличается от метода indexOf()
.
Полифил
Метод lastIndexOf()
был добавлен к стандарту ECMA-262 в 5-м издании; поэтому он может отсутствовать в других реализациях стандарта. Вы можете работать с ним, добавив следующий код в начало ваших скриптов, он позволяет использовать lastIndexOf()
в реализациях, которые не поддерживают этот метод. Этот алгоритм является точно тем, что описан в ECMA-262 5-го издания; он предполагает, что Object
, TypeError
, Number
, Math.floor()
, Math.abs()
и Math.min()
имеют свои первоначальные значения.
js
// Шаги алгоритма ECMA-262, 5-е издание, 15.4.4.15
// Ссылка (en): http://es5.github.io/#x15.4.4.15
// Ссылка (ru): http://es5.javascript.ru/x15.4.html#x15.4.4.15
if (!Array.prototype.lastIndexOf) {
Array.prototype.lastIndexOf = function (searchElement /*, fromIndex*/) {
"use strict";
if (this === void 0 || this === null) {
throw new TypeError();
}
var n,
k,
t = Object(this),
len = t.length >>> 0;
if (len === 0) {
return -1;
}
n = len - 1;
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));
}
}
for (k = n >= 0 ? Math.min(n, len - 1) : len - Math.abs(n); k >= 0; k--) {
if (k in t && t[k] === searchElement) {
return k;
}
}
return -1;
};
}
И снова обратите внимание, что данная реализация нацелена на абсолютную совместимость с методом lastIndexOf()
, реализованным в Firefox и движке JavaScript SpiderMonkey, включая несколько случаев, которые являются спорными крайними случаями. Если вы используете этот код в реальных приложениях, вы можете вычислять параметр from
менее сложным образом, игнорируя эти случаи.
Спецификации
Specification |
---|
ECMAScript Language Specification # sec-array.prototype.lastindexof |
Совместимость с браузерами
BCD tables only load in the browser
Замечания по совместимости
- Начиная с Firefox 47, метод больше не будет возвращать
-0
. Например,[0].lastIndexOf(0, -0)
теперь всегда будет возвращать+0
(Firefox bug 1242043).