CKTIS / JavaScript
Array tipizzati: vista con `subarray()` e copia con `slice()`
`subarray()` crea una vista sullo stesso buffer, mentre `slice()` copia per impostazione predefinita gli elementi selezionati in un buffer separato. I limiti si interpretano allo stesso modo.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
typedArray.subarray()
typedArray.subarray(start)
typedArray.subarray(start, end)
typedArray.slice()
typedArray.slice(start)
typedArray.slice(start, end)subarray() e slice() sono metodi del prototipo comune ereditato da istanze come Uint16Array. Non esiste un costruttore globale TypedArray. Entrambi richiedono un vero array tipizzato come this: un normale Array provoca un TypeError.
Entrambi usano indici di elemento a partire da zero all’interno della vista, non posizioni in byte nel buffer come ArrayBuffer.prototype.slice(). L’inizio è incluso e la fine esclusa. Se start è omesso o vale undefined, si usa 0; se end è omesso o vale undefined, si usa la fine della vista. Le frazioni vengono troncate verso zero, gli indici negativi si contano dalla fine e i limiti vengono ricondotti all’intervallo tra 0 e la lunghezza della vista. Se la fine così calcolata coincide con l’inizio o lo precede, per una vista valida su un buffer di dimensione fissa entrambi i metodi restituiscono un array tipizzato vuoto quando si usa il costruttore predefinito del risultato. Un costruttore personalizzato specificato tramite constructor[Symbol.species] può restituire un array tipizzato non vuoto anche se la lunghezza richiesta è 0.
Con il costruttore predefinito del risultato, subarray() crea una nuova vista sullo stesso buffer senza copiare gli elementi. Le scritture nella zona sovrapposta sono visibili da entrambe le viste. Anche una vista piccola può mantenere in memoria l’intero buffer e la sua proprietà .buffer dà accesso ai byte fuori dall’intervallo selezionato. Usa slice() per una copia indipendente degli elementi selezionati. Un constructor[Symbol.species] personalizzato può eseguire codice, cambiare il tipo degli elementi o cambiare la condivisione della memoria del risultato. Non considerare questi metodi una barriera di sicurezza per oggetti non attendibili.
In ECMAScript 2024, con il costruttore predefinito, se la lunghezza della vista di origine segue la dimensione del buffer, anche quella della vista restituita da subarray() la segue quando end è omesso o vale undefined. Un end diverso da undefined dà una vista di lunghezza fissa; slice() dà per impostazione predefinita una copia di lunghezza fissa. Se il buffer è scollegato o la vista di origine è già fuori dai limiti al momento della chiamata, slice() genera un TypeError. In questo caso subarray() esegue i calcoli con una lunghezza di origine pari a 0, ma la costruzione del risultato può comunque fallire. Verifica il supporto dei buffer ridimensionabili nell’ambiente di esecuzione di destinazione.
Esempi
{
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}`);
}Risultato
source: 10, 99, 77, 40 view: 99, 77 copy: 20, 30 same buffer: true, false
`(1, -1)` seleziona `20` e `30`. Scrivere tramite `view` modifica `source`, e scrivere tramite `source` modifica `view`. `copy` conserva `20, 30` e ha un buffer separato.
Lezioni correlate
- JavaScript · Lezione 2 · Avanzato · Versione: 4
Fonti
- 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