DataView

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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

Многобайтовые числовые форматы представляются в памяти по-разному в зависимости от архитектуры машины (смотрите Endianness для объяснения). Методы доступа DataView предоставляют явный способ обращения к данным вне зависимости от порядка байтов платформы.

const littleEndian = (() => { const buffer = new ArrayBuffer(2); new DataView(buffer).setInt16(0, 256, true /* littleEndian */); // Int16Array использует порядок байтов платформы. return new Int16Array(buffer)[0] === 256; })(); console.log(littleEndian); // true или false

64-битные целые числа

Некоторые браузеры не поддерживают DataView.prototype.setBigInt64() и DataView.prototype.setBigUint64(). Поэтому для использования 64-битных операций, которые будут работать в любом браузере, можно реализовать собственную функцию getUint64() для получения значений с точностью до Number.MAX_SAFE_INTEGER, чего достаточно в большинстве случаев.

function getUint64(dataview, byteOffset, littleEndian) { // разбиваем 64-битное число на две 32-битных (по 4 байта) части const left = dataview.getUint32(byteOffset, littleEndian); const right = dataview.getUint32(byteOffset + 4, littleEndian); // объединяем два 32-битных значения const combined = littleEndian ? left + 2 ** 32 * right : 2 ** 32 * left + right; if (!Number.isSafeInteger(combined)) console.warn( combined, "превышает MAX_SAFE_INTEGER. Точность может быть потеряна", ); return combined; }

В случае если вам всё же нужен полный 64-битный диапазон, можно создать BigInt. Хотя работа со встроенными значениями BigInt намного быстрее, чем с эквивалентами из самостоятельных реализаций, использование значений BigInt всегда будет намного медленнее, чем 32-битных целых чисел, из-за характера их переменного размера в JavaScript.

const BigInt = window.BigInt, bigThirtyTwo = BigInt(32), bigZero = BigInt(0); function getUint64BigInt(dataview, byteOffset, littleEndian) { // разбиваем 64-битное число на две 32-битных (по 4 байта) части const left = BigInt(dataview.getUint32(byteOffset | 0, !!littleEndian) >>> 0); const right = BigInt( dataview.getUint32(((byteOffset | 0) + 4) | 0, !!littleEndian) >>> 0, ); // объединяем два 32-битных значения и возвращаем return littleEndian ? (right << bigThirtyTwo) | left : (left << bigThirtyTwo) | right; }

Конструктор

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

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

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

DataView.prototype.buffer: ArrayBuffer, связанный с представлением. Устанавливается в момент создания и доступно только для чтения.
DataView.prototype.byteLength: Размер представления в байтах. Устанавливается в момент создания и доступно только для чтения.
DataView.prototype.byteOffset: Смещение представления в байтах от начала его ArrayBuffer. Устанавливается в момент создания и доступно только для чтения.
DataView.prototype.constructor: Функция-конструктор, создающая экземпляр объекта. Для экземпляров DataView начальным значением является конструктор DataView.
DataView.prototype[@@toStringTag]: Начальным значением свойства @@toStringTag является строка "DataView". Это свойство используется в Object.prototype.toString().

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

DataView.prototype.getBigInt64(): Читает 8 байтов начиная с указанного смещения этого DataView и интерпретирует их как 64-битное знаковое целое число.
DataView.prototype.getBigUint64(): Читает 8 байтов начиная с указанного смещения этого DataView и интерпретирует их как 64-битное беззнаковое целое число.
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.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

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

Specification
ECMAScript® 2026 Language Specification # sec-dataview-objects

DataView

Описание

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