CKTIS / JavaScript
Int8Array: vorzeichenbehaftete 8-Bit-Ganzzahlen
Int8Array speichert Zahlen als vorzeichenbehaftete 8-Bit-Ganzzahlen von -128 bis 127 mit einem Byte je Element.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) erzeugt ein numerisches Typed Array aus Länge, Iterable/array-ähnlichem Wert, anderem numerischem Typed Array oder ArrayBuffer/SharedArrayBuffer. Die Pufferform teilt Bytes ohne Kopie. Jeder ganzzahlige byteOffset ist für ein Ein-Byte-Element ausgerichtet, BYTES_PER_ELEMENT ist 1.
Beim Schreiben wird ToNumber angewendet, der Bruch abgeschnitten, modulo 2^8 reduziert und das Ergebnis mit Vorzeichen interpretiert. Daher wird 128 zu -128, 255 zu -1, und NaN sowie Unendlichkeiten werden 0. BigInt beim Schreiben oder ein BigInt Typed Array als Quelle löst TypeError aus. Für ein einzelnes Byte ist die Byteordnung ohne Bedeutung.
Die Länge durchläuft ToIndex: Brüche werden abgeschnitten, NaN/undefined werden 0 und -0.5 ergibt 0. Negatives Ergebnis nach ToIntegerOrInfinity, Unendlichkeit oder Bereich außerhalb des Puffers ergibt RangeError; ein abgelöster Puffer TypeError. Der Typ ist seit ECMAScript 2015 standardisiert.
Beispiele
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); }Ergebnis
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true