TypedArray.from()

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

TypedArray는 아래 중 하나입니다.

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

arrayLike

형식화 배열로 변환할 순회 가능한 객체 혹은 유사 객체.

mapFn Optional

입력된 배열의 모든 요소에 대해 호출할 함수입니다. 이 함수를 제공하면 배열에 추가할 모든 값이 먼저 이 함수를 통과하고 mapFn의 반환 값이 형식화 배열에 입력 값 대신 추가됩니다. 이 함수는 다음 인수를 사용하여 호출됩니다.

element

형식화 배열에서 처리 중인 현재 요소입니다.

index

형식화 배열에서 처리 중인 현재 요소의 인덱스입니다.

thisArg Optional

mapFn을 실행할 때 this로 사용할 값입니다.

새로운 TypedArray 인스턴스입니다.

자세한 내용은 Array.from()을 참고하시기 바랍니다.

Array.from()와 TypedArray.from() 사이에는 미묘한 차이가 있습니다(참고: 아래에 언급된 this 값은 mapFn을 호출하는 데 사용된 thisArg 인수가 아니라 TypedArray.from()가 호출된 this 값입니다).

• 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()은 결과가 희소 배열이 안되도록 보장합니다.

요소를 조작하는 Map 함수로서 화살표 함수 사용하기

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

from()의 this 값은 TypedArray 인스턴스를 반환하는 생성자여야 합니다.

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

Int8Array.from.call({}, []); // TypeError: #<Object> is not a constructor
Int8Array.from.call(NotArray, []);
// NotArray는 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는 length 3으로 호출되었습니다.
// Uint8Array(3) [ 1, 2, 3 ]

• core-js에서 TypedArray.from의 폴리필
• JavaScript 형식화 배열 안내서
• TypedArray
• TypedArray.of()
• TypedArray.prototype.map()
• Array.from()