CKTIS / JavaScript
Arrays tipados: número de elementos, bytes da vista e bytes do buffer
Distingue o buffer subjacente (`.buffer`), o número de elementos (`.length`), os bytes da vista (`.byteLength`) e o tamanho atual de todo o buffer (`.buffer.byteLength`).
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer // backing buffer object
view.length // element count in the view
view.byteLength // byte count in the view
buffer.byteLength // current byte count of the entire bufferview.buffer devolve o mesmo objeto de buffer sem copiar os dados: um ArrayBuffer ou, para uma vista sobre memória partilhada, um SharedArrayBuffer. view.length conta elementos, enquanto view.byteLength conta os bytes da vista: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength indica o tamanho atual de todo o buffer em bytes, não o seu máximo. SharedArrayBuffer tem o seu próprio getter byteLength. São propriedades só de leitura, não métodos.
new Uint16Array(n) reserva espaço para n elementos. Já new Uint16Array(buffer, byteOffset, length) cria uma vista sem copiar os dados: o deslocamento é dado em bytes e o comprimento em elementos. Um deslocamento desalinhado ou um intervalo que ultrapasse os limites do buffer provoca um RangeError. Se o destinatário só deve receber os dados da vista, passa-lhe uma cópia do respetivo intervalo de bytes, não view.buffer, que também dá acesso a bytes fora da vista.
Com um ArrayBuffer redimensionável (ECMAScript 2024), se omitires length, a vista abrange todos os elementos completos que cabem entre o seu deslocamento e o fim do buffer. Um valor explícito de length fixa o intervalo da vista. Reduzir o buffer pode pôr a vista fora dos limites: nesse caso, view.length e view.byteLength devolvem 0. Voltar a aumentar o buffer pode tornar o intervalo válido outra vez. Antes de redimensionares, verifica se o ambiente de execução de destino o suporta.
Na Web, transferir um ArrayBuffer pode separar o buffer original dos seus dados. view.buffer continua a devolver o mesmo objeto, mas buffer.byteLength, view.length e view.byteLength devolvem 0. O zero, por si só, não comprova essa separação: o buffer ou a vista podem estar simplesmente vazios.
Exemplos
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}Resultado
true | 3 | 6 | 16
`true | 3 | 6 | 16` confirma que a vista usa o mesmo buffer: começa no deslocamento de 4 bytes e abrange 3 elementos de 2 bytes cada num buffer de 16 bytes.
Lições relacionadas
- JavaScript · Lição 5 · Avançado · Versão: 4
Fontes
- ECMAScript 2024 — get %TypedArray%.prototype.buffer
- ECMAScript 2024 — get %TypedArray%.prototype.length
- ECMAScript 2024 — get %TypedArray%.prototype.byteLength
- ECMAScript 2024 — get ArrayBuffer.prototype.byteLength
- ECMAScript 2024 — get SharedArrayBuffer.prototype.byteLength
- ECMAScript 2024 — InitializeTypedArrayFromArrayBuffer
- ECMAScript 2024 — ArrayBuffer.prototype.resize
- MDN — TypedArray: Behavior when viewing a resizable buffer
- HTML Standard — StructuredSerializeWithTransfer