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

CKTIS / JavaScript

TypedArray: tamanhos, indexação, vistas e cópias

Aprenda a diferença entre o número de elementos e o número de bytes em TypedArray. Veja como buffer e byteOffset descrevem uma vista e por que subarray() partilha dados enquanto slice() cria uma cópia independente.

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

const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);

TypedArray é a interface comum das vistas tipadas sobre dados binários, não um construtor disponível globalmente. Utilize um tipo concreto como Uint16Array. Estas APIs pertencem a ECMAScript e não requerem DOM. Aqui, TypedArray.length, TypedArray.byteLength, TypedArray.buffer e TypedArray.byteOffset designam propriedades de instância como view.length, não propriedades estáticas.

length conta elementos, byteLength conta os bytes da vista, buffer referencia todo o ArrayBuffer ou SharedArrayBuffer subjacente, e byteOffset indica o início da vista em bytes relativamente ao buffer. Para uma vista válida, byteLength === length * BYTES_PER_ELEMENT. Uma vista pode abranger apenas parte do buffer. Em new Uint16Array(buffer, byteOffset, length), o deslocamento tem de ser um múltiplo de 2, enquanto length continua a contar elementos. Estas propriedades são só de leitura; ainda assim, redimensionar o buffer pode alterar os tamanhos indicados e uma vista fora dos limites apresenta tamanhos e deslocamento iguais a zero.

TypedArray.indexing designa a sintaxe view[index], não um método. Os índices começam em zero e acedem aos elementos a partir do início da vista. A atribuição converte o valor para o tipo do elemento. Uma leitura fora dos limites devolve undefined; uma escrita fora dos limites não aumenta a vista nem guarda um valor. view[-1] não lê o último elemento.

TypedArray.prototype.subarray(begin, end) cria uma nova vista que partilha o buffer: as alterações aos elementos sobrepostos são visíveis nas duas vistas. TypedArray.prototype.slice(start, end) copia os elementos selecionados para um buffer independente. Ambos os métodos indicam os limites em elementos, incluem o início e excluem o fim; os limites negativos contam a partir do fim e, se o fim for omitido, considera-se o fim da vista. Estas regras descrevem os tipos integrados normais; as subclasses personalizadas podem alterar a criação dos resultados através de Symbol.species.

Exemplos

const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);

Resultado

4 8 2 12
4 true false
10,99,30,40
99,30
20,30
undefined 4

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.

Fontes