Array.prototype.indexOf()

¥Syntax

indexOf(searchElement)
indexOf(searchElement, fromIndex)

¥Parameters

searchElement

要在数组中定位的元素。

fromIndex Optional

开始搜索的从零开始的索引，转换为整数。

• 负索引从数组末尾开始倒数 — 如果使用 -array.length <= fromIndex < 0、fromIndex + array.length。请注意，在这种情况下，仍然从前往后搜索数组。
• 如果省略 fromIndex < -array.length 或 fromIndex，则使用 0，导致搜索整个数组。
• 如果是 fromIndex >= array.length，则不搜索数组并返回 -1。

¥Return value

数组中 searchElement 的第一个索引；如果未找到，则为 -1。

¥The first index of searchElement in the array; -1 if not found.

¥Description

indexOf() 方法使用 严格平等（与 === 运算符使用的算法相同）将 searchElement 与数组的元素进行比较。NaN 值永远不会被比较为相等，因此当 searchElement 为 NaN 时，indexOf() 始终返回 -1。

¥The indexOf() method compares searchElement to elements of the array using strict equality (the same algorithm used by the === operator). NaN values are never compared as equal, so indexOf() always returns -1 when searchElement is NaN.

indexOf() 方法跳过 稀疏数组 中的空槽。

¥The indexOf() method skips empty slots in sparse arrays.

indexOf() 方法是 generic。它只期望 this 值具有 length 属性和整数键控属性。

¥The indexOf() method is generic. It only expects the this value to have a length property and integer-keyed properties.

¥Examples

¥Using indexOf()

以下示例使用 indexOf() 来定位数组中的值。

¥The following example uses indexOf() to locate values in an array.

const array = [2, 9, 9];
array.indexOf(2); // 0
array.indexOf(7); // -1
array.indexOf(9, 2); // 2
array.indexOf(2, -1); // -1
array.indexOf(2, -3); // 0

你不能使用 indexOf() 来搜索 NaN。

¥You cannot use indexOf() to search for NaN.

const array = [NaN];
array.indexOf(NaN); // -1

¥Finding all the occurrences of an element

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

¥Finding if an element exists in the array or not and updating the array

function updateVegetablesCollection(veggies, veggie) {
  if (veggies.indexOf(veggie) === -1) {
    veggies.push(veggie);
    console.log(`New veggies collection is: ${veggies}`);
  } else {
    console.log(`${veggie} already exists in the veggies collection.`);
  }
}

const veggies = ["potato", "tomato", "chillies", "green-pepper"];

updateVegetablesCollection(veggies, "spinach");
// New veggies collection is: potato,tomato,chillies,green-pepper,spinach
updateVegetablesCollection(veggies, "spinach");
// spinach already exists in the veggies collection.

¥Using indexOf() on sparse arrays

你不能使用 indexOf() 搜索稀疏数组中的空槽。

¥You cannot use indexOf() to search for empty slots in sparse arrays.

console.log([1, , 3].indexOf(undefined)); // -1

¥Calling indexOf() on non-array objects

indexOf() 方法读取 this 的 length 属性，然后访问键为小于 length 的非负整数的每个属性。

¥The indexOf() method reads the length property of this and then accesses each property whose key is a nonnegative integer less than length.

const arrayLike = {
  length: 3,
  0: 2,
  1: 3,
  2: 4,
  3: 5, // ignored by indexOf() since length is 3
};
console.log(Array.prototype.indexOf.call(arrayLike, 2));
// 0
console.log(Array.prototype.indexOf.call(arrayLike, 5));
// -1

¥See also

• core-js 中 Array.prototype.indexOf 的 Polyfill
• 索引集合 指南
• Array
• Array.prototype.findIndex()
• Array.prototype.findLastIndex()
• Array.prototype.lastIndexOf()
• TypedArray.prototype.indexOf()
• String.prototype.indexOf()