Skip to content

Latest commit

 

History

History
89 lines (71 loc) · 3.22 KB

arraybuffer-object.md

File metadata and controls

89 lines (71 loc) · 3.22 KB
title ms.custom ms.date ms.prod ms.reviewer ms.suite ms.technology ms.tgt_pltfrm ms.topic dev_langs ms.assetid caps.latest.revision author ms.author manager
ArrayBuffer Object | Microsoft Docs
01/18/2017
windows-client-threshold
devlang-javascript
language-reference
JavaScript
TypeScript
DHTML
9fda1261-f450-493b-b3db-ecfa9ca93cd7
17
mikejo5000
mikejo
ghogen

ArrayBuffer Object

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);

Parameters

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.

Properties

The following table lists the properties of the ArrayBuffer object.

Property Description
byteLength Property Read-only. The length of the ArrayBuffer (in bytes).

Functions

The following table lists the functions of the ArrayBuffer object.

Property Description
ArrayBuffer.isView Function Determines whether an object provides a view of the buffer.

Methods

The following table lists the methods of the ArrayBuffer object.

Property Description
slice Method Returns a section of an ArrayBuffer.

Example

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.

Requirements

[!INCLUDEjsv10]