大网数据广告活动
Web 标准与前端开发

TypedArray.prototype.findIndex()

· 52CE 我爱测

如果某个元素满足所提供的测试函数,**`findIndex()`** 方法返回类型化数组中的**下标**,否则返回 -1。_TypedArray_ 是这里的类型化数组类型之一。

如果某个元素满足所提供的测试函数,findIndex() 方法返回类型化数组中的下标,否则返回 -1。TypedArray 是这里的类型化数组类型之一。

同时请参见 TypedArray.findIndex 方法,它返回了类型化数组中所发现元素的值,而不是它的下标。

语法

findIndex(callbackFn)
findIndex(callbackFn, thisArg)

参数

  • callback
    • : 用于在类型化数组中的每个元素上执行的函数,接受三个参数:
      • element
        • : 要处理的类型化数组的当前元素。
      • index
        • : 要处理的当前元素在类型化数组中的下标
      • array
        • : find 在其上调用的类型化数组
  • thisArg
    • : 可选,执行callback时的this值。

返回值

如果元素通过了测试,则为数组下标,否则为 -1。

描述

findIndex 方法对类型化数组中的每个元素执行一次 callback 函数,直到它找到一个使 callback 返回 true的元素。如果发现了一个这样的元素,find 方法将会立即返回该元素的下标。否则,findIndex 方法会返回 -1。callback 只会对那些已经被赋值的索引调用。不会对那些被删除或从来没被赋值的索引调用。

callback 以三个参数调用:元素的值,元素索引,以及要遍历的数组对象。

如果将thisArg参数提供给findIndex,它会在调用时传递给callback,作为它的 this值。如果没有提供,会使用undefined。

findIndex 不修改在其上调用的类型化数组。

由 findIndex处理的元素范围在callback调用之前就确定了。在 findIndex调用之后添加到数组的元素不会由 callback访问。如果类型化数组的现有元素被改变,或被删除,它们传给callback的值是findIndex 访问它们时候的值。已删除的元素不会被访问。

示例

在类型化数组中寻找质数的下标

下面的示例在类型化数组中寻找质数元素的下标(如果没有质数则返回 -1)。

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;
}

const uint8 = new Uint8Array([4, 6, 8, 12]);
const uint16 = new Uint16Array([4, 6, 7, 12]);

console.log(uint8.findIndex(isPrime)); // -1,未发现
console.log(uint16.findIndex(isPrime)); // 2

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

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。