ArrayBuffer

Objekt ArrayBuffer reprezentuje buffer z surowymi danymi binarnymi o niezmiennej długości. Nie możesz bezpośrednio wpływać na zawartość obiektu ArrayBuffer, możesz natomiast stworzyć jeden z obiektów typedArray lub obiekt DataView reprezentujący buffer w specjalnym formacie i używać tego obiektu do odczytu oraz zapisu treści buffera.

new ArrayBuffer(length)

długość(length)

Rozmiar, w bajtach, tworzony z bufferu tablicy (array buffer).

Nowy obiekt ArrayBuffer o określonym rozmiarze. Jego wartości początkowe wynoszą 0.

RangeError pojawi się, jeśli długość (length) jest większa niż Number.MAX_SAFE_INTEGER (en-US) (>= 2 ** 53) lub ujemna.

Konstruktor ArrayBuffer tworzy nowy ArrayBuffer z podanej długości (length) w bajtach.

• ze stringa Base64
• z lokalnego pliku

ArrayBuffer.length

Właściwość długości konstruktura ArrayBuffer, której wartość wynosi 1.

get ArrayBuffer[@@species] (en-US)

Funkcja konstruktora jest używana do tworzenia dostarczanych obiektów.

ArrayBuffer.prototype (en-US)

Pozwala dodać właściwości do wszystkich obiektów ArrayBuffer.

ArrayBuffer.isView(arg) (en-US)

Zwraca true, jeśli arg jest jednym z widoków ArrayBuffer, jak obiekty typedArray lub DataView. W innych przypadkach zwraca false.

ArrayBuffer.transfer(oldBuffer [, newByteLength])

Zwraca nowy ArrayBuffer, którego zawartości są pobrane z danych oldBuffer. Następnie zostaje skrócony lub przedłużony od 0 przez newByteLength.

Wszystkie instancje ArrayBuffer dziedziczą z ArrayBuffer.prototype (en-US).

{{page('en-US/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Properties')}}

{{page('en-US/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Methods')}}

ArrayBuffer.slice() (en-US)

Posiada tę samą funkcjonalność, jak ArrayBuffer.prototype.slice() (en-US).

W niniejszym przykładzie tworzymy 8-bajtowy buffer z widokiem Int32Array (en-US) odnoszącym się do buffera:

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

Od ECMAScript 2015 kontruktory ArrayBuffer muszą być tworzone poprzez operator new. Wywoływanie kontruktora ArrayBuffer jako funkcji bez new zaskutkuje od teraz pojawieniem się TypeError.

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

var dv = new ArrayBuffer(10);

• JavaScript typed arrays
• SharedArrayBuffer