Skip to main content

Arrays

Small, non-mutating helpers for everyday array work — chunking, deduping, compacting, shuffling. Every function returns a new array and leaves its input untouched, including shuffle, which copies before running its Fisher-Yates pass. unique dedupes through a Set, so equality is SameValueZero — primitives compare by value, objects by reference, and two structurally identical objects both survive.

first, last, flatten and groupBy were removed in 4.0 in favour of at(0), at(-1), flat() and Object.groupBy.

Example​

import { chunk, compact, unique } from '@rtorcato/js-common/arrays'

// Send 500 ids to an API that accepts 50 at a time.
for (const batch of chunk(unique(ids), 50)) {
  await api.post('/bulk', { ids: batch })
}

compact([1, 0, 2, null, 3]) // [1, 2, 3] — every falsy value dropped, including 0

Import​

import { chunk, compact, shuffle } from '@rtorcato/js-common/arrays'

Exports​

NameSummary
chunkChunks an array into smaller arrays of a specified size.
compactRemoves all falsy values from an array.
shuffleShuffles an array using the Fisher-Yates algorithm.
uniqueRemoves duplicate values from an array while preserving order.

See also​

  • objects — pick, omit, deepMerge, deepClone
  • maps — merge, invert and convert Maps
  • random — random ints, floats, strings and array picks