Array.findIndex() 查找第一个匹配下标
最后更新:2026-09-09
Array.findIndex() 查找第一个匹配下标
findIndex 返回第一个满足测试函数的元素下标;找不到返回 -1。常用于定位后配合 splice 替换或删除元素。
| 分类 | 数组 |
|---|---|
| ES 版本 | ES6(2015) |
📝 语法
const 下标 = 数组.findIndex((元素, 下标, 原数组) => 条件);
⚙️ 参数
| callback | 测试函数,语义与 find 完全一致。 |
|---|
返回值:第一个匹配元素的下标,或 -1。
是否修改原值:否(返回新值)
▶ 示例
编辑下方代码,点击运行,在输出面板查看结果:
运行结果:
1
[ '写周报', '参加产品评审', 'code review' ]
-1
💡 提示 findIndex 找到后同样立即停止遍历,性能特性与 find 一致。
💡 提示 经典组合:const i = arr.findIndex(x => x.id === target); if (i !== -1) arr.splice(i, 1);——按下标精准删除。
🌐 浏览器支持
| 浏览器 | |||||
|---|---|---|---|---|---|
| Array.findIndex() | ✓ v45 | ✓ v12 | ✓ v25 | ✓ v8 | ✓ v32 |
| 所有现代浏览器均支持 | |||||
🏷️ 相关数组方法
💡 相关案例
更多实战案例即将上线,敬请期待。
📚 相关教程
❓ 常见问题
QfindIndex 和 indexOf 有什么区别?
AindexOf 只能用固定值做全等匹配;findIndex 用回调函数,可以按任意条件(如对象属性)查找。
Q返回 -1 表示什么?
A没有找到任何满足条件的元素。使用前务必判断 !== -1,否则 arr[-1] 会取到 undefined 而不报错。
Q如何删除找到的元素?
Aconst i = arr.findIndex(x => x.id === 3); if (i !== -1) arr.splice(i, 1);——先定位再精准删除。