ArrayBuffer

Das ArrayBuffer Objekt repräsentiert einen generischen Buffer mit fester Länge. Der Inhalt eines ArrayBuffers kann nicht direkt bearbeitet werden; stattdessen wird eines der typisierten Array-Objekte oder ein DataView Objekt verwendet, welches den Buffer in einem bestimmten Format repräsentiert und von welchem aus sein Inhalt bearbeitet werden kann.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

new ArrayBuffer(length)

length

Die Größe, in Bytes, des zu erstellenden ArrayBuffer.

Ein neues ArrayBuffer Objekt der angegebenen Länge. Der Inhalt wird auf 0 initialisiert.

Ein RangeError wird erhoben wenn die Länge größer als Number.MAX_SAFE_INTEGER (>= 2 ** 53) oder negativ ist.

Der ArrayBuffer Konstruktor erstellt einen neuen ArrayBuffer der angegebenen Länge in Bytes.

• Von einem Base64-String
• Von einer lokalen Datei

ArrayBuffer.length

Der Wert des ArrayBuffer Konstruktors für die Länge.

get ArrayBuffer[@@species]

Die Konstruktor-Funktion um abgeleitete Objekte zu erstellen.

ArrayBuffer.prototype

Erlaubt das Hinzufügen von Eigenschaften zu allen ArrayBuffer Objekten.

ArrayBuffer.isView(arg)

Gibt true zurück wenn arg eines der Views des ArrayBuffers ist, wie zum Beispiel die typisierten Array-Objekte oder ein DataView. Ansonsten wird false zurückgegeben.

ArrayBuffer.transfer(oldBuffer [, newByteLength])

Gibt einen neuen ArrayBuffer zurück, dessen Inhalt von den Daten des oldBuffers genommen wird und dann entweder abgeschnitten oder mit Null auf newByteLength erweitert wird.

Alle ArrayBuffer Instanzen erben von ArrayBuffer.prototype.

ArrayBuffer.prototype.constructor

Spezifiziert die Funktion, die das Prototypeobjekt erstellt. Der Initialwert ist der eingebaute Standard-ArrayBuffer-Konstruktor.

ArrayBuffer.prototype.byteLength Schreibgeschützt

Die größe, in Bytes, des Arrays. Dieser wird bei der Erstellung des Arrays ermittelt und kan nicht geändert werden.

ArrayBuffer.prototype.slice()

Gibt einen neuen ArrayBuffer zurück, welcher eine Kopie der Bytes des eigentlichen ArrayBuffer einthält. Die Kopie geht von begin (inklusiv) bis end (exclusiv). Wenn einer der Werte negativ ist, referenziert er auf den Index vom Ende des Arrays an und nicht vom Beginn des Arrays.

ArrayBuffer.slice()

Hat die selbe Funktion wie ArrayBuffer.prototype.slice().

In diesem Beispiel erstellen wir einen 8-byte Puffer mit einem Int32Array View, um auf den Puffer zu verweisen:

var buffer = new ArrayBuffer(8);
var view   = new Int32Array(buffer);

Seit ECMAScript 2015 müssen ArrayBuffer Konstruktor mit einem new Operator konstruiert werden. Einen ArrayBuffer Konstruktor als Funktion aufzurufen ohne new ab sofort einen TypeError erheben.

var dv = ArrayBuffer(10);
// TypeError: Einen eingebauten ArrayBuffer-Konstruktor
// ohne new aufzurufen ist nicht erlaubt.

var dv = new ArrayBuffer(10);

• JavaScript typed arrays
• SharedArrayBuffer