ArrayBuffer.prototype.resize()

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

Попробуйте

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

console.log(buffer.byteLength);
// Expected output: 8

buffer.resize(12);

console.log(buffer.byteLength);
// Expected output: 12

Синтаксис

resize(newLength)

Параметры

newLength

Новая длина в байтах, до которой изменяется размер ArrayBuffer.

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

Нет (undefined).

Исключения

TypeError

Выбрасывается, если ArrayBuffer отсоединен или не является изменяемым в размере.

RangeError

Выбрасывается, если newLength больше, чем maxByteLength ArrayBuffer.

Описание

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

Обратите внимание, что вы можете использовать resize() как для уменьшения, так и для увеличения ArrayBuffer — допускается, чтобы newLength был меньше текущей byteLength ArrayBuffer.

Примеры

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

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

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

if (buffer.resizable) {
  console.log("Buffer is resizable!");
  buffer.resize(12);
}

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

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

См. также

• ArrayBuffer
• ArrayBuffer.prototype.resizable
• ArrayBuffer.prototype.maxByteLength