ArrayBuffer() 생성자

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

ArrayBuffer() 생성자는 ArrayBuffer 객체를 생성합니다.

시도해 보기

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);

console.log(buffer.byteLength);
// Expected output: 8

new ArrayBuffer(length)
new ArrayBuffer(length, options)

참고: ArrayBuffer()는 오직 new로만 생성할 수 있습니다. new 없이 호출을 시도하면 TypeError 예외가 발생합니다.

생성할 ArrayBuffer의 바이트 크기.

생성할 배열 버퍼의 바이트 단위의 크기.

다음 속성을 포함하는 객체.

지정한 크기를 가진 새로운 ArrayBuffer 객체. 내용은 모두 0으로 초기화됩니다.

지정된 크기의 새 ArrayBuffer 객체입니다. maxByteLength 속성이 명시되어 있을 경우 이 값으로 maxByteLength 속성이 설정됩니다. 그 내용은 0으로 초기화됩니다.

다음 중 한 가지 경우에 발생합니다.

이 예제에서는 버퍼를 참조하는 Int32Array 뷰를 사용하여 8바이트 버퍼를 만듭니다.

const buffer = new ArrayBuffer(8);
const view = new Int32Array(buffer);

이 예제에서는 최대 16바이트까지 크기를 조정할 수 있는 8바이트 버퍼를 생성한 다음 resize() 이를 12바이트로 조정합니다.

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });

buffer.resize(12);

참고: maxByteLength는 사용 사례에 맞게 가능한 가장 작은 값으로 설정하는 것이 좋습니다. 메모리 부족 오류의 위험을 줄이려면 1073741824(1GB)를 초과하지 않아야 합니다.

Specification
ECMAScript® 2026 Language Specification # sec-arraybuffer-constructor