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) 必需。为数组中的每个元素运行的函数。

函数参数:

参数 描述
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>

亲自试一试

相关页面

教程:JavaScript 数组

教程:JavaScript 数组 Const

教程:JavaScript 数组方法

教程:JavaScript 排序数组

教程:JavaScript 数组迭代