TypedArray.from()

¥Syntax

TypedArray.from(arrayLike, mapFn)
TypedArray.from(arrayLike, mapFn, thisArg)

其中 TypedArray 是以下之一：

¥Where TypedArray is one of:

• Int8Array
• Uint8Array
• Uint8ClampedArray
• Int16Array
• Uint16Array
• Int32Array
• Uint32Array
• Float16Array
• Float32Array
• Float64Array
• BigInt64Array
• BigUint64Array

¥Parameters

arrayLike

要转换为类型化数组的可迭代或类似数组的对象。

mapFn Optional

调用类型化数组的每个元素的函数。如果提供，则首先将要添加到数组的每个值都通过此函数传递，然后将 mapFn 的返回值添加到类型化数组中。使用以下参数调用该函数：

element

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

index

类型化数组中当前正在处理的元素的索引。

thisArg Optional

执行 mapFn 时用作 this 的值。

¥Return value

一个新的 TypedArray 实例。

¥A new TypedArray instance.

¥Description

详细信息请参见 Array.from()。

¥See Array.from() for more details.

Array.from() 和 TypedArray.from() 之间有一些细微的区别（注意：下面提到的 this 值是调用 TypedArray.from() 时使用的 this 值，而不是用于调用 mapFn 的 thisArg 参数）：

¥There are some subtle distinctions between Array.from() and TypedArray.from() (note: the this value mentioned below is the this value that TypedArray.from() was called with, not the thisArg argument used to invoke mapFn):

• 如果 TypedArray.from() 的 this 值不是构造函数，则 TypedArray.from() 将抛出 TypeError，而 Array.from() 默认创建新的 Array。
• this 构造的对象必须是 TypedArray 实例，而 Array.from() 允许其 this 值构造为任何对象。
• 当 source 参数是迭代器时，TypedArray.from() 首先从迭代器收集所有值，然后使用计数创建 this 的实例，最后在实例上设置值。Array.from() 在从迭代器接收到每个值时设置它们，然后在最后设置它的 length。
• TypedArray.from() 使用 [[Set]]，而 Array.from() 使用 [[DefineOwnProperty]]。因此，当使用 Proxy 对象时，它会调用 handler.set() 来创建新元素，而不是 handler.defineProperty()。
• 当 Array.from() 获得一个不是迭代器的类数组时，它会考虑漏洞。TypedArray.from() 将确保结果是密集的。

¥Examples

¥From an iterable object (Set)

const s = new Set([1, 2, 3]);
Uint8Array.from(s);
// Uint8Array [ 1, 2, 3 ]

¥From a string

Int16Array.from("123");
// Int16Array [ 1, 2, 3 ]

¥Use with arrow function and map

使用箭头函数作为映射函数来操作元素

¥Using an arrow function as the map function to manipulate the elements

Float32Array.from([1, 2, 3], (x) => x + x);
// Float32Array [ 2, 4, 6 ]

¥Generate a sequence of numbers

Uint8Array.from({ length: 5 }, (v, k) => k);
// Uint8Array [ 0, 1, 2, 3, 4 ]

¥Calling from() on non-TypedArray constructors

from() 的 this 值必须是返回 TypedArray 实例的构造函数。

¥The this value of from() must be a constructor that returns a TypedArray instance.

function NotArray(len) {
  console.log("NotArray called with length", len);
}

Int8Array.from.call({}, []); // TypeError: #<Object> is not a constructor
Int8Array.from.call(NotArray, []);
// NotArray called with length 0
// TypeError: Method %TypedArray%.from called on incompatible receiver #<NotArray>

function NotArray2(len) {
  console.log("NotArray2 called with length", len);
  return new Uint8Array(len);
}
console.log(Int8Array.from.call(NotArray2, [1, 2, 3]));
// NotArray2 called with length 3
// Uint8Array(3) [ 1, 2, 3 ]

¥See also

• core-js 中 TypedArray.from 的 Polyfill
• JavaScript 类型数组 指南
• TypedArray
• TypedArray.of()
• TypedArray.prototype.map()
• Array.from()