CKTIS / JavaScript
ArrayBuffer: buffer di byte grezzi
ArrayBuffer riserva memoria di byte inizializzata a zero, accessibile tramite typed array o DataView e facoltativamente ridimensionabile.
Versione: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2
Sintassi
new ArrayBuffer(byteLength[, { maxByteLength }])new ArrayBuffer(byteLength, options?) crea un blocco di memoria riempito di zeri. ArrayBuffer non espone direttamente byte indicizzati; lettura e scrittura richiedono una vista come Uint8Array o DataView. byteLength passa attraverso ToIndex: una parte frazionaria finita è troncata verso zero, NaN e undefined diventano 0 e persino -0.5 diventa -0, quindi lunghezza 0. Chiamare il costruttore senza new genera TypeError.
options.maxByteLength richiede un buffer ridimensionabile se il limite non è inferiore alla dimensione iniziale. resize(newLength) conserva il prefisso comune, elimina byte riducendo e aggiunge zeri aumentando; le viste che seguono la lunghezza si adattano. Un buffer fisso non può essere ridimensionato. slice() copia un intervallo e un trasferimento può scollegare la sorgente.
Solo un risultato negativo dopo ToIntegerOrInfinity, +Infinity o -Infinity, il superamento dell’intervallo numerico o del limite pratico di memoria dell’implementazione, oppure un massimo sotto la dimensione iniziale genera RangeError. Operazioni sui dati di un buffer scollegato e resize() su uno fisso generano TypeError. Gli errori di conversione si propagano. Ridimensionamento e trasferimenti sono stati standardizzati in ECMAScript 2024.
L’etichetta di ambito ArrayBuffer.byteLength indica la proprietà di istanza usata come buffer.byteLength, non una proprietà statica del costruttore ArrayBuffer. Questo accessor di sola lettura restituisce il numero corrente di byte: il risultato cambia dopo resize() su un buffer ridimensionabile ed è 0 dopo lo scollegamento. Non esiste un setter; applicare il getter a un receiver incompatibile, incluso SharedArrayBuffer, genera TypeError.
Esempi
const buffer = new ArrayBuffer(4, { maxByteLength: 8 });
const bytes = new Uint8Array(buffer);
bytes.set([10, 20, 30, 40]);
console.log(buffer.byteLength, buffer.maxByteLength, buffer.resizable);
buffer.resize(6);
console.log(buffer.byteLength, Array.from(new Uint8Array(buffer)).join(","));
const copy = buffer.slice(1, 4);
console.log(copy.byteLength, Array.from(new Uint8Array(copy)).join(","));
try { new ArrayBuffer(4).resize(2); } catch (error) { console.log(error instanceof TypeError); }Risultato
4 8 true 6 10,20,30,40,0,0 3 20,30,40 true