CKTIS / JavaScript
Dados binários e fluxos
ArrayBuffer armazena bytes, enquanto os arrays tipados e DataView os interpretam. Aprende sobre memória partilhada, ordem dos bytes e a diferença entre um buffer em memória e um fluxo.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new ArrayBuffer(byteLength)
new Uint8Array(buffer, byteOffset, length)
new DataView(buffer, byteOffset, byteLength)
view.setUint16(byteOffset, value, littleEndian)
view.getUint16(byteOffset, littleEndian)ArrayBuffer armazena dados binários, mas não fornece acesso indexado aos seus bytes. As vistas permitem esse acesso: Uint8Array interpreta cada byte como um número de 0 a 255, enquanto outros arrays tipados agrupam bytes em elementos de um tipo específico. length de um array tipado conta elementos; byteLength conta bytes.
DataView lê e escreve valores de tipos diferentes em deslocamentos expressos em bytes. Para valores multibyte, permite escolher explicitamente a ordem dos bytes: false significa big-endian e true little-endian. Os arrays tipados usam a ordem dos bytes do ambiente; por isso, utiliza DataView para formatos com uma ordem dos bytes especificada.
As vistas criadas a partir do mesmo buffer podem abranger intervalos de bytes diferentes. Uma escrita através de uma vista só é visível noutra nos bytes afetados que essa outra vista abrange. subarray() cria outra vista, enquanto slice() de um array tipado copia os elementos. O exemplo escreve dois números e mostra os mesmos dados como bytes.
Um buffer representa dados em memória; um fluxo fornece ou recebe blocos sucessivos de dados. O limite de um bloco não corresponde necessariamente ao limite de um registo. As APIs de fluxos pertencem ao ambiente, não ao núcleo do ECMAScript. O exemplo utiliza funcionalidades disponíveis desde ES2015, sem APIs de fluxos; funcionar no Node.js 24 não comprova o suporte de APIs dos navegadores.
Exemplos
const buffer = new ArrayBuffer(4);
const view = new DataView(buffer);
view.setUint16(0, 0x1234, false);
view.setUint16(2, 0xABCD, false);
const bytes = new Uint8Array(buffer);
console.log(Array.from(bytes).join(","));
console.log(view.getUint16(0, false));Resultado
18,52,171,205 4660
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.