GrowableUint8Array is simple wrapper around Uint8Array that manages resizing the buffer when appending new data.
Adds a new method extend which can be used to append data to an array. GrowableUint8Array will manage the
underlying buffer, automatically allocating a larger Uint8Array when necessary using a simple exponential
growth algorithm.
getElement(n) and setElement(n, value) can be used to get and set the value, respectively, at a specific index. When setting, index values less than zero or greater than the length of the array are silently ignored.
All TypedArray prototype methods are delegated to the underlying Uint8Array. If the prototype method returns an instance of
Uint8Array it will be wrapped in a GrowableUint8Array.
Use growableUint8Array.unwrap() to return a Uint8Array view of the underlying data, with proper bounds. By default this will not copy the data, for performance reasons. Pass true as the first argument to unwrap to return a copy of the data.
import GrowableUint8Array from '@fictivekin/growable-uint8-array';
const arr = new GrowableUint8Array(new Uint8Array([1, 2, 3]));
console.log(arr.length); // 3
arr.extend([4, 5, 6]); // GrowableUint8Array [ 1, 2, 3, 4, 5, 6 ]
console.log(arr.length); // 6
arr.map((x) => x * 2); // GrowableUint8Array [ 2, 4, 6, 8, 10, 12 ]
console.log(arr); // GrowableUint8Array [ 1, 2, 3, 4, 5, 6 ]
arr.unwrap() // Uint8Array [ 1, 2, 3, 4, 5, 6 ]If your environment supports ES6 proxies, you can use arr.accessProxy() to get a proxy object which allows for Array-like attribute access.
import GrowableUint8Array from '@fictivekin/growable-uint8-array';
const proxy = new GrowableUint8Array(new Uint8Array([1, 2, 42])).accessProxy();
proxy[2]; // 42
proxy[0] = 7; // 7
proxy.extend([3, 2, 1]);
proxy.unwrap() // Uint8Array [ 7, 2, 42, 3, 2, 1 ]npm install @fictivekin/growable-uint8-array
Clone repo, then install dev dependencies:
npm install --only=dev
npm run test
npm run build