This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

ArrayBuffer

Summary

Represents a raw buffer of binary data, which is used to store data for the different typed arrays. ArrayBuffers cannot be read from or written to directly, but can be passed to a typed array or DataView Object to interpret the raw buffer as needed.

For more information about typed arrays, see Typed Arrays.

Syntax

arrayBuffer = new ArrayBuffer(length);
arrayBuffer
Required. The variable name to which the ArrayBuffer object is assigned.
length
The length of the buffer. The contents of the ArrayBuffer are initialized to 0. If the requested number of bytes could not be allocated an exception is raised.

Examples

The following example shows how to use an ArrayBuffer object to process the binary data acquired from an XmlHttpRequest. You can use a DataView Object to get the individual values.

var req = new XMLHttpRequest();
     req.open('GET', "http://www.example.com");
     req.responseType = "arraybuffer";
     req.send();

     req.onreadystatechange = function () {
         if (req.readyState === 4) {
             var buffer = req.response;
             var dataview = new DataView(buffer);
             var ints = new Int32Array(buffer.byteLength / 4);
             for (var i = 0; i < ints.length; i++) {
                 ints[i] = dataview.getInt32(i * 4);
             }
         alert(ints[10]);
         }
     }

Remarks

For more information about using XmlHttpRequest , see XMLHttpRequest enhancements.

Properties

The following table lists the properties of the ArrayBuffer object.

PropertyDescription
byteLengthRead-only. The length of the ArrayBuffer (in bytes).

Attributions

  • Microsoft Developer Network: Article