Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

ArrayBuffer: buffer de bytes em bruto

ArrayBuffer reserva memória de bytes inicializada a zero, acedida por typed array ou DataView e opcionalmente redimensionável.

Versão: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2

Sintaxe

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) cria um bloco de memória preenchido com zeros. ArrayBuffer não expõe diretamente bytes indexados; a leitura e escrita exigem uma vista como Uint8Array ou DataView. byteLength passa por ToIndex: uma parte fracionária finita é truncada em direção a zero, NaN e undefined tornam-se 0 e até -0.5 se torna -0, logo comprimento 0. Invocar o construtor sem new lança TypeError.

options.maxByteLength pede um buffer redimensionável se o limite não for inferior ao tamanho inicial. resize(newLength) preserva o prefixo comum, descarta bytes ao reduzir e acrescenta zeros ao aumentar; vistas que acompanham o comprimento ajustam-se. Um buffer fixo não pode ser redimensionado. slice() copia um intervalo e uma transferência pode separar a origem.

Só um resultado negativo após ToIntegerOrInfinity, +Infinity ou -Infinity, exceder o intervalo numérico ou o limite prático de memória da implementação, ou um máximo inferior ao tamanho inicial lança RangeError. Operações de dados num buffer separado e resize() num buffer fixo lançam TypeError. Erros de conversão propagam-se. Redimensionamento e transferências foram normalizados no ECMAScript 2024.

A etiqueta de âmbito ArrayBuffer.byteLength designa a propriedade de instância usada como buffer.byteLength, não uma propriedade estática do construtor ArrayBuffer. Este accessor apenas de leitura devolve o número atual de bytes: o resultado muda após resize() num buffer redimensionável e é 0 depois da separação. Não tem setter; aplicar o getter a um receiver incompatível, incluindo SharedArrayBuffer, lança TypeError.

Exemplos

const buffer = new ArrayBuffer(4, { maxByteLength: 8 });
const bytes = new Uint8Array(buffer);
bytes.set([10, 20, 30, 40]);
console.log(buffer.byteLength, buffer.maxByteLength, buffer.resizable);

buffer.resize(6);
console.log(buffer.byteLength, Array.from(new Uint8Array(buffer)).join(","));

const copy = buffer.slice(1, 4);
console.log(copy.byteLength, Array.from(new Uint8Array(copy)).join(","));

try { new ArrayBuffer(4).resize(2); } catch (error) { console.log(error instanceof TypeError); }

Resultado

4 8 true
6 10,20,30,40,0,0
3 20,30,40
true

Fontes