CKTIS / JavaScript
Int8Array: 8-битови цели числа със знак
Int8Array съхранява числата като 8-битови цели числа със знак от -128 до 127 с един байт на елемент.
Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2
Синтаксис
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) създава числов typed array от дължина, iterable/array-like, друг числов typed array или ArrayBuffer/SharedArrayBuffer. Буферната форма споделя байтове без копиране. Всеки цял byteOffset е подравнен за еднобайтов елемент, а BYTES_PER_ELEMENT е 1.
Записът прилага ToNumber, отрязва дробта, редуцира по модул 2^8 и тълкува резултата със знак. Така 128 става -128, 255 става -1, а NaN и безкрайностите стават 0. Запис на BigInt или BigInt typed array като източник хвърля TypeError. Редът на байтовете няма значение за един байт.
Дължината минава през ToIndex: дробите се отрязват, NaN/undefined стават 0 и -0.5 дава 0. Отрицателен резултат след ToIntegerOrInfinity, безкрайност или диапазон извън буфера хвърля RangeError; отделен буфер хвърля TypeError. Типът е стандартен от ECMAScript 2015.
Примери
const values = new Int8Array([127, 128, 255, -129, 3.9, NaN, Infinity]);
console.log(Array.from(values).join(","));
console.log(Int8Array.BYTES_PER_ELEMENT, new Int8Array(2.9).length, new Int8Array(-0.5).length);
const buffer = new ArrayBuffer(4);
const view = new Int8Array(buffer, 1, 2);
view.set([-5, 120]);
console.log(view.byteOffset, view.byteLength, Array.from(view).join(","));
try { view[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }Резултат
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true