The resize()
method of ArrayBuffer
instances resizes the ArrayBuffer
to the specified size, in bytes.
The resize()
method of ArrayBuffer
instances resizes the ArrayBuffer
to the specified size, in bytes.
resize(newLength)
newLength
The new length, in bytes, to resize the ArrayBuffer
to.
None (undefined
).
TypeError
Thrown if the ArrayBuffer
is detached or is not resizable.
RangeError
Thrown if newLength
is larger than the maxByteLength
of the ArrayBuffer
.
The resize()
method resizes an ArrayBuffer
to the size specified by the newLength
parameter, provided that the ArrayBuffer
is resizable and the new size is less than or equal to the maxByteLength
of the ArrayBuffer
. New bytes are initialized to 0.
Note that you can use resize()
to shrink as well as grow an ArrayBuffer
— it is permissible for newLength
to be smaller than the ArrayBuffer
's current byteLength
.
In this example, we create a 8-byte buffer that is resizable to a max length of 16 bytes, then check its resizable
property, resizing it if resizable
returns true
:
const buffer = new ArrayBuffer(8, { maxByteLength: 16 }); if (buffer.resizable) { console.log("Buffer is resizable!"); buffer.resize(12); }
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
resize |
111 | 111 | No | 97 | 16.4 | 111 | No | 75 | 16.4 | 22.0 | 111 | 1.33 | 20.0.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/resize