ArrayBuffer.prototype.transferToFixedLength()

newByteLength

Die byteLength des neuen ArrayBuffer. Standardmäßig ist dies die byteLength dieses ArrayBuffer.

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

Ein neues ArrayBuffer-Objekt. Sein Inhalt wird auf den Inhalt dieses ArrayBuffer initialisiert, und zusätzliche Bytes, falls vorhanden, werden mit Nullen gefüllt. Der neue ArrayBuffer ist immer nicht veränderbar. Der originale ArrayBuffer wird getrennt.

TypeError

Wird ausgelöst, wenn dieser ArrayBuffer bereits getrennt ist.

Im Gegensatz zu transfer() erzeugt transferToFixedLength() immer einen nicht-veränderbaren ArrayBuffer. Das bedeutet, dass newByteLength größer sein kann als maxByteLength, selbst wenn dieser ArrayBuffer veränderbar ist. Weitere Informationen finden Sie unter Übertragen von ArrayBuffers.

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

Mit transferToFixedLength kann newByteLength größer sein als 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

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