Movatterモバイル変換


[0]ホーム

URL:


MDN Web Docs

Эта страница была переведена с английского языка силами сообщества. Вы тоже можете внести свой вклад, присоединившись к русскоязычному сообществу MDN Web Docs.

Типизированные массивы JavaScript

Типизированные массивы в JavaScript являются массивоподобными объектами, предоставляющими механизм доступа к сырым двоичным данным. Как вы уже можете знать, массивArray растёт и обрезается динамически, и может содержать элементы любого типа JavaScript. Благодаря оптимизациям JavaScript движков, массивы остаются быстрыми. Однако, со временем, веб-приложения становятся все более и более мощными, появляется необходимость работы с аудио- и видео-данными, требуется доступ к сырым данным WebSocket, и так далее. Становится очевидным, что возможность быстрой и эффективной работы с двоичными данными в JavaScript будет очень полезной, для чего типизированные массивы и предназначены.

Не следует путать типизированные массивы с обычными массивами: так, например, вызовArray.isArray() для типизированного массива вернётfalse. Более того, не все методы, доступные для обычных массивов поддерживаются типизированными массивами (например, push и pop).

Буферы и представления: архитектура типизированных массивов

Для достижения максимальной гибкости и производительности, реализация типизированных массивов в JavaScript разделена набуферы ипредставления. Буфер (ArrayBuffer) –– это объект, представляющий из себя набор данных. Он не имеет формата и не предоставляет возможности доступа к своему содержимому. Для доступа к памяти буфера вам нужно использовать представление. Представление предоставляет контекст: тип данных, начальную позицию в буфере и количество элементов. Это позволяет представить данные в виде типизированного массива.

Typed arrays in an 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 байт:

js
var buffer = new ArrayBuffer(16);

На данном этапе мы имеем область памяти в 16 байт, инициализированной нулевыми значениями. Всё, что мы можем сделать сейчас, это убедиться, что длина буфера действительно 16 байт:

js
if (buffer.byteLength === 16) {  console.log("Да, это 16 байт.");} else {  console.log("О нет, размер не наш!");}

Прежде чем мы сможем приступить к полноценной работе с памятью, нам нужно создать представление. Давайте создадим представление, которое отображает буфер как массив из 32-битных целочисленных значений со знаком:

js
var int32View = new Int32Array(buffer);

Теперь мы можем получить доступ к элементам представления как к элементам обычного массива:

js
for (var i = 0; i < int32View.length; i++) {  int32View[i] = i * 2;}

Этот код поместит 4 элемента в буфер (4 элемента по 4 байта даст 16 байт) со следующими значениям:0,2,4 и6.

Множество представлений для одних и тех же данных

Всё становится намного интереснее, если создать несколько разных представлений для одного и того же буфера. Например, приведённый выше код можно дополнить следующим образом:

js
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.

Можно пойти дальше. Оцените этот код:

js
int16View[0] = 32;console.log("Элемент 0 в 32-битном представлении теперь равен " + int32View[0]);

Результатом выполнения станет текст: "Элемент 0 в 32-битном представлении теперь равен 32". Другими словами, два массива на самом деле являются лишь разными представлениями одного и того же буфера данных в разных форматах. Вы можете повторить это спредставлениями любого типа.

Работа со сложными структурами данных

Комбинируя буфер и множество представлений разного формата, имеющих разные смещения относительно начала буфера, можно управляться с объектами содержащими разнородные данные. Это позволяет, к примеру, взаимодействовать со сложными структурам изWebGL, файлами данных или структурами языка C (сопоставление данных JS и C).

Рассмотрим следующую структуру из языка C:

cpp
struct someStruct {  unsigned long id;  char username[16];  float amountDue;};

Получить доступ к полям этой структуры можно следующим образом:

js
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 не поддерживается, используйте следующий код:

js
var typedArray = new Uint8Array([1, 2, 3, 4]),  normalArray = Array.prototype.slice.call(typedArray);normalArray.length === 4;normalArray.constructor === Array;

Смотрите также

Help improve MDN

Learn how to contribute.

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2025 Movatter.jp