TypedArray.from() メソッドは、配列風オブジェクトや反復可能オブジェクトから新しい型付き配列を生成します。このメソッドはArray.from() とほぼ同じです。

試してみましょう

const uint16 = Int16Array.from("12345");console.log(uint16);// Expected output: Int16Array [1, 2, 3, 4, 5]

構文

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

ここでTypedArray は次のいずれかです。

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

引数

arrayLike

型付き配列に変換する反復可能または配列風オブジェクトです。

mapFn省略可

型付き配列の各要素に対して呼び出す関数です。指定された場合、配列に追加するすべての値は最初にこの関数に渡され、代わりにmapFn の返値が型付き配列に追加されます。この関数は以下の引数で呼び出されます。

element

現在処理されている型付き配列の要素です。

index

現在処理されている型付き配列の要素のインデックスです。

thisArg省略可

mapFn を実行するときにthis として使う値です。

返値

新しいTypedArray インスタンスです。

解説

詳しくはArray.from() をご覧ください。

Array.from() とTypedArray.from() の間には微妙な違いがあります（メモ: 下記で言及するthis 値はTypedArray.from() が呼び出されたthis 値であり、mapFn を呼び出すために用いたthisArg 引数ではありません）。

• 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() は必ず密配列 (dense array) を生成します。

例

反復可能オブジェクトから (Set)

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

文字列から

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

アロー関数と map の使用

アロー関数をマップ関数として使用して要素を操作します。

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

数列を生成する

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

TypedArray 以外のコンストラクターに対する from() の呼び出し

from() のthis 値はTypedArray インスタンスを返すコンストラクターでなければなりません。

function NotArray(len) {  console.log("NotArray called with length", len);}Int8Array.from.call({}, []); // TypeError: #<Object> is not a constructorInt8Array.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 ]

仕様書

ブラウザーの互換性

関連情報

• TypedArray.from のポリフィル (core-js)
• JavaScript の型付き配列ガイド
• TypedArray
• TypedArray.of()
• TypedArray.prototype.map()
• Array.from()