The DataView() constructor creates DataView objects.
JavaScript Demo: DataView() constructor
// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);
// Create a couple of views
const view1 = new DataView(buffer);
const view2 = new DataView(buffer, 12, 4); // From byte 12 for the next 4 bytes
view1.setInt8(12, 42); // Put 42 in slot 12
console.log(view2.getInt8(0));
// Expected output: 42
Syntax
new DataView(buffer)
new DataView(buffer, byteOffset)
new DataView(buffer, byteOffset, byteLength)
[!NOTE]
DataView()can only be constructed withnew. Attempting to call it withoutnewthrows a TypeError.
Parameters
buffer- : An existing ArrayBuffer or SharedArrayBuffer to use as
the storage backing the new
DataViewobject.
- : An existing ArrayBuffer or SharedArrayBuffer to use as
the storage backing the new
byteOffset- : The offset, in bytes, to the first byte in the above buffer for the new view to reference. If unspecified, the buffer view starts with the first byte.
byteLength- : The number of elements in the byte array. If unspecified, the view's length will match the buffer's length.
Return value
A new DataView object representing the specified data buffer.
Exceptions
- RangeError
- : Thrown if the
byteOffsetorbyteLengthparameter values result in the view extending past the end of the buffer. In other words,byteOffset + byteLength > buffer.byteLength.
- : Thrown if the
Examples
Using DataView
const buffer = new ArrayBuffer(16);
const view = new DataView(buffer, 0);
view.setInt16(1, 42);
view.getInt16(1); // 42
Specifications
Browser compatibility
See also
- Polyfill of
DataViewincore-js - DataView
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
