TypedArray.prototype.map()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2016.

map() 方法对类型化数组的每个元素调用提供的函数,并使用结果来创建新的类型化数组。这个方法的算法和 Array.prototype.map() 相同。TypedArray 是这里的类型化数组类型之一。

语法

js
map(callbackFn)
map(callbackFn, thisArg)

参数

callback

产生新的类型化数组的元素的函数,接受三个函数:

currentValue

类型化数组中要处理的当前元素

index

类型化数组中要处理的当前元素的下标

array

map在其上调用的类型化数组

thisArg

可选,执行callback时作为this的值。

返回值

新的类型化数组

描述

map方法对类型化数组中的元素调用提供的 callback函数,按照顺序,并且会从结果构造新的类型化数组。 callback 只对拥有值的类型化数组下标调用。它不会对未定义的,被删除的或者没有赋值的下标调用。

callback 以三个参数调用:元素的值,元素下标,和被遍历的类型化数组。

如果将 thisArg 参数提供给 map,它会在调用时传递给 callback,作为它的 this 值。否则,会传递 undefined 作为它的 this 值。callback 最终观测到的 this 值由用于决定函数可见的 this 值的一般规则来决定。

map 不改变在其上调用的类型化数组(虽然如果调用了callback可能会这样做)。

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

示例

将类型数组映射被平方根的类型数组

下面的代码接受一个类型数组,并创建一个新的类型数组,含有第一个类型数组中元素的平方根。

js
var numbers = new Uint8Array([1, 4, 9]);
var roots = numbers.map(Math.sqrt);
// roots is now: Uint8Array [1, 2, 3],
// numbers is still Uint8Array [1, 4, 9]

使用含有参数的函数来映射类型数组

下面的代码展示了,当使用需要一个参数的函数时,map的工作方式。在map遍历原始数组的过程中,参数会自动赋值为类型化数组的每个元素。

js
var numbers = new Uint8Array([1, 4, 9]);
var doubles = numbers.map(function (num) {
  return num * 2;
});
// doubles is now Uint8Array [2, 8, 18]
// numbers is still Uint8Array [1, 4, 9]

规范

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.map

浏览器兼容性

BCD tables only load in the browser

参见