CKTIS / JavaScript
Array tipizzati: numero di elementi, byte della vista e byte del buffer
Distingui il buffer sottostante (`.buffer`), il numero di elementi (`.length`), i byte della vista (`.byteLength`) e la dimensione attuale dell’intero buffer (`.buffer.byteLength`).
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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 restituisce lo stesso oggetto buffer senza copiare i dati: un ArrayBuffer o, per una vista su memoria condivisa, uno SharedArrayBuffer. view.length conta gli elementi, mentre view.byteLength conta i byte della vista: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength indica la dimensione attuale in byte dell’intero buffer, non quella massima. SharedArrayBuffer ha un proprio getter byteLength. Sono proprietà di sola lettura, non metodi.
new Uint16Array(n) alloca spazio per n elementi. Invece new Uint16Array(buffer, byteOffset, length) crea una vista senza copiare i dati: l’offset è espresso in byte e la lunghezza in elementi. Un offset non allineato o un intervallo che supera i limiti del buffer genera RangeError. Se il destinatario deve ricevere solo i dati della vista, passagli una copia del relativo intervallo di byte, non view.buffer, che dà accesso anche ai byte esterni alla vista.
Con un ArrayBuffer ridimensionabile (ECMAScript 2024), se ometti length, la vista comprende tutti gli elementi interi che rientrano tra il suo offset e la fine del buffer. Un valore esplicito di length fissa l’intervallo della vista. Riducendo il buffer, la vista può uscire dai limiti: view.length e view.byteLength restituiscono allora 0. Ingrandendo di nuovo il buffer, l’intervallo può tornare valido. Prima di usare il ridimensionamento, verifica che l’ambiente di esecuzione di destinazione lo supporti.
Sul Web, trasferire un ArrayBuffer può scollegare il buffer originale dai suoi dati. view.buffer restituisce ancora lo stesso oggetto, ma buffer.byteLength, view.length e view.byteLength restituiscono 0. Lo zero da solo non dimostra che il buffer sia scollegato: il buffer o la vista possono essere semplicemente vuoti.
Esempi
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}Risultato
true | 3 | 6 | 16
`true | 3 | 6 | 16` conferma che la vista usa lo stesso buffer: parte dall’offset di 4 byte e comprende 3 elementi di 2 byte ciascuno in un buffer da 16 byte.
Lezioni correlate
- JavaScript · Lezione 5 · Avanzato · Versione: 4
Fonti
- 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