limu
is short for love immutable, born for efficient creation and operation of immutable object, based on shallow copy on read and mark modified on write mechanism.
It is fast, It is nearly more than 2 or 20 times faster than immer
in different situations. Click this online perf demo to review the amazing result.
No freeze by default, limu is 10 times or more faster than Immer in most scenarios
- Debugging friendly, view draft directly anytime without
current
. - Smaller package, only 4.3kb gzip.
- No freeze by default, faster than
immer
in different situations. - Natural Support for map and Set.
Pay attention, limu can only run on JavaScript runtime that supports proxy
No freeze by default, limu is 10 times or more faster than Immer in most scenarios after 3.7 version, limu is now the fastest immutable js lib of all ( faster than immer and mutative ).
test 1 (inspired by this immer case )
The performance testing process is as follows
git clone https://github.com/tnfe/limu
cd limu
npm i
cd benchmark
npm i
node opBigData.js // trigger test execution, the console echoes the result
# or
node caseOnlyRead.js
npm run s1
npm run s2
npm run s3
npm run s4
You are very welcome to submit your test to the benchmark directory or test directory
install
npm i limu
apis
import { produce, createDraft, finishDraft } from 'limu';
const baseState = {
a: 1,
b: [1, 2, 3],
c: {
c1: { n: 1 },
c2: { m: 2 },
},
};
const nextState = produce(baseState, (draft) => {
draft.a = 2;
draft.b['2'] = 100;
});
console.log(nextState === baseState); // false
console.log(nextState.a === baseState.a); // false
console.log(nextState.b === baseState.b); // false
console.log(nextState.c === baseState.c); // true
Currying call
const producer = produce((draft) => {
draft.a = 2;
draft.b['2'] = 100;
});
const nextState = producer(baseState);
const draft = createDraft(baseState);
draft.a = 2;
draft.b = [];
const nextState = finishDraft(draft);
console.log(nextState === baseState); // false
console.log(nextState.a === baseState.a); // false
console.log(nextState.b === baseState.b); // false
console.log(nextState.c === baseState.c); // true
As limu is an immutable js library based on shallow copy on read and mark modified on write. Based on this mechanism, so it is more friendly to debugging. You can copy the following code to the console experience
there are 2 ways to quickly experience limu and compare limu with immer.
-
1, open limu doc site and right-click to open the console.
-
2, visit unpkg, right-click to open the console, and then paste the following code to load js
function loadJs(url) {
const dom = document.createElement('script');
dom.src = url;
document.body.appendChild(dom);
}
loadJs('https://unpkg.com/limu@3.5.5/dist/limu.min.js'); // load limu umd bundle
loadJs('https://unpkg.com/immer@9.0.21/dist/immer.umd.production.min.js'); // load immer umd bundle
Then you can paste below codes to run
- case 1
function oneCase(produce) {
const demo = { info: Array.from(Array(10000).keys()) };
produce(demo, (draft) => {
draft.info[2000] = 0;
});
}
function runBenchmark(produce, label) {
const start = Date.now();
const limit = 100;
for (let i = 0; i < limit; i++) {
oneCase(produce);
}
console.log(`${label} avg spend ${(Date.now() - start) / limit} ms`);
}
function run() {
immer.setAutoFreeze(false);
runBenchmark(immer.produce, 'immer,');
runBenchmark(limu.produce, 'limu,');
}
- case 2
lib = window.limu; // or lib = window.immer
const base = {
a: 1,
b: { b1: 1, b2: 2, b3: { b31: 1 } },
c: [1, 2, 3],
d: { d1: 1000 },
};
const draft = lib.createDraft(base);
draft.a = 200;
draft.b.b1 = 100;
console.log(draft);
draft.c.push(4);
const final = lib.finishDraft(draft);
console.log(base === final); // false
console.log(base.a === final.a); // false
console.log(base.b === final.b); // false
console.log(base.b.b3 === final.b.b3); // true
console.log(base.c === final.c); // false
console.log(base.d === final.d); //true
Higher observability will greatly improve the development and debugging experience, as shown in the figure below, after unfolding the limu
draft, you can observe all data nodes of the draft in real time
![image](https://private-user-images.githubusercontent.com/7334950/253748038-2f90b07d-e2e3-4104-916c-8c0add935b41.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU1NDUwNTgsIm5iZiI6MTcyNTU0NDc1OCwicGF0aCI6Ii83MzM0OTUwLzI1Mzc0ODAzOC0yZjkwYjA3ZC1lMmUzLTQxMDQtOTE2Yy04YzBhZGQ5MzViNDEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDVUMTM1OTE4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ODU1ZjNjYmNjNDk0MWEyZmU1ZjRlNGU1MDE2ZjMwMjNkNTU4NTI5NGY2NDRkZDMwOWI3OTg2NWJiMmM0YmUyNyZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.4lFTbpGatsvz3X3pWrBRAcjjZbtczL8FzA2B5Lzn3Fg)
And the immer or mutative expansion is like this
Copyright (c) Tencent Corporation. All rights reserved.
Limu is released under the MIT License(https://opensource.org/licenses/MIT)