DataView : ArrayBufferView

constructor

DataViews allow heterogeneous access to data stored in an ArrayBuffer. Values can be read and stored at any byte offset without alignment constraints.

Spec

Constructors

new DataView(buffer : ArrayBuffer, [byteOffset = 0 : Number, [byteLength : Number]]) : DataView

Creates a new DataView for buffer at the specified offset. If length is not specified, buffer.byteLength - byteOffset will be used.

Example:

var buffer = new ArrayBuffer(12);
var x = new DataView(buffer, 0);
x.setInt8(0, 22);
x.setFloat32(1, Math.PI);
console.log(x.getInt8(0)); 
console.log(x.getFloat32(1));

Run

Results:

Instance Properties

buffer : ArrayBuffer

Returns the underlying buffer for this.

Example:

var buffer = new ArrayBuffer(12);
var x = new DataView(buffer);
console.log(x.buffer === buffer);

Run

Results:

byteLength : Number

The length of this in bytes.

Example:

var buffer = new ArrayBuffer(12);
var x = new DataView(buffer, 4, 2);
console.log(x.byteLength);

Run

Results:

byteOffset : Number

The offset into this.buffer where the view starts.

Example:

var buffer = new ArrayBuffer(12);
var x = new DataView(buffer, 4, 2);
console.log(x.byteOffset);

Run

Results:

Instance Methods

getBigInt64(byteOffset : Number, [littleEndian = false : Boolean]) : BigInt

Returns a signed 64 bit integer out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 7).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setBigInt64(1, 123456790n);
console.log(x.getBigInt64(1));

Run

Results:

Spec

getBigUint64(byteOffset : Number, [littleEndian = false : Boolean]) : BigInt

Returns an unsigned 64 bit integer out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 7).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setBigInt64(1, 123456790n);
console.log(x.getBigInt64(1));

Run

Results:

Spec

getFloat32(byteOffset : Number, [littleEndian = false : Boolean]) : Number

Returns a 32 bit floating point number out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 3).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setFloat32(1, Math.PI);
console.log(x.getFloat32(1)); 
console.log(Math.PI);

Run

Results:

getFloat64(byteOffset : Number, [littleEndian = false : Boolean]) : Number

Returns a 64 bit floating point number out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 7).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setFloat64(1, Math.PI);
console.log(x.getFloat64(1)); 
console.log(Math.PI);

Run

Results:

getInt16(byteOffset : Number, [littleEndian = false : Boolean]) : Number

Returns a signed 16 bit integer out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 1).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setInt16(1, 1234);
console.log(x.getInt16(1));

Run

Results:

getInt32(byteOffset : Number, [littleEndian = false : Boolean]) : Number

Returns a signed 32 bit integer out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 3).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setInt32(1, 1234);
console.log(x.getInt32(1));

Run

Results:

getInt8(byteOffset : Number) : Number

Returns a signed byte out of this at the specified offset.

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setInt8(1, 123);
console.log(x.getInt8(1));

Run

Results:

getUint16(byteOffset : Number, [littleEndian = false : Boolean]) : Number

Returns an unsigned 16 bit integer out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 1).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setUint16(1, 1234);
console.log(x.getUint16(1));

Run

Results:

getUint32(byteOffset : Number, [littleEndian = false : Boolean]) : Number

Returns an unsigned 32 bit integer out of this at the specified offset. If littleEndian is true, the value will be read as little endian (least significant byte is at byteOffset and most significant at byteOffset + 3).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setUint32(1, 1234);
console.log(x.getUint32(1));

Run

Results:

getUint8(byteOffset : Number) : Number

Returns an unsigned byte out of this at the specified offset.

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setUint8(1, 123);
console.log(x.getUint8(1));

Run

Results:

setBigInt64(byteOffset : Number, value : BigInt, [littleEndian = false : Boolean]) : undefined

Stores a signed 64 bit integer into this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 7).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setBigInt64(1, 123456790n);
console.log(x.getBigInt64(1));

Run

Results:

Spec

setBigUint64(byteOffset : Number, value : BigInt, [littleEndian = false : Boolean]) : undefined

Stores an unsigned 64 bit integer into this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 7).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setBigUint64(1, 123456790n);
console.log(x.getBigUint64(1));

Run

Results:

Spec

setFloat32(byteOffset : Number, value : Number, [littleEndian = false : Boolean]) : undefined

Converts value to a 32 bit floating point number and stores it into this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 3).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setFloat32(1, Math.PI);
console.log(x.getFloat32(1)); 
console.log(Math.PI);

Run

Results:

setFloat64(byteOffset : Number, value : Number, [littleEndian = false : Boolean]) : undefined

Stores value as a 64 bit floating point number in this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 7).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setFloat64(1, Math.PI);
console.log(x.getFloat64(1)); 
console.log(Math.PI);

Run

Results:

setInt16(byteOffset : Number, value : Number, [littleEndian = false : Boolean]) : undefined

Stores a signed 16 bit integer into this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 1).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setInt16(1, 1234);
console.log(x.getInt16(1));

Run

Results:

setInt32(byteOffset : Number, value : Number, [littleEndian = false : Boolean]) : undefined

Stores a signed 32 bit integer into this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 3).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setInt32(1, 1234);
console.log(x.getInt32(1));

Run

Results:

setInt8(byteOffset : Number, value : Number) : undefined

Stores a signed byte into this at the specified offset.

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setInt8(1, 123);
console.log(x.getInt8(1));

Run

Results:

setUint16(byteOffset : Number, value : Number, [littleEndian = false : Boolean]) : undefined

Stores an unsigned 16 bit integer into this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 1).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setUint16(1, 1234);
console.log(x.getUint16(1));

Run

Results:

setUint32(byteOffset : Number, value : Number, [littleEndian = false : Boolean]) : undefined

Stores an unsigned 32 bit integer into this at the specified offset. If littleEndian is true, the value will be stored as little endian (least significant byte is at byteOffset and most significant at byteOffset + 3).

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setUint32(1, 1234);
console.log(x.getUint32(1));

Run

Results:

setUint8(byteOffset : Number, value : Number) : undefined

Stores an unsigned byte into this at the specified offset.

Example:

var x = new DataView(new ArrayBuffer(12), 0);
x.setUint8(1, 123);
console.log(x.getUint8(1));

Run

Results:

home license contribute feedback toggle light/dark mode