DataView

DataView 视图是一个可以从 ArrayBuffer 对象中读写多种数值类型的底层接口，使用它时，不用考虑不同平台的字节序问题。

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.

语法

new DataView(buffer [, byteOffset [, byteLength]])

参数

buffer

一个 ArrayBuffer 或 SharedArrayBuffer  对象，DataView 对象的数据源。

byteOffset 可选

此 DataView 对象的第一个字节在 buffer 中的偏移。如果不指定则默认从第一个字节开始。

byteLength 可选

此 DataView 对象的字节长度。如果不指定则默认与 buffer 的长度相同。

返回值

一个 DataView 对象用来呈现指定的缓存区数据。

你可以认为返回的对象是一个二进制的解释器——它知道在读写的时候如何正确的转化字节码。这意味着会在字节水平处理整数和浮点转化、字节顺序等其他详情。

异常

RangeError

如果由偏移（byteOffset）和字节长度（byteLength）计算得到的结束位置超出了 buffer 的长度，抛出此异常。

例如，如果缓冲区是16个字节的长度。byteOffset是8，byteLength 是10，错误就会抛出，因为结果试图去呈现超出的2个字节。

描述

Endianness（字节序）

需要多个字节来表示的数值，在存储时其字节在内存中的相对顺序依据平台架构的不同而不同，参照 Endianness。而使用 DataView 的访问函数时不需要考虑平台架构中所使用的是哪种字节序。

var littleEndian = (function() {
  var buffer = new ArrayBuffer(2);
  new DataView(buffer).setInt16(0, 256, true /* 设置值时，使用小端字节序 */);
  // Int16Array 使用系统字节序（由此可以判断系统字节序是否为小端字节序）
  return new Int16Array(buffer)[0] === 256;
})();
console.log(littleEndian); // 返回 true 或 false

64-bit Integer Values（64位整数）

因为JavaScript目前不包括对64位整数值的标准支持，所以DataView不提供本机64位操作。作为解决方法，您可以实现自己的getUint64()函数，以获得精度高达Number.MAX_SAFE_INTEGER的值，可以满足某些特定情况的需求。

function getUint64(dataview, byteOffset, littleEndian) {
  // split 64-bit number into two 32-bit (4-byte) parts
  const left =  dataview.getUint32(byteOffset, littleEndian);
  const right = dataview.getUint32(byteOffset+4, littleEndian);

  // combine the two 32-bit values
  const combined = littleEndian? left + 2**32*right : 2**32*left + right;

  if (!Number.isSafeInteger(combined))
    console.warn(combined, 'exceeds MAX_SAFE_INTEGER. Precision may be lost');

  return combined;
}

或者，如果需要填满64位，可以创建一个BigInt。

function getUint64BigInt(dataview, byteOffset, littleEndian) {
  // split 64-bit number into two 32-bit (4-byte) parts
  const left = dataview.getUint32(byteOffset, littleEndian);
  const right = dataview.getUint32(byteOffset + 4, littleEndian);

  // combine the two 32-bit values as their hex string representations
  const combined = littleEndian ?
    right.toString(16) + left.toString(16).padStart(8, '0') :
    left.toString(16) + right.toString(16).padStart(8, '0');

  return BigInt(`0x${combined}`);
}

属性

所有 DataView 实例都继承自 DataView.prototype并且允许向 DataView 对象中添加额外属性。

方法

示例

var buffer = new ArrayBuffer(16);
var dv = new DataView(buffer, 0);

dv.setInt16(1, 42);
dv.getInt16(1); //42

规范

浏览器兼容性

兼容性提示

从 FireFox 40 开始， DataView 对象需要通过 new 操作符来构造。如果不使用 new 而是直接将 DataView() 作为函数调用的话会抛出 TypeError 异常。

var dv = DataView(buffer, 0); 
// 抛出异常，错误信息为：禁止不用new直接调用DataView的构造函数。
// TypeError: calling a builtin DataView constructor without new is forbidden

var dv = new DataView(buffer, 0);

相关链接

• jDataView：DataView 的垫片（polyfill）库，使其能够用于所有浏览器及 Node.js 环境。同时，该库还对 DataView 进行了一些扩展。
• ArrayBuffer
• SharedArrayBuffer