← 返回首页
Array.prototype.findIndex() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
切换侧边栏
  1. 面向开发者的 Web 技术
  2. JavaScript
  3. JavaScript 参考
  4. JavaScript 标准内置对象
  5. Array
  6. Array.prototype.findIndex()
主题
  • 跟随系统
  • 浅色
  • 深色
中文 (简体)
记住语言 了解更多

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Array.prototype.findIndex()

基线 广泛可用

自 2015年9月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

findIndex() 方法返回数组中满足提供的测试函数的第一个元素的索引。若没有找到对应元素则返回 -1。

另请参阅 find() 方法，它返回满足测试函数的第一个元素（而不是它的索引）。

本文内容

尝试一下

const array1 = [5, 12, 8, 130, 44]; const isLargeNumber = (element) => element > 13; console.log(array1.findIndex(isLargeNumber)); // Expected output: 3

语法

js
findIndex(callbackFn) findIndex(callbackFn, thisArg)

参数

callbackFn

为数组中的每个元素执行的函数。它应该返回一个真值以指示已找到匹配元素，否则返回一个假值。该函数被调用时将传入以下参数：

element

数组中当前正在处理的元素。

index

正在处理的元素在数组中的索引。

array

调用了 findIndex() 的数组本身。

thisArg 可选

执行 callbackFn 时用作 this 的值。参见迭代方法。

返回值

数组中第一个满足测试条件的元素的索引。否则返回 -1。

描述

findIndex() 是一种迭代方法。它按照索引升序依次遍历数组中的每个元素，并调用提供的 callbackFn 函数，直到 callbackFn 返回一个真值。然后 findIndex() 返回该元素的索引并停止遍历数组。如果 callbackFn 从未返回一个真值，则 findIndex() 返回 -1。

callbackFn 被调用来处理数组的每一个索引，而不仅仅是那些有值的索引。在稀疏数组中，未赋值的空槽与 undefined 表现相同。

findIndex() 不会改变被调用的数组，但是提供给 callbackFn 的函数可能会改变它。但需要注意的是，在第一次调用 callbackFn 之前，数组的长度会被保存。因此：

  • 当调用 findIndex() 时，callbackFn 不会访问超出数组初始长度的任何元素。
  • 对已经访问过的索引的更改不会导致再次在这些元素上调用 callbackFn。
  • 如果 callbackFn 改变了数组中已存在但尚未被访问的元素，则传递给 callbackFn 的该元素的值将是该元素在被访问时的值。被删除的元素被视为 undefined。

警告：上述类型的并发修改经常导致难以理解的代码，通常应避免（特殊情况除外）。

findIndex() 方法是通用的。它只期望 this 值具有 length 属性和整数键属性。

示例

寻找数组中的首个素数的索引

以下示例返回数组中第一个素数的索引，如果没有素数则返回 -1。

js
function isPrime(n) { if (n < 2) { return false; } if (n % 2 === 0) { return n === 2; } for (let factor = 3; factor * factor <= n; factor += 2) { if (n % factor === 0) { return false; } } return true; } console.log([4, 6, 8, 9, 12].findIndex(isPrime)); // -1，没有找到 console.log([4, 6, 7, 9, 12].findIndex(isPrime)); // 2（array[2] 是 7）

备注：isPrime() 实现仅供演示。在实际应用中，为了避免重复计算，会使用大量记忆化的算法，例如埃拉托斯特尼筛法。

在稀疏数组上使用 findIndex()

你可以搜索稀疏数组中的 undefined 并来获取空槽的索引。

js
console.log([1, , 3].findIndex((x) => x === undefined)); // 1

在非数组对象上调用 findIndex()

findIndex() 方法读取 this 的 length 属性，并访问每个整数索引。

js
const arrayLike = { length: 3, 0: 2, 1: 7.3, 2: 4, }; console.log( Array.prototype.findIndex.call(arrayLike, (x) => !Number.isInteger(x)), ); // 1

规范

规范
ECMAScript® 2027 Language Specification
# sec-array.prototype.findindex

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

帮助改进 MDN

此页面对您有帮助吗？
是 否
了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题
  1. JavaScript 标准内置对象
  2. Array
  3. 构造函数
    1. Array() 构造函数
  4. 静态方法
    1. Array.from()
    2. Array.fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. 静态属性
    1. Array[Symbol.species]
  6. 实例方法
    1. Array.prototype.at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. Array.prototype.every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. Array.prototype.findLastIndex()
    12. Array.prototype.flat()
    13. Array.prototype.flatMap()
    14. Array.prototype.forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. Array.prototype.reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. Array.prototype.some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. Array.prototype.toLocaleString()
    32. Array.prototype.toReversed()
    33. Array.prototype.toSorted()
    34. Array.prototype.toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. Array.prototype.with()
    39. Array.prototype[Symbol.iterator]()
  7. 实例属性
    1. Array：length
    2. Array.prototype[Symbol.unscopables]
  8. 继承
  9. Object/Function
  10. 静态方法
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. Function.prototype[Symbol.hasInstance]()
  11. 静态属性
    1. Function.displayName
    2. Function：length
    3. Function.name
    4. Function.prototype.prototype
    5. Function.prototype.arguments
    6. Function.prototype.caller
  12. 实例方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. 实例属性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

构建更美好互联网的蓝图。

MDN 参与贡献 开发者

访问 Mozilla 公司的非营利母机构 Mozilla 基金会。
本内容的部分版权归 mozilla.org 贡献者所有，©1998–2026。内容依据知识共享许可协议提供。