Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Int8Array: 8-bitowe liczby całkowite ze znakiem

Int8Array przechowuje liczby jako 8-bitowe całkowite ze znakiem od -128 do 127, po jednym bajcie na element.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])

new Int8Array(source?, byteOffset?, length?) tworzy numeric typed array z długości, iterable/array-like, innego numeric typed array albo ArrayBuffer/SharedArrayBuffer. Wariant buforowy współdzieli bajty bez kopiowania. Każdy całkowity byteOffset jest wyrównany dla elementu jednobajtowego, a BYTES_PER_ELEMENT wynosi 1.

Zapis stosuje ToNumber, obcina ułamek, redukuje modulo 2^8 i interpretuje wynik ze znakiem. Dlatego 128 staje się -128, 255 staje się -1, a NaN i nieskończoności stają się 0. BigInt przy zapisie lub BigInt typed array jako źródło powoduje TypeError. Dla pojedynczego bajtu kolejność bajtów nie ma znaczenia.

Długość przechodzi ToIndex: ułamki są obcinane, NaN/undefined dają 0, a -0.5 daje 0. Ujemny wynik po ToIntegerOrInfinity, nieskończoność lub zakres poza buforem powoduje RangeError; odłączony bufor powoduje TypeError. Typ jest standardowy od ECMAScript 2015.

Przykłady

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); }

Wynik

127,-128,-1,127,3,0,0
1 2 0
1 2 -5,120
true

Źródła