This page was translated from English by the community.Learn more and join the MDN Web Docs community.
Типизированные массивы JavaScript
Типизированные массивы в JavaScript являются массивоподобными объектами, предоставляющими механизм доступа к сырым двоичным данным. Как вы уже можете знать, массивArray растёт и обрезается динамически, и может содержать элементы любого типа JavaScript. Благодаря оптимизациям JavaScript движков, массивы остаются быстрыми. Однако, со временем, веб-приложения становятся все более и более мощными, появляется необходимость работы с аудио- и видео-данными, требуется доступ к сырым данным WebSocket, и так далее. Становится очевидным, что возможность быстрой и эффективной работы с двоичными данными в JavaScript будет очень полезной, для чего типизированные массивы и предназначены.
Не следует путать типизированные массивы с обычными массивами: так, например, вызовArray.isArray() для типизированного массива вернётfalse. Более того, не все методы, доступные для обычных массивов поддерживаются типизированными массивами (например, push и pop).
In this article
Буферы и представления: архитектура типизированных массивов
Для достижения максимальной гибкости и производительности, реализация типизированных массивов в JavaScript разделена набуферы ипредставления. Буфер (ArrayBuffer) –– это объект, представляющий из себя набор данных. Он не имеет формата и не предоставляет возможности доступа к своему содержимому. Для доступа к памяти буфера вам нужно использовать представление. Представление предоставляет контекст: тип данных, начальную позицию в буфере и количество элементов. Это позволяет представить данные в виде типизированного массива.

ArrayBuffer
ОбъектArrayBuffer –– это набор бинарных данных с фиксированной длиной. Вы не можете манипулировать содержимымArrayBuffer напрямую. Вместо этого, необходимо создать типизированное представлениеDataView, которое будет отображать буфер в определённом формате, и даст доступ на запись и чтение его содержимого.
Типизированные представления
Название типизированного представления массива говорит само за себя. Оно представляет массив в распространённых числовых форматах, таких какInt8,Uint32,Float64 и так далее. Среди прочих, существует специальное представлениеUint8ClampedArray. Оно ограничивает значения интервалом от 0 до 255. Это полезно, например, приОбработке данных изображения в Canvas.
DataView
ОбъектDataView –– это низкоуровневый интерфейс, предоставляющий API для записи/чтения произвольных данных в буфер. Это полезно при работе с различными типами данных, например. В то время как типизированные представления всегда имеют порядок байт (смотритеEndianness) соответствующий используемому в вашей операционной системе,DataView позволяет контроллировать порядок байт (byte-order). По умолчанию это big-endian, но через API можно установить little-endian.
Веб API, использующие типизированные массивы
FileReader.prototype.readAsArrayBuffer()Метод
FileReader.prototype.readAsArrayBuffer()читает содержимое заданногоBlobилиFile.XMLHttpRequest.prototype.send()Метод
send()экземпляраXMLHttpRequestтеперь поддерживает в качестве аргументаArrayBuffer.ImageData.dataИмеет тип
Uint8ClampedArrayи представляет изображение в виде одномерного массива, где цветовые компоненты расположены в порядке RGBA, и их значения принудительно ограничены диапазоном от 0 до 255.
Примеры
>Использование представлений с буферами
Прежде всего, необходимо создать буфер с фиксированной длиной 16 байт:
var buffer = new ArrayBuffer(16);На данном этапе мы имеем область памяти в 16 байт, инициализированной нулевыми значениями. Всё, что мы можем сделать сейчас, это убедиться, что длина буфера действительно 16 байт:
if (buffer.byteLength === 16) { console.log("Да, это 16 байт.");} else { console.log("О нет, размер не наш!");}Прежде чем мы сможем приступить к полноценной работе с памятью, нам нужно создать представление. Давайте создадим представление, которое отображает буфер как массив из 32-битных целочисленных значений со знаком:
var int32View = new Int32Array(buffer);Теперь мы можем получить доступ к элементам представления как к элементам обычного массива:
for (var i = 0; i < int32View.length; i++) { int32View[i] = i * 2;}Этот код поместит 4 элемента в буфер (4 элемента по 4 байта даст 16 байт) со следующими значениям:0,2,4 и6.
Множество представлений для одних и тех же данных
Всё становится намного интереснее, если создать несколько разных представлений для одного и того же буфера. Например, приведённый выше код можно дополнить следующим образом:
var int16View = new Int16Array(buffer);for (var i = 0; i < int16View.length; i++) { console.log("Entry " + i + ": " + int16View[i]);}Здесь мы создаём 16-битное целочисленное представление, которое ссылается на тот же самый буфер, что и 32-битное представление, и затем выводим все 16-битные элементы этого представления. Мы получим следующий вывод: 0, 0, 2, 0, 4, 0, 6, 0.
Можно пойти дальше. Оцените этот код:
int16View[0] = 32;console.log("Элемент 0 в 32-битном представлении теперь равен " + int32View[0]);Результатом выполнения станет текст: "Элемент 0 в 32-битном представлении теперь равен 32". Другими словами, два массива на самом деле являются лишь разными представлениями одного и того же буфера данных в разных форматах. Вы можете повторить это спредставлениями любого типа.
Работа со сложными структурами данных
Комбинируя буфер и множество представлений разного формата, имеющих разные смещения относительно начала буфера, можно управляться с объектами содержащими разнородные данные. Это позволяет, к примеру, взаимодействовать со сложными структурам изWebGL, файлами данных или структурами языка C (сопоставление данных JS и C).
Рассмотрим следующую структуру из языка C:
struct someStruct { unsigned long id; char username[16]; float amountDue;};Получить доступ к полям этой структуры можно следующим образом:
var buffer = new ArrayBuffer(24);// ... поместить данные структуры в буфер ...var idView = new Uint32Array(buffer, 0, 1);var usernameView = new Uint8Array(buffer, 4, 16);var amountDueView = new Float32Array(buffer, 20, 1);Теперь получить или изменить значение поляamountDue, к примеру, можно путём обращения кamountDueView[0].
Примечание:Выравнивание данных в языке C является платформозависимым. Принимайте меры по вычислению правильных отступов в данных с учётом выравнивания.
Преобразование в обычные массивы
Иногда после обработки типизированного массива бывает полезно конвертировать его в обычный массив, чтобы получить доступ к методам прототипаArray. Для этих целей существует методArray.from. А в тех случаях, когдаArray.from не поддерживается, используйте следующий код:
var typedArray = new Uint8Array([1, 2, 3, 4]), normalArray = Array.prototype.slice.call(typedArray);normalArray.length === 4;normalArray.constructor === Array;