HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
View in English Always switch to English
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das ArrayBuffer-Objekt wird verwendet, um einen generischen Puffer für rohe binäre Daten darzustellen.
ArrayBuffer
Es handelt sich um ein Byte-Array, das in anderen Sprachen oft als "Byte Array" bezeichnet wird. Sie können den Inhalt eines ArrayBuffer nicht direkt manipulieren; stattdessen erstellen Sie eines der typisierten Array-Objekte oder ein DataView Objekt, das den Puffer in einem spezifischen Format darstellt und verwenden dies, um den Inhalt des Puffers zu lesen und zu schreiben.
DataView
Der ArrayBuffer()-Konstruktor erstellt ein neues ArrayBuffer mit der angegebenen Länge in Bytes. Sie können auch einen Array-Puffer aus bestehenden Daten erhalten, zum Beispiel aus einem Base64-String oder aus einer lokalen Datei.
ArrayBuffer()
ArrayBuffer ist ein übertragbares Objekt.
ArrayBuffer-Objekte können durch die Angabe der Option maxByteLength beim Aufrufen des ArrayBuffer() Konstruktors vergrößerbar gemacht werden. Sie können abfragen, ob ein ArrayBuffer vergrößerbar ist und welche maximale Größe es hat, indem Sie auf seine resizable und maxByteLength Eigenschaften zugreifen. Sie können einem vergrößerbaren ArrayBuffer mit einem resize() Aufruf eine neue Größe zuweisen. Neue Bytes werden auf 0 initialisiert.
maxByteLength
resizable
resize()
Diese Funktionen machen das Ändern der Größe von ArrayBuffers effizienter — andernfalls müssen Sie eine Kopie des Puffers mit neuer Größe erstellen. Dies gibt JavaScript in dieser Hinsicht Parität mit WebAssembly (Wasm lineare Speicher können mit WebAssembly.Memory.prototype.grow() vergrößert werden).
WebAssembly.Memory.prototype.grow()
ArrayBuffer-Objekte können zwischen verschiedenen Ausführungskontexten, wie Web Workers oder Service Workers, unter Verwendung des strukturierten Klonalalgorithmus übertragen werden. Dies geschieht, indem das ArrayBuffer als übertragbares Objekt in einem Aufruf von Worker.postMessage() oder ServiceWorker.postMessage() übergeben wird. In reinem JavaScript können Sie auch die Speicherübertragung von einem ArrayBuffer zu einem anderen mit seinen transfer() oder transferToFixedLength() Methoden durchführen.
Worker.postMessage()
ServiceWorker.postMessage()
transfer()
transferToFixedLength()
Wenn ein ArrayBuffer übertragen wird, wird seine ursprüngliche Kopie getrennt — das bedeutet, es ist nicht mehr verwendbar. Zu jedem Zeitpunkt gibt es nur eine Kopie des ArrayBuffer, die tatsächlich Zugriff auf den zugrunde liegenden Speicher hat. Getrennte Puffer haben die folgenden Verhaltensweisen:
byteLength
slice()
TypeError
Sie können überprüfen, ob ein ArrayBuffer getrennt ist, indem Sie seine detached Eigenschaft prüfen.
detached
Erstellt ein neues ArrayBuffer-Objekt.
ArrayBuffer[Symbol.species]
Die Konstruktionsfunktion, die verwendet wird, um abgeleitete Objekte zu erstellen.
ArrayBuffer.isView()
Gibt true zurück, wenn arg eine der ArrayBuffer-Ansichten ist, wie typisierte Array-Objekte oder ein DataView. Gibt andernfalls false zurück.
true
arg
false
Diese Eigenschaften sind auf ArrayBuffer.prototype definiert und werden von allen ArrayBuffer-Instanzen geteilt.
ArrayBuffer.prototype
ArrayBuffer.prototype.byteLength
Die Größe des ArrayBuffer in Bytes. Dies wird beim Erstellen des Arrays festgelegt und kann nur geändert werden, wenn der ArrayBuffer vergrößerbar ist, durch die Verwendung der ArrayBuffer.prototype.resize() Methode.
ArrayBuffer.prototype.resize()
ArrayBuffer.prototype.constructor
Die Konstruktionsfunktion, die das Instanzobjekt erstellt hat. Für ArrayBuffer-Instanzen ist der Initialwert der ArrayBuffer Konstruktor.
ArrayBuffer.prototype.detached
Schreibgeschützt. Gibt true zurück, wenn das ArrayBuffer getrennt (übertragen) wurde, oder false, wenn nicht.
ArrayBuffer.prototype.maxByteLength
Die schreibgeschützte maximale Länge, in Bytes, in die das ArrayBuffer vergrößert werden kann. Dies wird beim Erstellen des Arrays festgelegt und kann nicht geändert werden.
ArrayBuffer.prototype.resizable
Schreibgeschützt. Gibt true zurück, wenn das ArrayBuffer vergrößerbar ist, oder false, wenn nicht.
ArrayBuffer.prototype[Symbol.toStringTag]
Der Ausgangswert der [Symbol.toStringTag] Eigenschaft ist der String "ArrayBuffer". Diese Eigenschaft wird in Object.prototype.toString() verwendet.
[Symbol.toStringTag]
"ArrayBuffer"
Object.prototype.toString()
Ändert die Größe des ArrayBuffer auf die angegebene Größe in Bytes.
ArrayBuffer.prototype.slice()
Gibt ein neues ArrayBuffer zurück, dessen Inhalt eine Kopie der Bytes dieses ArrayBuffer von begin (einschließlich) bis end (ausschließlich) ist. Wenn entweder begin oder end negativ ist, bezieht es sich auf einen Index vom Ende des Arrays, im Gegensatz zu vom Anfang.
begin
end
ArrayBuffer.prototype.transfer()
Erstellt ein neues ArrayBuffer mit demselben Byte-Inhalt wie dieser Puffer und trennt dann diesen Puffer.
ArrayBuffer.prototype.transferToFixedLength()
Erstellt ein neues nicht-vergrößerbares ArrayBuffer mit demselben Byte-Inhalt wie dieser Puffer und trennt dann diesen Puffer.
In diesem Beispiel erstellen wir einen 8-Byte-Puffer mit einer Int32Array-Ansicht, die auf den Puffer verweist:
Int32Array
const buffer = new ArrayBuffer(8); const view = new Int32Array(buffer);
JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.
core-js
SharedArrayBuffer