Drop-in replacement for Redux's combineReducers, optimized for speed and bundle size.
Applying a technique of partial evaluation by pre-compiling a reducer updater function, it achieves upwards of 82x improved performance for an assumed typical real-world scenario (unchanging state for a medium-size object). See Benchmarks for specific performance metrics.
Turbo Combine Reducers has no dependencies, and weighs in at 260 bytes minified and gzipped.
Security Note: The partial evaluation technique involves the use of the Function constructor to work, which is a discouraged API due its security implications and incompatibility with common Content Security Policy configurations. While steps are taken to ensure that this risk is mitigated and it is safe to use, you are encouraged to perform your own security and risk assessments before using this library.
Using npm as a package manager:
npm install turbo-combine-reducers
Otherwise, download a pre-built copy from unpkg:
https://unpkg.com/turbo-combine-reducers/dist/turbo-combine-reducers.min.js
As an imported package, the default export is the combineReducers function. If using the browser-ready distributable from unpkg, the same function is available at the window.turboCombineReducers global.
import combineReducers from 'turbo-combine-reducers';
// Or:
// var combineReducers = window.turboCombineReducers;
const reducer = combineReducers( {
count( state = 0, action ) {
// ...
},
} );As it is intended to serve as a drop-in replacement, refer to the documentation of Redux's combineReducers for usage instructions.
The following benchmarks are performed in Node 10.12.0 on a MacBook Pro (Late 2016), 2.9 GHz Intel Core i7.
turbo-combine-reducers - unchanging (4 properties) x 120,638,598 ops/sec ±0.37% (87 runs sampled)
turbo-combine-reducers - unchanging (20 properties) x 23,740,676 ops/sec ±1.20% (90 runs sampled)
turbo-combine-reducers - changing (4 properties) x 40,028,499 ops/sec ±0.82% (90 runs sampled)
turbo-combine-reducers - changing (20 properties) x 23,338,161 ops/sec ±0.86% (88 runs sampled)
redux - unchanging (4 properties) x 1,480,178 ops/sec ±0.42% (93 runs sampled)
redux - unchanging (20 properties) x 594,068 ops/sec ±0.39% (90 runs sampled)
redux - changing (4 properties) x 1,390,904 ops/sec ±0.28% (92 runs sampled)
redux - changing (20 properties) x 589,844 ops/sec ±0.47% (92 runs sampled)
Copyright 2019 Andrew Duthie
Released under the MIT License.