ArrayBuffer

L'oggetto ArrayBuffer viene utilizzato per rappresentare un buffer di lunghezza fissa di dati non elaborati. Non è possibile manipolare il contenuto di un ArrayBuffer, è possibile invece creare un array di oggetti tipizzati o un oggetto di tipo DataView che rappresenta il buffer in uno specifico formato ed utilizzare questo per leggere e scrivere il contenuto del buffer.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Sintassi

new ArrayBuffer(length)

Parametri

length

La dimensione, in bytes, dell'array buffer da creare.

Valori di ritorno

Un nuovo oggetto di tipo ArrayBuffer della dimensione specificata. Il suo contenuto è inzializzato a 0.

Eccezioni

Un RangeError viene generato se la lunghezza è maggiore di di Number.MAX_SAFE_INTEGER (>= 2 ** 53) oppure è negativa.

Descrizione

Il costruttore ArrayBuffer crea un nuovo ArrayBuffer di lunghezza specificata in bytes.

Ottenere un array buffer da dati pre-esistenti

• Da una stringa in Base64
• Da un file locale

Proprietà

ArrayBuffer.length

La dimensione del costruttore ArrayBuffer il cui valore è 1.

get ArrayBuffer[@@species]

La funzione costruttore utilizzata per creare oggetti derivati.

ArrayBuffer.prototype

Permette di aggiungere proprietà a tutti gli oggetti di tipo ArrayBuffer.

Metodi

ArrayBuffer.isView(arg)

Restituisce true se args è una delle viste di ArrayBuffer, come un array di oggetti tipizzato o un DataView. Altrimenti restituisce false.

ArrayBuffer.transfer(oldBuffer [, newByteLength])

Restituisce un nuovo ArrayBuffer i cui contenuti sono presi dai dati dell'oggetto oldBuffer e successivamente troncato o esteso a zero tramite newByteLength.

Istanze

Tutte le istanze di ArrayBuffer ereditano da ArrayBuffer.prototype.

Proprietà

Metodi

ArrayBuffer.slice()

Esegue le stesse operazioni di ArrayBuffer.prototype.slice().

Esempio

In questo esempio viene creato un buffer di 8 byte con una vista di tipo Int32Array che si riferisce al buffer

var buffer = new ArrayBuffer(8);
var view   = new Int32Array(buffer);

Specifiche

Browser compatibility

Note sulla compatibilità

Con ECMAScript 2015, ArrayBuffer deve essere inizializzato con l'operatore  new. Inizializzare ArrayBuffer senza l'operatore new genererà un TypeError.

var dv = ArrayBuffer(10);
// TypeError: inizializzaree un ArrayBuffer senza il costruttore new 
// genererà un errore

var dv = new ArrayBuffer(10);

Leggi anche

• JavaScript typed arrays
• SharedArrayBuffer