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

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 buffer

view.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