ArrayBuffer

ArrayBuffer객체는 일반적이 길이가 정해진 원시 이진 데이터 버퍼를 나타내는 데 쓰입니다. ArrayBuffer에 담긴 정보를 직접 수정하는 것은 불가능하지만, 대신 타입이 있는 배열이나 특정 포맷의 버퍼를 나타내는 DataView를 생성하고 그것을 이용해 버퍼의 내용물을 읽고 쓸 수 있습니다.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

구문

new ArrayBuffer(length)

매개변수

length

바이트 단위로 나타낸 버퍼에 저장된 길이.

반환 값

새로운 ArrayBuffer 객체가 지정된 길이로 만들어져 반환됩니다. 새 객체의 내용물은 0으로 초기화됩니다.

설명

ArrayBuffer 생성자는 바이트 단위의 길이가 주어지면 해당하는 길이의 ArrayBuffer 객체를 생성합니다.

기존 데이터에서 배열 버퍼 가져 오기

• Base64 문자열에서 갖고오기
• 로컬 파일에서 갖고오기

속성

ArrayBuffer.length

ArrayBuffer 생성자의 length 속성이며, 값은 1이다.

get ArrayBuffer[@@species]

파생된 객체들을 생성하는 데 사용되는 생성자 함수이다.

ArrayBuffer.prototype

모든 ArrayBuffer 객체에 속성을 추가할 수 있게 한다.

메서드

ArrayBuffer.isView(arg)

타입이 있는 배열이나 DataView처럼 arg가 ArrayBuffer의 view 중 하나라면 true를 반환하고, 아니라면 false를 반환한다.

ArrayBuffer.transfer(oldBuffer [, newByteLength])

oldBuffer의 데이터를 newByteLength를 바탕으로 축약(Truncate)하거나 0을 추가한 ArrayBuffer를 반환한다.

인스턴스

ArrayBuffer 의 모든 인스턴스들은 ArrayBuffer.prototype 를 통해 상속받는다.

Properties

ArrayBuffer.prototype.constructor

Specifies the function that creates an object's prototype. The initial value is the standard built-in ArrayBuffer constructor.

ArrayBuffer.prototype.byteLength Read only

The size, in bytes, of the array. This is established when the array is constructed and cannot be changed. Read only.

Methods

ArrayBuffer.prototype.slice()

Returns a new ArrayBuffer whose contents are a copy of this ArrayBuffer's bytes from begin, inclusive, up to end, exclusive. If either begin or end is negative, it refers to an index from the end of the array, as opposed to from the beginning.

ArrayBuffer.slice()

ArrayBuffer.prototype.slice() 와 같은 기능을 한다.

예제

이 예제에서는 8 바이트 크기의 버퍼를 생성하고 이를 Int32Array에 참조시켰습니다.

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

명세

브라우저 호환성

호환성 참고사항

ECMAScript 2015 부터, ArrayBuffer 생성자는 new 연산자를 통해 생성되어야 한다. 이제부터는 ArrayBuffer 생성자 함수를 new 없이 호출할 경우, TypeError 에러가 발생한다.

var dv = ArrayBuffer(10);
// TypeError: calling a builtin ArrayBuffer constructor 
// without new is forbidden

var dv = new ArrayBuffer(10);

같이 보기

• JavaScript typed arrays
• SharedArrayBuffer