use-custom-compare-effect

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

use-custom-compare-effect

★ 48 Open GitHub ↗

useEffect hook which takes a comparison function instead of compare using reference equality

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# use-custom-compare-effect

useEffect hook which takes a comparison function instead of compare using reference equality (inspired by [use-deep-compare-effect](https://github.com/kentcdodds/use-deep-compare-effect))

# Why?
You can solve the [problem](https://github.com/kentcdodds/use-deep-compare-effect#the-problem) of using objects as useEffect via deep compare effect explained in the link.
but the key here is that deep comparisons are slow and have unpredictable performance. The idea behind `useCustomCompareEffect` is you probably know
the shape of the data you're passing as effect dependency so that you can write a cheap and predictable compare function to decide whether run the effect or not.
another use case would be running effect only when certain properties changed.

Note: This works best when you're generating code (let's say client side api for your backend) cause you know the exact shape of the data so you can also
generate cheap compare functions as an alternative to deep comparisons or `JSON.stringify`, That's what we are doing at Sanjagh.

# Install
```sh
npm install use-custom-compare-effect
# or yarn
yarn add use-custom-compare-effect
```

# How to use
You can provide your custom compare function as the third params like below:
```js
import useCustomCompareEffect from 'use-custom-compare-effect';

// ... usage
useCustomCompareEffect(() => {
  // ... your usual callback here
  // do things like fetch network request or the like
  // the second params dont have to be an array, it can be object, number, etc
}, {a: 'things'}, (a, b) => {
  // and here is your custom compare function
  // you can check difference between old(a variable) and new(b variable)
  // in here like so
  return a.a === b.a;
})
```

## License

MIT

use-custom-compare-effect

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README