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.

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.

Instanzen

Alle ArrayBuffer Instanzen erben von ArrayBuffer.prototype.

Eigenschaften

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.

Methoden

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().

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

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

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
ArrayBufferChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 4IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 11.6Safari Vollständige Unterstützung 5.1WebView Android Vollständige Unterstützung 4Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung 12Safari iOS Vollständige Unterstützung 4.2Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja
byteLengthChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 4IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 11.6Safari Vollständige Unterstützung 5.1WebView Android Vollständige Unterstützung 4Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung 12Safari iOS Vollständige Unterstützung 4.2Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja
isViewChrome Vollständige Unterstützung 32Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 29IE Vollständige Unterstützung 11Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung JaWebView Android Vollständige Unterstützung ≤37Chrome Android Vollständige Unterstützung 32Firefox Android Vollständige Unterstützung 29Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung 2.0nodejs Vollständige Unterstützung Ja
ArrayBuffer() without new throwsChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung 14Firefox Vollständige Unterstützung 44IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung 5.1WebView Android Vollständige Unterstützung ≤37Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 44Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung 5Samsung Internet Android Vollständige Unterstützung 1.0nodejs Vollständige Unterstützung 0.12
prototypeChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 4IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 11.6Safari Vollständige Unterstützung 5.1WebView Android Vollständige Unterstützung 4Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung 12Safari iOS Vollständige Unterstützung 4.2Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja
sliceChrome Vollständige Unterstützung 17Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 12
Hinweise
Vollständige Unterstützung 12
Hinweise
Hinweise The non-standard ArrayBuffer.slice() method has been removed in Firefox 53 (but the standardized version ArrayBuffer.prototype.slice() is kept.
IE Vollständige Unterstützung 11Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung 6WebView Android Vollständige Unterstützung ≤37Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 14
Hinweise
Vollständige Unterstützung 14
Hinweise
Hinweise The non-standard ArrayBuffer.slice() method has been removed in Firefox 53 (but the standardized version ArrayBuffer.prototype.slice() is kept.
Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung 6Samsung Internet Android Vollständige Unterstützung 1.0nodejs Vollständige Unterstützung Ja
transfer
ExperimentellNicht standardisiert
Chrome Keine Unterstützung NeinEdge Keine Unterstützung NeinFirefox Keine Unterstützung NeinIE Keine Unterstützung NeinOpera Keine Unterstützung NeinSafari Keine Unterstützung NeinWebView Android Keine Unterstützung NeinChrome Android Keine Unterstützung NeinFirefox Android Keine Unterstützung NeinOpera Android Keine Unterstützung NeinSafari iOS Keine Unterstützung NeinSamsung Internet Android Keine Unterstützung Neinnodejs Keine Unterstützung Nein
@@speciesChrome Vollständige Unterstützung 51Edge Vollständige Unterstützung 13Firefox Vollständige Unterstützung 48IE Keine Unterstützung NeinOpera Vollständige Unterstützung 38Safari ? WebView Android Vollständige Unterstützung 51Chrome Android Vollständige Unterstützung 51Firefox Android Vollständige Unterstützung 48Opera Android Vollständige Unterstützung 41Safari iOS ? Samsung Internet Android Vollständige Unterstützung 5.0nodejs Vollständige Unterstützung 6.5.0
Vollständige Unterstützung 6.5.0
Vollständige Unterstützung 6.0.0
Deaktiviert
Deaktiviert From version 6.0.0: this feature is behind the --harmony runtime flag.

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung
Kompatibilität unbekannt  
Kompatibilität unbekannt
Experimentell. Das Verhalten kann sich zukünftig ändern.
Experimentell. Das Verhalten kann sich zukünftig ändern.
Nicht standardisiert. Erwarte schlechte browserübergreifende Unterstützung.
Nicht standardisiert. Erwarte schlechte browserübergreifende Unterstützung.
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.
Benutzer muss dieses Feature explizit aktivieren.
Benutzer muss dieses Feature explizit aktivieren.

Kompatibilitätshinweis

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

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. ArrayBuffer
  3. Eigenschaften
    1. ArrayBuffer.prototype
    2. ArrayBuffer.prototype.byteLength
    3. get ArrayBuffer[@@species]
  4. Methoden
    1. ArrayBuffer.isView()
    2. ArrayBuffer.prototype.slice()
    3. ArrayBuffer.transfer()
  5. Vererbung:
  6. Function
  7. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]