JavaScript Array findIndex() 方法
实例
获取数组中第一个值等于或大于 18 的元素的索引：
var ages = [3, 10, 18, 20];
function checkAdult(age) {
return age >= 18;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
页面下方有更多 TIY 实例。
定义和用法
findIndex() 方法返回数组中通过测试的第一个元素的索引（作为函数提供）。
findIndex() 方法对数组中存在的每个元素执行一次函数：
- 如果找到函数返回 true 值的数组元素，则 findIndex() 返回该数组元素的索引（并且不检查剩余值）
- 否则返回 -1
注释：findIndex() 不会为没有值的数组元素执行函数。
注释：findIndex() 不会改变原始数组。
浏览器支持
表格中的数字注明了完全支持该方法的首个浏览器版本。
| Chrome | Edge | Firefox | Safari | Opera |
|---|---|---|---|---|
| Chrome 45 | Edge 12 | Firefox 25 | Safari 7.1 | Opera 32 |
| 2015 年 9 月 | 2015 年 7 月 | 2014 年 7 月 | 2014 年 9 月 | 2015 年 9 月 |
注释：Internet Explorer 不支持 findIndex() 方法。
语法
array.findIndex(function(currentValue, index, arr), thisValue)
参数值
| 参数 | 描述 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| function(currentValue, index, arr) | 必需。为数组中的每个元素运行的函数。
函数参数：
|
||||||||
| thisValue |
可选。要传递给函数以用作其 "this" 值的值。 如果此参数为空，则值 "undefined" 将作为其 "this" 值传递。 |
技术细节
| 返回值： | 如果数组中的任何元素通过测试，则返回数组元素索引，否则返回 -1。 |
|---|---|
| JavaScript 版本： | ECMAScript 6 |
更多实例
获取数组中第一个值高于特定数字的元素的索引：
<p>Minimum age: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Try it</button>
<p>Any ages above: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
</script>