JavaScript find() 方法

Array 对象参考手册 JavaScript Array 对象

获取数组中年龄大于 18 的第一个元素

<p>点击按钮获取数组中年龄大于 18 的第一个元素。</p>

<button onclick="myFunction()">点我</button>

<p id="demo"></p>

<p><strong>注意:</strong> IE 11 及更早版本不支持 findIndex() 方法。</p>

<script>
  var ages = [3, 10, 18, 20];

  function checkAdult(age) {
    return age >= 18;
  }

  function myFunction() {
    document.getElementById("demo").innerHTML = ages.find(checkAdult);
  }
</script>

尝试一下 »


定义和用法

find() 方法返回传入一个测试条件(函数)符合条件的数组第一个元素。

find() 方法为数组中的每个元素都调用一次函数执行:

  • 当数组中的元素在测试条件时返回 true 时, find() 返回符合条件的元素,之后的值不会再调用执行函数。
  • 如果没有符合条件的元素返回 -1

注意: find() 对于空数组,函数是不会执行的。

注意: find() 并没有改变数组的原始值。


浏览器支持

表格中的数字表示支持该方法的第一个浏览器版本号。

方法
find() 45.0 12.0 25.0 7.1 32.0

注意: IE 11 及更早版本不支持 copyWithin() 方法。


语法

array.find(function(currentValue, index, arr), thisValue)

参数

参数 描述
function(currentValue, index,arr) 必需。数组每个元素需要执行的函数。
函数参数:
参数 描述
currentValue 必需。当前元素
index 可选。当前元素的索引值
arr 可选。当前元素所属的数组对象
thisValue 可选。 传递给函数的值一般用 "this" 值。
如果这个参数为空, "undefined" 会传递给 "this" 值

技术细节

返回值: 返回符合测试条件的第一个数组元素索引值,如果没有符合条件的则返回 undefined
JavaScript 版本: ECMAScript 6

更多实例

返回符合大于输入框中数字的数组索引值:

<p>点击按钮返回符合大于输入框中指定数字的数组元素。</p>
<p>最小年龄: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">点我</button>

<p>值: <span id="demo"></span></p>

<p><strong>注意:</strong> IE 11 及更早版本不支持 findIndex() 方法。</p>

<script>
  var ages = [4, 12, 16, 20];

  function checkAdult(age) {
    return age >= document.getElementById("ageToCheck").value;
  }

  function myFunction() {
    document.getElementById("demo").innerHTML = ages.find(checkAdult);
  }
</script>

尝试一下 »


Array 对象参考手册 JavaScript Array 对象