MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

ArrayBuffer

Diese Übersetzung ist unvollständig. Bitte helfen Sie, diesen Artikel aus dem Englischen zu übersetzen.

Das ArrayBuffer-Object repräsentiert einen, generischen binär-buffer von fester Länge. Der inhalt eines ArrayBuffers kann nicht direkt bearbeited 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.

Syntax

new ArrayBuffer(length)

Parameter

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

Rückgabewert

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

Ausnahmen

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

Beschreibung

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

Einen ArrayBuffer von existierenden Daten erstellen

Eigenschaften

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.

Methoden

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.

ArrayBuffer Instanzen

Alle ArrayBuffer Instanzen erben von ArrayBuffer.prototype.

Eigenschaften

ArrayBuffer.prototype.constructor
Specifies the function that creates an object's prototype. The initial value is the standard built-in ArrayBuffer constructor.
ArrayBuffer.prototype.byteLength Read only
The size, in bytes, of the array. This is established when the array is constructed and cannot be changed. Read only.

Methoden

ArrayBuffer.prototype.slice()
Returns a new ArrayBuffer whose contents are a copy of this ArrayBuffer's bytes from begin, inclusive, up to end, exclusive. If either begin or end is negative, it refers to an index from the end of the array, as opposed to from the beginning.

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

Beispiel

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

Spezifikationen

Specification Status Comment
Typed Array Specification Veraltet Ersetzt durch ECMAScript 6.
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'ArrayBuffer' in dieser Spezifikation.
Standard Ursprüngliche Definition im ECMA Standard. Spezifiziert dass new benötogt wird.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'ArrayBuffer' in dieser Spezifikation.
Entwurf  

Browser-Kompatibilität

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 7.0 (Ja) 4.0 (2) 10 11.6 5.1
ArrayBuffer() without new throws ? ? 44 (44) ? ? ?
ArrayBuffer.slice() Nicht unterstützt (Ja) (Ja)
Nicht unterstützt 53 (53)
Nicht unterstützt Nicht unterstützt ?
Feature Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 4.0 (Ja) (Ja) 4.0 (2) 10 11.6 4.2
ArrayBuffer() without new throws ? ? ? 44.0 (44) ? ? ?
ArrayBuffer.slice() Nicht unterstützt Nicht unterstützt (Ja) (Ja)
Nicht unterstützt 53.0 (53)
Nicht unterstützt Nicht unterstützt ?

Anmerkungen zur Kompatibilität

Seit ECMAScript 2015 müssen ArrayBuffer Konstruktore 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);

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

 Mitwirkende an dieser Seite: Steinweber, ionree
 Zuletzt aktualisiert von: Steinweber,