SharedArrayBuffer
Объект SharedArrayBuffer
подобен ArrayBuffer, то есть это буфер фиксированной длины, использующийся для хранения любых бинарных данных. Главное отличие SharedArrayBuffer
от ArrayBuffer
заключается в том, что он используется для создания разделяемой области памяти. В отличие от ArrayBuffer
SharedArrayBuffer
не может быть откреплён от соответствующей ему области памяти.
Описание
Выделение и совместное использование памяти
Для совместного использования памяти с помощью объекта SharedArrayBuffer
между одним агентом в кластере и другим (агентом может быть как основная программа страницы сайта, так и один из её веб-воркеров) используются postMessage
и алгоритм структурированного клонирования.
Алгоритм структурированного клонирования принимает SharedArrayBuffers
и TypedArrays
, отображённый в SharedArrayBuffers
. В обоих случаях объект SharedArrayBuffer
передаётся получателю, что приводит к появлению нового приватного объекта SharedArrayBuffer внутри агента-получателя (так же как для ArrayBuffer
). Оба объекта SharedArrayBuffer
ссылаются на один и тот же блок общих данных, и побочный эффект, изменяющий блок данных в одном из агентов, в итоге проявится в другом агенте.
js
var sab = new SharedArrayBuffer(1024);
worker.postMessage(sab);
Обновление и синхронизация разделяемой памяти с помощью атомарных операций
Разделяемую память можно создавать и изменять одновременно в воркерах или основном потоке. В зависимости от системы (ЦПУ, ОС, браузера), распространение изменений по всем контекстам может занять некоторое время. Для синхронизации необходимы атомарные операции .
API, принимающие объекты SharedArrayBuffer
Требования безопасности
Разделяемая память и таймеры высокого разрешения были отключены в начале 2018 года из-за атаки Spectre. В 2020 году был стандартизирован новый, безопасный подход, чтобы включить разделяемую память обратно. При следовании следующим мерам безопасности postMessage() не будет выкидывать исключение для SharedArrayBuffer, и разделяемая память будет доступна в разных потоках.
`Основное требование — ваш документ должен находиться в безопасном контексте
Для документов верхнего уровня нужно устновить два заголовка, чтобы изолировать ваш сайт от других источников (cross-origin):
Cross-Origin-Opener-Policy со значением same-origin (защищает ваш источник от атаки)Cross-Origin-Embedder-Policy со значением require-corp (защищает жертв от вашего источника)Cross-Origin-Opener-Policy: same-origin Cross-Origin-Embedder-Policy: require-corp
Чтобы проверить, что изоляция от других источников прошла успешно, протестируйте свойство crossOriginIsolated, доступное для контекстов окна и воркера:
if (crossOriginIsolated) { // Начни работу с SharedArrayBuffer } else { // Сделай что-то другое }
Ознакомьтесь с планируемыми изменениями разделяемой памяти, которые начинают внедряться в браузерах (например, в Firefox 79).
Всегда используйте оператор new для создания SharedArrayBuffer
Конструкторы SharedArrayBuffer необходимо вызывать с помощью оператора new
. Вызов конструктора SharedArrayBuffer как функции без указания new вызовет ошибку TypeError
.
var sab = SharedArrayBuffer(1024);
// TypeError: вызов встроенного конструктора SharedArrayBuffer
// без new запрещеноvar sab = new SharedArrayBuffer(1024);КонструкторSharedArrayBuffer()Создаёт новый объект SharedArrayBuffer.СвойстваSharedArrayBuffer.prototype.byteLength
(en-US)Размер буферного массива в байтах. Задаётся при создании массива и не может быть изменён. Только для чтения.МетодыSharedArrayBuffer.prototype.slice(begin, end)
(en-US)Возвращает новый SharedArrayBuffer, чьё содержимое — копия байтов изначального SharedArrayBuffer с begin (начала) включительно до end (конца), но не включая его. Если параметры begin или end отрицательны, метод обращается к индексу массива, начиная с конца, а не с начала.ПримерыСоздание нового SharedArrayBuffervar sab = new SharedArrayBuffer(1024);Нарезание SharedArrayBuffersab.slice(); // SharedArrayBuffer { byteLength: 1024 }
sab.slice(2); // SharedArrayBuffer { byteLength: 1022 }
sab.slice(-2); // SharedArrayBuffer { byteLength: 2 }
sab.slice(0, 1); // SharedArrayBuffer { byteLength: 1 }Использование в буфере WebGLconst canvas = document.querySelector('canvas');
const gl = canvas.getContext('webgl');
const buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER, sab, gl.STATIC_DRAW);Спецификации
Specification |
---|
ECMAScript Language Specification # sec-sharedarraybuffer-objects |
BCD tables only load in the browser
Смотрите такжеAtomics
ArrayBuffer
Типизированные массивы JavaScriptВеб-воркерыparlib-simple — простая библиотека, предоставляющая синхронизацию и абстракции для распределённых работ.Разделяемая память — краткая инструкция
Немного о новых примитивах JavaScript для параллелизации работ – Mozilla Hacks`