CKTIS / JavaScript
Arrays tipados: vista com `subarray()` e cópia com `slice()`
`subarray()` cria uma vista do mesmo buffer, enquanto `slice()` copia, por predefinição, os elementos selecionados para um buffer separado. Ambos interpretam os limites da mesma forma.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
typedArray.subarray()
typedArray.subarray(start)
typedArray.subarray(start, end)
typedArray.slice()
typedArray.slice(start)
typedArray.slice(start, end)subarray() e slice() são métodos do protótipo comum herdado por instâncias como Uint16Array. Não existe um construtor global TypedArray. Ambos exigem um array tipado como this; um Array normal provoca um TypeError.
Ambos usam índices de elementos a partir de zero dentro da vista, não posições em bytes no buffer como ArrayBuffer.prototype.slice(). O início é inclusivo e o fim exclusivo. Se start for omitido ou for undefined, usa-se 0; se end for omitido ou for undefined, usa-se o fim da vista. As partes fracionárias são truncadas em direção a zero, os índices negativos contam a partir do fim e os limites são restringidos ao intervalo entre 0 e o comprimento da vista. Se o fim assim calculado coincidir com o início ou o anteceder, ambos os métodos devolvem um array tipado vazio para uma vista válida sobre um buffer de tamanho fixo quando se usa o construtor predefinido do resultado. Um construtor personalizado especificado através de constructor[Symbol.species] pode devolver um array tipado não vazio mesmo que o comprimento pedido seja 0.
Com o construtor predefinido do resultado, subarray() cria uma vista do mesmo buffer sem copiar elementos. As escritas na zona sobreposta são visíveis em ambas as vistas. Mesmo uma vista pequena pode manter todo o buffer em memória, e a sua propriedade .buffer dá acesso a bytes fora do intervalo selecionado. Usa slice() para obter uma cópia independente dos elementos selecionados. Um constructor[Symbol.species] personalizado pode executar código, alterar o tipo dos elementos ou alterar se o resultado partilha memória. Não encares estes métodos como uma barreira de segurança para objetos não fidedignos.
Em ECMAScript 2024, com o construtor predefinido, se o comprimento da vista de origem acompanhar o tamanho do buffer, o da vista devolvida por subarray() também o acompanha quando end é omitido ou é undefined. Um end diferente de undefined produz uma vista de comprimento fixo; slice() produz, por predefinição, uma cópia de comprimento fixo. Se o buffer estiver desanexado ou a vista de origem já estiver fora dos limites no momento da chamada, slice() lança um TypeError. Nesse caso, subarray() usa um comprimento de origem de 0 nos cálculos, mas a construção do resultado pode falhar na mesma. Verifica se o ambiente de execução de destino suporta buffers redimensionáveis.
Exemplos
{
const source = new Uint16Array([10, 20, 30, 40]);
const view = source.subarray(1, -1);
const copy = source.slice(1, -1);
view[0] = 99;
source[2] = 77;
console.log(`source: ${source.join(', ')}`);
console.log(`view: ${view.join(', ')}`);
console.log(`copy: ${copy.join(', ')}`);
console.log(`same buffer: ${view.buffer === source.buffer}, ${copy.buffer === source.buffer}`);
}Resultado
source: 10, 99, 77, 40 view: 99, 77 copy: 20, 30 same buffer: true, false
`(1, -1)` seleciona `20` e `30`. Escrever através de `view` altera `source`, e escrever através de `source` altera `view`. `copy` mantém `20, 30` e tem um buffer separado.
Lições relacionadas
- JavaScript · Lição 2 · Avançado · Versão: 4
Fontes
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.subarray
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.slice
- ECMAScript® 2024 Language Specification — TypedArraySpeciesCreate
- TypedArray.prototype.subarray() - JavaScript | MDN
- TypedArray.prototype.slice() - JavaScript | MDN
- TypedArray - JavaScript | MDN
- TypedArray[Symbol.species] - JavaScript | MDN
- ArrayBuffer.prototype.slice() - JavaScript | MDN