NATIVE

settings_applicationsObject  >   settings_applicationsArrayBuffer  >   settings_applications[[Prototype]]

NATIVE

Editing
  • account_tree
  • bug_report

ArrayBuffernewArrayBuffertransfer(Unsigned intnewByteLength])

실험적인 단계에 있어 현재 모든 웹브라우저에서 지원하지 않을 수 있으므로 반드시 지원 현황을 확인해야 한다.

현재 버퍼(buffer)와 동일한 바이트(byte) 데이터를 가진 새로운 ArrayBuffer를 생성한 후 출처 ArrayBuffer를 분리한다.

구문

형식
arrayBuffer.transfer()

매개 변수

Unsigned intnewByteLength선택

새로 생성되는 ArrayBufferbyteLength를 지정한다. 생략하면 출처 ArrayBufferbyteLength이다. 크기 조정이 가능한 경우 maxByteLength보다 클 수 없다.

출처 ArrayBuffer보다 작으면 오버플로우(overflow) 바이트(byte)는 제거된다. 반대의 경우 추가 바이트(byte)는 0으로 채워진다.

반환

ArrayBuffernewArrayBuffer

새로운 ArrayBuffer 인스턴스가 반환된다. 출처 ArrayBuffer가 분리되었다.

다음의 경우 예외가 발생한다.

  • RangeError
    • 새로 지정된 크기가 출처 ArrayBuffermaxByteLength보다 큰 경우 발생한다.
  • TypeError
    • 출처 ArrayBuffer가 이미 분리된 경우 발생한다.

Exception

RangeError

어떤 값이 집합 구조에 없거나 허용되는 범위가 아닐 때 오류를 다루는 객체이다.

TypeError

동적 타입의 값이 흐름상 맞지 않는 자료형이라 연산을 할 수 없을 때 발생하는 오류를 다루는 객체이다.

버전 명세

ECMAScript 2024(15th Edition)
#sec-arraybuffer.prototype.transfer

지원 웹브라우저