База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

ArrayBuffer: буфер за необработени байтове

ArrayBuffer заделя байтова памет, запълнена с нули, достъпна чрез typed array или DataView и по избор с променлив размер.

Версия: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2

Синтаксис

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) създава блок памет, запълнен с нули. Самият ArrayBuffer не предоставя индексирани байтове; четенето и записът изискват изглед като Uint8Array или DataView. byteLength преминава през ToIndex: крайната дробна част се отрязва към нула, NaN и undefined стават 0, а дори -0.5 става -0 и следователно дължина 0. Извикване без new хвърля TypeError.

options.maxByteLength заявява буфер с променлив размер, ако лимитът не е под началния размер. resize(newLength) запазва общия префикс, изхвърля байтове при свиване и добавя нули при увеличаване; изгледите, следящи дължината, се настройват. Фиксиран буфер не може да се преоразмерява. slice() копира диапазон, а transfer може да отдели източника.

Едва отрицателен резултат след ToIntegerOrInfinity, +Infinity или -Infinity, надхвърляне на числовия диапазон или практическия лимит на паметта на реализацията, или максимум под началния размер хвърля RangeError. Операции с данни върху отделен буфер и resize() върху фиксиран хвърлят TypeError. Грешките от преобразуване се разпространяват. Преоразмеряването и transfer са стандартизирани в ECMAScript 2024.

Етикетът за обхват ArrayBuffer.byteLength означава свойството на екземпляр, използвано като buffer.byteLength, а не статично свойство на конструктора ArrayBuffer. Този accessor само за четене връща текущия брой байтове: резултатът се променя след resize() на буфер с променлив размер и е 0 след отделяне. Няма setter; прилагането на getter към несъвместим receiver, включително SharedArrayBuffer, хвърля TypeError.

Примери

const buffer = new ArrayBuffer(4, { maxByteLength: 8 });
const bytes = new Uint8Array(buffer);
bytes.set([10, 20, 30, 40]);
console.log(buffer.byteLength, buffer.maxByteLength, buffer.resizable);

buffer.resize(6);
console.log(buffer.byteLength, Array.from(new Uint8Array(buffer)).join(","));

const copy = buffer.slice(1, 4);
console.log(copy.byteLength, Array.from(new Uint8Array(copy)).join(","));

try { new ArrayBuffer(4).resize(2); } catch (error) { console.log(error instanceof TypeError); }

Резултат

4 8 true
6 10,20,30,40,0,0
3 20,30,40
true

Източници