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);——按下标精准删除。

🌐 浏览器支持

浏览器 ChromeChrome EdgeEdge FirefoxFirefox SafariSafari OperaOpera
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);——先定位再精准删除。
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏