remove-array-items
remove items from a javascript array without generating memory garbage.
Despite there being a number of "remove array items" in npm, I couldn't find satisfying all criteria:
- doesn't generate garbage
- performs similar or better to the native
array.splice
- has tests
- es3+ compatible
- works in both commonjs (node) and es modules (import)
so here we are.
originally inspired by https://gamealchemist.wordpress.com/2013/05/01/lets-get-those-javascript-arrays-to-work-fast/
(which is a gold mine for performant, non-garbage generating array operations by the way.)
api
removeItems(arr, startIdx, removeCount)
startIdx
is an integer >= 0
, and removeCount
is an integer > 0
.
example usage
const arr = [ 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
removeItems(arr, 3, 4) // after running, arr === [ 1, 2, 3, 8, 9 ]