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 (>= 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]

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

ArrayBuffer.prototype

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

ArrayBuffer.isView(arg)

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.

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.

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()

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

W niniejszym przykładzie tworzymy 8-bajtowy buffer z widokiem Int32Array 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