ArrayBuffer

Sintaxe

new ArrayBuffer(length)

Parametros

length

O tamanho, em bytes, do array buffer que se pretende criar.

Retorno

 Um novo objecto do tipo ArrayBuffer do tamanho especificado. O respetivo conteudo é inicializado a 0.

Excepções

A RangeError é lançada caso o tamanho (length) é maior do que Number.MAX_SAFE_INTEGER (>= 2 ** 53) ou caso seja negativo.

Descrição

O construtor de ArrayBuffer cria um novo objeto do tipo ArrayBuffer com o tamanho especificado em bytes.

Obter um array buffer a partir de dados existentes

• From a Base64 string
• From a local file

Propriedades

ArrayBuffer.length

Propriedade length do construtor de  ArrayBuffer cujo valor é 1.

get ArrayBuffer[@@species]

A função do contrutor que é usado para criar objetos derivados.

ArrayBuffer.prototype

Permite adicionar novas propriedades a todos os objetos do tipo ArrayBuffer.

Métodos

ArrayBuffer.isView(arg)

Devolve true caso arg é  um tipo de representação do ArrayBuffer, como typed array objects ou DataView. Devolve false caso contrário

ArrayBuffer.transfer(oldBuffer [, newByteLength])

Devolve um novo objeto ArrayBuffer cujo conteúdo é obtido do oldBuffer e ou é truncado ou preenchido a zeros pelo  newByteLength.

Instâncias ArrayBuffer

Todas as instâncias de ArrayBuffer herdam de ArrayBuffer.prototype.

Propriedades

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.

Métodos

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

Tem a mesma funcionalidade que ArrayBuffer.prototype.slice().

Exemplo

Neste exemplo, criamos um buffer de 8 bytes com representação Int32Array a referênciar o buffer:

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

Especificação

Compatibilidade nos navegadores

Notas de compatibilidade

Com ECMAScript 2015, construtores de ArrayBuffer são obrigados a usar o operador new. Daqui adiante ao invocar ArrayBuffer como uma função sem new irá lançar uma exceção TypeError.

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

var dv = new ArrayBuffer(10);

Ver também

• JavaScript typed arrays
• SharedArrayBuffer