SharedArrayBuffer.prototype.grow()

Метод grow() экземпляров SharedArrayBuffer увеличивает SharedArrayBuffer до указанного размера, в байтах.

Синтаксис

grow(newLength)

Параметры

newLength

Новая длина, в байтах, до которой нужно изменить SharedArrayBuffer.

Возвращаемое значение

Нет (undefined).

Исключения

TypeError

Генерируется, если SharedArrayBuffer не подлежит расширению.

RangeError

Генерируется, если newLength больше, чем maxByteLength SharedArrayBuffer, или меньше, чем byteLength.

Описание

Метод grow() увеличивает SharedArrayBuffer до размера, указанного параметром newLength, при условии, что SharedArrayBuffer является расширяемым (growable), а новый размер меньше или равен maxByteLength SharedArrayBuffer. Новые байты инициализируются значением 0.

Примеры

Обратите внимание, что эти примеры не могут быть запущены непосредственно из консоли или произвольной веб-страницы, поскольку SharedArrayBuffer не определен, если не соблюдены его требования безопасности.

Использование grow()

В этом примере мы создаем 8-байтовый буфер, который может быть увеличен до максимальной длины 16 байт, затем проверяем его свойство growable, увеличивая его, если growable возвращает true:

const buffer = new SharedArrayBuffer(8, { maxByteLength: 16 });

if (buffer.growable) {
  console.log("SAB is growable!");
  buffer.grow(12);
}

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

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

См. также

• SharedArrayBuffer
• SharedArrayBuffer.prototype.growable
• SharedArrayBuffer.prototype.maxByteLength