ArrayBuffer.prototype.transferToFixedLength()

Syntax

transferToFixedLength()
transferToFixedLength(newByteLength)

Parameter

newByteLength

Die byteLength des neuen ArrayBuffer. Standardmäßig entspricht sie der byteLength dieses ArrayBuffer.

• Wenn newByteLength kleiner ist als die byteLength dieses ArrayBuffer, werden die "überlaufenden" Bytes verworfen.
• Wenn newByteLength größer ist als die byteLength dieses ArrayBuffer, werden die zusätzlichen Bytes mit Nullen aufgefüllt.

Rückgabewert

Ein neues ArrayBuffer-Objekt. Sein Inhalt wird mit dem Inhalt dieses ArrayBuffer initialisiert, und zusätzliche Bytes, falls vorhanden, werden mit Nullen aufgefüllt. Der neue ArrayBuffer ist immer nicht resizierbar. Der ursprüngliche ArrayBuffer wird getrennt.

Ausnahmen

TypeError

Wird ausgelöst, wenn dieser ArrayBuffer bereits getrennt ist oder wenn er nur durch bestimmte Operationen getrennt werden kann. Derzeit sind nur bestimmte Web-APIs in der Lage, ArrayBuffer-Objekte mit bestimmten Trennmethoden zu erstellen, wie z.B. GPUBuffer.getMappedRange() und WebAssembly.Memory.buffer.

Beschreibung

Im Gegensatz zu transfer() erstellt transferToFixedLength() immer einen nicht-resizierbaren ArrayBuffer. Dies bedeutet, dass newByteLength größer sein kann als die maxByteLength, selbst wenn dieser ArrayBuffer resizierbar ist. Siehe Übertragen von ArrayBuffers für weitere Informationen.

Beispiele

Übertragen eines resizierbaren ArrayBuffers auf feste Länge

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
const view = new Uint8Array(buffer);
view[1] = 2;
view[7] = 4;

const buffer2 = buffer.transferToFixedLength();
console.log(buffer2.byteLength); // 8
console.log(buffer2.resizable); // false
const view2 = new Uint8Array(buffer2);
console.log(view2[1]); // 2
console.log(view2[7]); // 4

Beim Verwenden von transferToFixedLength kann newByteLength größer sein als die maxByteLength des ursprünglichen ArrayBuffer.

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
const view = new Uint8Array(buffer);
view[1] = 2;
view[7] = 4;

const buffer2 = buffer.transferToFixedLength(20);
console.log(buffer2.byteLength); // 20
console.log(buffer2.resizable); // false
const view2 = new Uint8Array(buffer2);
console.log(view2[1]); // 2
console.log(view2[7]); // 4

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill für ArrayBuffer.prototype.transferToFixedLength in core-js
• es-shims Polyfill für ArrayBuffer.prototype.transferToFixedLength
• ArrayBuffer
• ArrayBuffer.prototype.detached
• ArrayBuffer.prototype.transfer()