DataView

Представление DataView предоставляет низкоуровневый интерфейс для чтения и записи нескольких числовых типов в бинарном ArrayBuffer, не заботясь о порядке байтов платформы.

Описание

Порядок байтов

Многобайтовые числовые форматы представляются в памяти по-разному в зависимости от архитектуры машины — см. Порядок байтов для объяснения. Аксессоры DataView обеспечивают явный контроль над тем, как осуществляется доступ к данным, независимо от порядка байтов исполняющего компьютера. Например, память WebAssembly всегда является little-endian (с младшим байтом вперед), поэтому вам следует использовать DataView вместо типизированных массивов для чтения и записи многобайтовых значений. См. WebAssembly.Memory для примера.

const littleEndian = (() => {
  const buffer = new ArrayBuffer(2);
  new DataView(buffer).setInt16(0, 256, true /* littleEndian */);
  // Int16Array uses the platform's endianness.
  return new Int16Array(buffer)[0] === 256;
})();
console.log(littleEndian); // true or false

Конструктор

DataView()

Создает новый объект DataView.

Свойства экземпляра

Эти свойства определены в DataView.prototype и являются общими для всех экземпляров DataView.

DataView.prototype.buffer

Возвращает ArrayBuffer, на который ссылается DataView.

DataView.prototype.byteLength

Возвращает длину (в байтах) DataView.

DataView.prototype.byteOffset

Возвращает смещение (в байтах) DataView от начала его ArrayBuffer.

DataView.prototype.constructor

Функция-конструктор, создавшая объект экземпляра. Для экземпляров DataView начальным значением является конструктор DataView.

DataView.prototype[Symbol.toStringTag]

Начальное значение свойства [Symbol.toStringTag] — это строка "DataView". Это свойство используется в Object.prototype.toString().

Методы экземпляра

DataView.prototype.getBigInt64()

Читает 8 байтов, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 64-битное целое число со знаком.

DataView.prototype.getBigUint64()

Читает 8 байтов, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 64-битное целое число без знака.

DataView.prototype.getFloat16()

Читает 2 байта, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 16-битное число с плавающей запятой.

DataView.prototype.getFloat32()

Читает 4 байта, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 32-битное число с плавающей запятой.

DataView.prototype.getFloat64()

Читает 8 байтов, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 64-битное число с плавающей запятой.

DataView.prototype.getInt16()

Читает 2 байта, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 16-битное целое число со знаком.

DataView.prototype.getInt32()

Читает 4 байта, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 32-битное целое число со знаком.

DataView.prototype.getInt8()

Читает 1 байт по указанному байтовому смещению этого DataView и интерпретирует его как 8-битное целое число со знаком.

DataView.prototype.getUint16()

Читает 2 байта, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 16-битное целое число без знака.

DataView.prototype.getUint32()

Читает 4 байта, начиная с указанного байтового смещения этого DataView, и интерпретирует их как 32-битное целое число без знака.

DataView.prototype.getUint8()

Читает 1 байт по указанному байтовому смещению этого DataView и интерпретирует его как 8-битное целое число без знака.

DataView.prototype.setBigInt64()

Принимает BigInt и сохраняет его как 64-битное целое число со знаком в 8 байтах, начиная с указанного байтового смещения этого DataView.

DataView.prototype.setBigUint64()

Принимает BigInt и сохраняет его как 64-битное целое число без знака в 8 байтах, начиная с указанного байтового смещения этого DataView.

DataView.prototype.setFloat16()

Принимает число и сохраняет его как 16-битное число с плавающей запятой в 2 байтах, начиная с указанного байтового смещения этого DataView.

DataView.prototype.setFloat32()

Принимает число и сохраняет его как 32-битное число с плавающей запятой в 4 байтах, начиная с указанного байтового смещения этого DataView.

DataView.prototype.setFloat64()

Принимает число и сохраняет его как 64-битное число с плавающей запятой в 8 байтах, начиная с указанного байтового смещения этого DataView.

DataView.prototype.setInt16()

Принимает число и сохраняет его как 16-битное целое число со знаком в 2 байтах по указанному байтовому смещению этого DataView.

DataView.prototype.setInt32()

Принимает число и сохраняет его как 32-битное целое число со знаком в 4 байтах по указанному байтовому смещению этого DataView.

DataView.prototype.setInt8()

Принимает число и сохраняет его как 8-битное целое число со знаком в байте по указанному байтовому смещению этого DataView.

DataView.prototype.setUint16()

Принимает число и сохраняет его как 16-битное целое число без знака в 2 байтах по указанному байтовому смещению этого DataView.

DataView.prototype.setUint32()

Принимает число и сохраняет его как 32-битное целое число без знака в 4 байтах по указанному байтовому смещению этого DataView.

DataView.prototype.setUint8()

Принимает число и сохраняет его как 8-битное целое число без знака в байте по указанному байтовому смещению этого DataView.

Примеры

Использование DataView

const buffer = new ArrayBuffer(16);
const view = new DataView(buffer, 0);

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

Спецификации

Совместимость с браузерами

См. также

• Полифилл DataView в core-js
• ArrayBuffer
• SharedArrayBuffer