ArrayBuffer.prototype.transferToFixedLength()

newByteLength

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

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

Ein neues ArrayBuffer-Objekt. Der 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-resizierbar. Der ursprüngliche ArrayBuffer wird abgetrennt.

TypeError

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

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

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
• ArrayBuffer
• ArrayBuffer.prototype.detached
• ArrayBuffer.prototype.transfer()