Ultra-lightweight chunker for everything — arrays, strings, sets, maps, async iterables and more.
npm install chonkify- Works with everything: Array, String, Buffer, Set, Map, Array-like, TypedArray
- Supports AsyncIterable (
for await) - UTF-16 code points and Unicode graphemes support 👨👩👧👦🏳️🌈
- Minimal size: core just 1103 bytes, entire package ~7 kB
- Zero dependencies
- ESM-first, TypeScript-ready
import { chonk, chonkAsync, chonkGraphemes } from 'chonkify';
// Basic examples
chonk([1, 2, 3, 4], 2); // [[1, 2], [3, 4]]
chonk('abcdef', 2); // ['ab', 'cd', 'ef']
// Standard chonk uses UTF-16 code points (like standard JS)
chonk('👍👌✌️😀', 2); // May split emojis incorrectly
// Use chonkGraphemes for proper emoji support
chonkGraphemes('👍👌✌️😀', 2); // ['👍👌', '✌️😀']
chonkGraphemes('👨👩👧👦🏳️🌈', 1); // ['👨👩👧👦', '🏳️🌈']
// Async usage:
for await (const group of chonkAsync(fetchLines(), 100)) {
console.log(group);
}Splits an iterable into groups of the specified size. For strings, splits by UTF-16 code points (standard JavaScript behavior).
chonk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]Same as chonk() but for strings, splits by Unicode grapheme clusters instead of code points. This correctly handles emoji and complex symbols like family emojis and flags.
// Standard chonk may split complex emojis incorrectly
chonk('👨👩👧👦', 1); // May return multiple chunks
// chonkGraphemes correctly handles complex emoji
chonkGraphemes('👨👩👧👦', 1); // ['👨👩👧👦']Asynchronously splits an iterable into groups of the specified size.
// Process large datasets in batches
for await (const batch of chonkAsync(dataStream, 100)) {
await processBatch(batch);
}Yes, chonkify works both in browsers and Node.js environments.
Yes, chonkify can handle nested data structures as it groups elements without transforming them.
MIT