定义和用法
findIndex() 方法返回传入一个测试条件(函数)符合条件的数组第一个元素位置。
findIndex()
方法为数组中的每个元素都调用一次函数执行:
- 当数组中的元素在测试条件时返回 true 时,
findIndex()
返回符合条件的元素的索引位置,之后的值不会再调用执行函数。 - 如果没有符合条件的元素返回 -1
注意:
findIndex()
对于空数组,函数是不会执行的。findIndex()
并没有改变数组的原始值。
语法
array.findIndex(function(currentValue, index, arr), thisValue)
参数
参数 | 描述 | ||||||||
---|---|---|---|---|---|---|---|---|---|
function(currentValue, index,arr) | 必须。数组每个元素需要执行的函数。 函数参数:
|
||||||||
thisValue | 可选。 传递给函数的值一般用 “this” 值。 如果这个参数为空, “undefined” 会传递给 “this” 值 |
浏览器支持
所有主流浏览器都支持findIndex()
方法。
注意: IE 11 及更早版本不支持 findIndex()
方法。
实例 1
获取数组中年龄大于等于 18 的第一个元素索引位置:
<button onclick="myFunction()">点我</button> <p id="demo"></p> <script> var ages = [3, 10, 18, 20]; function checkAdult(age) { return age >= 18; } function myFunction() { document.getElementById("demo").innerHTML = ages.findIndex(checkAdult); } </script>
输出结果:2
实例 2
返回符合大于输入框中数字的数组索引:
<p>点击按钮返回符合大于输入框中指定数字的数组元素索引。</p> <p>最小年龄: <input type="number" id="ageToCheck" value="18"></p> <button onclick="myFunction()">点我</button> <p>索引: <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>