Array.prototype.indexOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
indexOf()
方法返回数组中第一次出现给定元素的下标,如果不存在则返回 -1。
尝试一下
语法
js
indexOf(searchElement)
indexOf(searchElement, fromIndex)
参数
searchElement
-
数组中要查找的元素。
fromIndex
可选-
开始搜索的索引(从零开始),会转换为整数。
- 负索引从数组末尾开始计数——如果
frommindex < 0
,使用frommindex + array.length
。注意,在这种情况下,仍然从前到后搜索数组。 - 如果
fromIndex < -array.length
或者省略了fromIndex
,将使用0
,而导致整个数组被搜索。 - 如果
fromIndex >= array.length
,数组不会继续搜索并返回-1
。
- 负索引从数组末尾开始计数——如果
返回值
首个被找到的元素在数组中的索引位置; 若没有找到则返回 -1。
描述
示例
使用 indexOf()
以下例子使用 indexOf()
方法确定多个值在数组中的位置。
js
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
。
js
const array = [NaN];
array.indexOf(NaN); // -1
找出指定元素出现的所有位置
js
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]
判断一个元素是否在数组里,不在则更新数组
js
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.
在稀疏数组中使用 indexOf()
不能使用 indexOf()
在稀疏数组中搜索空槽。
js
console.log([1, , 3].indexOf(undefined)); // -1
在非数组对象上调用 indexOf()
indexOf()
方法读取 this
的 length
属性,然后访问每个整数索引。
js
const arrayLike = {
length: 3,
0: 2,
1: 3,
2: 4,
};
console.log(Array.prototype.indexOf.call(arrayLike, 2));
// 0
console.log(Array.prototype.indexOf.call(arrayLike, 5));
// -1
规范
Specification |
---|
ECMAScript Language Specification # sec-array.prototype.indexof |
浏览器兼容性
BCD tables only load in the browser