Das Int8Array getypte Array repräsentiert ein Array von zweierkomplement 8 Bit vorzeichenbehafteten, ganze Zahlen in der Plattform-Byte-Reihenfolge. Die Inhalte werden mit 0 initialisiert. Wie erwartet, kann man Element in einem Array mit Objektmethoden referenzieren oder man benutzt die normale Arrayindex-Syntax (das ist die Klammernotation).

Syntax

new Int8Array(); // new in ES2017
new Int8Array(length);
new Int8Array(typedArray);
new Int8Array(object);
new Int8Array(buffer [, byteOffset [, length]]);

Für mehr Informationen über die Konstruktorensyntax und die Parameter, siehe auf der Seite TypedArray.

Eigenschaften

Int8Array.BYTES_PER_ELEMENT
Gibt die Größe der Elemente zurück. 1 im Falle eines Int8rray.
Int8Array.length
Statische Längeneigenschaft welche den Wert 0 hat. Für die aktuelle Länge (Anzahl der Elemente) siehe Int8Array.prototype.length.
Int8Array.name
Gibt den Stringwert des Konstruktornamens zurück. In Fall eines Int8Array Typs: "Int8Array".
Int8Array.prototype
Prototyp für das TypedArray Objekt.

Methoden

Int8Array.from()
Erstelle ein neues Int8Array von einem Array-Ähnlichen oder Iterable Objekt. Siehe auch Array.from().
Int8Array.of()
Erstellt ein neues Int8Array mit einer variablen Anzahl an Argumenten. Sie auch Array.of().

Int8Array Prototyp

 

Alle Int8Array Objekte erben von %TypedArray%.prototype.

Eigenschaften

Int8Array.prototype.constructor
Gibt die Funktion, die einen Instanzprototyp erstellt zurück. Diese ist auf den Int8Array Konstruktor voreingestellt.
Int8Array.prototype.buffer Read only
Gibt die ArrayBuffer Referenz zurück, welche nach der Erstellung eines Int8Array fest ist und nicht mehr geändert werden kann.
Int8Array.prototype.byteLength Read only
Gibt die Länge (in Bytes) des Int8Array vom Anfang seines ArrayBuffer zurück. WIrd beim erstellen festgesetzt und kann nicht geändert werden.
Int8Array.prototype.byteOffset Read only
Gibt das Offset (in Bytes) des Int8Array vom Anfang seines ArrayBuffer zurück. WIrd beim erstellen festgesetzt und kann nicht geändert werden.
Int8Array.prototype.length Read only
Gibt Anzahl der Elemente des Int8Array zurück. WIrd beim erstellen festgesetzt und kann nicht geändert werden.

Methoden

Int8Array.prototype.copyWithin()
Kopiert eine Sequenz von Arrayelementen in das Array. Siehe auch Array.prototype.copyWithin().
Int8Array.prototype.entries()
Gibt ein neues Array Iterator Objekt zurück, welches die Schlüssel/Wertepaare für jeden Index im Array enthält. Siehe auch Array.prototype.entries().
Int8Array.prototype.every()
Teste, ob alle Elemente einem, als Funktion übergebenen, Test erfüllen. Siehe auch Array.prototype.every()")}}.
Int8Array.prototype.fill()
Füllt alle Elemente eines Arrays vom Startindex bis zum Endindex mit einem statischen Wert. Siehe auch Array.prototype.fill().
Int8Array.prototype.filter()
Erstellt ein neues Array mit allen Elementen des alten Arrays, für die eine übergebene Filterfunktion true zurückgibt. Siehe auch Array.prototype.filter().
Int8Array.prototype.find()
Gibt ein gefundenes Element des Arrays zurück, welches bei der übergebenen Testfunktion true zurückgibt oder undefined wenn es keins gibt. Siehe auch Array.prototype.find().
Int8Array.prototype.findIndex()
Gibt den Index eines gefundenen Elements des Arrays zurück, welches bei der übergebenen Testfunktion true zurückgibt oder -1 wenn es keins gibt. Siehe auch Array.prototype.findIndex().
Int8Array.prototype.forEach()
Ruft für jedes Element in einem Array eine Funktion auf. Siehe auch Array.prototype.forEach().
Int8Array.prototype.includes()
Überprüft, ob ein getyptes Array ein bestimmtes Element enthält und gibt gegebenfalls true oderfalse zurück. Siehe auch Array.prototype.includes().
Int8Array.prototype.indexOf()
Gibt den ersten Index eines Elementes zurück, welches gleiche eines spezifizierten Wertes ist oder -1 wenn es keins gibt. Siehe auch Array.prototype.indexOf().
Int8Array.prototype.join()
Führt alle Elemente eines Arrays zu einem String zusammen. Siehe auch Array.prototype.join().
Int8Array.prototype.keys()
Gibt ein neuen Array Iterator zurück, der alle Schlüssel für jeden Index im Array enthält. Siehe auch Array.prototype.keys().
Int8Array.prototype.lastIndexOf()
Gibt den letzen Index eines Elementes zurück, welches gleiche eines spezifizierten Wertes ist oder -1 wenn es keins gibt. Siehe auch Array.prototype.lastIndexOf().
Int8Array.prototype.map()
Erstellt ein neues Array mit den Resultaten spezifizierten Funktion, die für jedes Element aufgerufen wird. Siehe auch Array.prototype.map().
Int8Array.prototype.move() Nicht implementiert
Ehemalige nicht Standardisierte Version von Int8Array.prototype.copyWithin().
Int8Array.prototype.reduce()
Führt eine Funktion gegeben einen Akkumulator und jeden Wert des Array aus (von links nach rechts), um das Array auf einen Wert zu reduzieren. Siehe auch Array.prototype.reduce().
Int8Array.prototype.reduceRight()
Führt eine Funktion gegeben einen Akkumulator und jeden Wert des Array aus (von rechts nach links), um das Array auf einen Wert zu reduzieren. Siehe auch Array.prototype.reduce().
Int8Array.prototype.reverse()
Kehrt die Reihenfolge von jedem Element eines Arrays um — das Erste wird das Letzte und das Letzte wird das Erste. Siehe auch Array.prototype.reverse().
Int8Array.prototype.set()
Speichert mehrere Werte in einem getypten Array und ließt Eingabewerte aus einem spezifiziertem Array.
Int8Array.prototype.slice()
Extrahiert einen Bereich aus einem Array und gibt diesen in einem neuen Array zurück. Siehe auch Array.prototype.slice().
Int8Array.prototype.some()
Gibt true zurück, wenn nur ein Element in einem Array den als Funktion übergebenen Test erfüllt. Siehe auch Array.prototype.some()
Int8Array.prototype.sort()
Sortiert die Elemente eines Arrays in-Place und gibt das Array zurück. Siehe auch Array.prototype.sort().
Int8Array.prototype.subarray()
Gibt ein neues Int8Array vom gegebenen Start- und Endindex zurück.
Int8Array.prototype.values()
Gibt ein neues Array Iterator Objekt zurück, welches die Werte von jedem Index im Array enthält. Siehe auch Array.prototype.values().
Int8Array.prototype.toLocaleString()
Gibt einen Ortsabhängige Stringrepräsentation des Arrays und seiner Element zurück. Siehe auch Array.prototype.toLocaleString().
Int8Array.prototype.toString()
Gibt einen Stringrepräsentation des Arrays und seiner Element zurück. Siehe auch Array.prototype.toString().
Int8Array.prototype[@@iterator]()
Gibt ein neues Array Iterator Objekt zurück, welches die zugehörigen Werte für jeden Index im Array enthalten.

 

Beispiele

Verschiedene Wege, um ein Int8Array zu erstellen:

// From a length
var int8 = new Int8Array(2);
int8[0] = 42;
console.log(int8[0]); // 42
console.log(int8.length); // 2
console.log(int8.BYTES_PER_ELEMENT); // 1

// From an array
var arr = new Int8Array([21,31]);
console.log(arr[1]); // 31

// From another TypedArray
var x = new Int8Array([21, 31]);
var y = new Int8Array(x);
console.log(y[0]); // 21

// From an ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Int8Array(buffer, 1, 4);

// From an iterable
var iterable = function*(){ yield* [1,2,3]; }();
var int8 = new Int8Array(iterable);
// Int8Array[1, 2, 3]

Spezifikationen

Spezifikation Status Kommentar
Typed Array Specification Veraltet Ersetzt in ECMAScript 2015.
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'TypedArray constructors' in dieser Spezifikation.
Standard Initiale Definition in einem ECMA Standard. Spezifiziert, dass ein new benötigt wird.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'TypedArray constructors' in dieser Spezifikation.
Entwurf ECMAScript 2017 ändert den Int8Array Konstruktor, um die ToIndex Operation zu benutzen und erlaubt einen Konstruktor ohne Parameter.

Browserkompatibilität

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Grundlegende Unterstützung7 Ja41011.65.1
Int8Array() without new throws Ja Ja44 Nein Ja ?
Iterable in constructor ? ?52 ? ? ?
Constructor without arguments ? ?55 ? ? ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Grundlegende Unterstützung4 Ja Ja411.64.2 Ja
Int8Array() without new throws ? ? ?44 ? ? ?
Iterable in constructor ? ? ?52 ? ? ?
Constructor without arguments ? ? ?55 ? ? ?

Kompatibilitätshinweise

Mit Beginn von ECMAScript 2015, müssen Int8Array Konstruktoren mit einem new benutzt werden. Der Aufruf eines Int8Array Konstruktors als eine Funktion ohne new, Führt jetzt zu einem TypeError.

var dv = Int8Array([1, 2, 3]);
// TypeError: calling a builtin Int8Array constructor 
// without new is forbidden
var dv = new Int8Array([1, 2, 3]);

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Mitwirkende an dieser Seite: schlagi123
Zuletzt aktualisiert von: schlagi123,