WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen