Integrations
elements
lifecycle
browser
- useAudio
- useBattery
- useBluetooth
- useBreakpoints
- useBroadcastChannel
- useBrowserLocation
- useClipboard
- useCopy
- useCssVar
- useDeviceList
- useDisplayMedia
- useDocumentEvent
- useDocumentTitle
- useDocumentVisibility
- useEventListener
- useEventSource
- useEyeDropper
- useFavicon
- useFileSystemAccess
- useFps
- useFullscreen
- useGamepad
- useGeolocation
- useMeasure
- useMediaControls
- useMediaQuery
- useMediaStream
- useMemory
- useNetwork
- useNotification
- useObjectUrl
- useOnline
- useOtpCredential
- usePermission
- usePictureInPicture
- usePointerLock
- usePostMessage
- useRaf
- useShare
- useSpeechRecognition
- useSpeechSynthesis
- useSticky
- useVibrate
- useVirtualKeyboard
- useWakeLock
- useWebMCP
- useWebSocket
- useWebWorker
- useWebWorkerCallback
utilities
state
- useBoolean
- useControllableState
- useCookie
- useCookies
- useCounter
- useCycleList
- useDefault
- useDisclosure
- useField
- useForm
- useHash
- useList
- useLocalStorage
- useMap
- useMask
- useMergedRef
- useObject
- useOffsetPagination
- useQueue
- useRafState
- useRefState
- useSessionStorage
- useSet
- useStateHistory
- useStep
- useStorage
- useToggle
- useUrlSearchParam
- useUrlSearchParams
- useValidatedState
- useWizard
user
sensors
- useDeviceMotion
- useDeviceOrientation
- useHotkeys
- useIdle
- useInfiniteScroll
- useIntersectionObserver
- useKeyboard
- useKeyPress
- useKeysPressed
- useMouse
- useMutationObserver
- useOrientation
- usePageLeave
- useParallax
- usePerformanceObserver
- useResizeObserver
- useScroll
- useScrollIntoView
- useScrollTo
- useSwipe
- useTextSelection
- useVisibility
- useWindowEvent
- useWindowFocus
- useWindowScroll
- useWindowSize
Nested dependencyThe nested range object is rebuilt on every render, so only the default deep comparison sees the filter as unchanged.
useEffect0every render
shallowEqual0nested ref differs
default0skips identical values
import { shallowEqual, useCompareEffect, useRerender } from '@siberiacancode/reactuse';
import { LayersIcon, RefreshCwIcon } from 'lucide-react';
import { useEffect, useRef } from 'react';
const Demo = () => {
const rerender = useRerender();
const filter = { role: 'admin', range: { from: 0, to: 10 } };
const effectCountRef = useRef(0);
const shallowCountRef = useRef(0);
const deepCountRef = useRef(0);
useEffect(() => {
effectCountRef.current++;
}, [filter]);
useCompareEffect(
() => {
shallowCountRef.current++;
},
[filter],
shallowEqual
);
useCompareEffect(() => {
deepCountRef.current++;
}, [filter]);
return (
<section className='flex w-full max-w-sm flex-col p-4'>
<div className='bg-card flex flex-col gap-4 rounded-xl p-5 shadow-sm'>
<div className='flex items-start gap-3'>
<div className='bg-primary/15 text-primary flex size-10 shrink-0 items-center justify-center rounded-full'>
<LayersIcon className='size-5' />
</div>
<div className='flex min-w-0 flex-1 flex-col gap-1 leading-tight'>
<span className='text-foreground text-sm font-semibold'>Nested dependency</span>
<span className='text-muted-foreground text-xs leading-relaxed'>
The nested <b>range</b> object is rebuilt on every render, so only the default deep
comparison sees the filter as unchanged.
</span>
</div>
</div>
<div className='border-border grid grid-cols-3 gap-3 border-t pt-3'>
<div className='flex flex-col leading-tight'>
<span className='text-muted-foreground text-[10px] tracking-wider uppercase'>
useEffect
</span>
<span className='text-foreground font-mono text-lg font-semibold tabular-nums'>
{effectCountRef.current}
</span>
<span className='text-muted-foreground mt-0.5 text-[10px] leading-tight'>
every render
</span>
</div>
<div className='flex flex-col leading-tight'>
<span className='text-muted-foreground text-[10px] tracking-wider uppercase'>
shallowEqual
</span>
<span className='text-foreground font-mono text-lg font-semibold tabular-nums'>
{shallowCountRef.current}
</span>
<span className='text-muted-foreground mt-0.5 text-[10px] leading-tight'>
nested ref differs
</span>
</div>
<div className='flex flex-col leading-tight'>
<span className='text-muted-foreground text-[10px] tracking-wider uppercase'>
default
</span>
<span className='text-primary font-mono text-lg font-semibold tabular-nums'>
{deepCountRef.current}
</span>
<span className='text-muted-foreground mt-0.5 text-[10px] leading-tight'>
skips identical values
</span>
</div>
</div>
<div className='border-border flex items-center justify-end border-t pt-3'>
<button data-size='sm' data-variant='outline' type='button' onClick={rerender}>
<RefreshCwIcon className='size-3.5' />
Re-render
</button>
</div>
</div>
</section>
);
};
export default Demo;
Installation
pnpm add @siberiacancode/reactuseUsage
useCompareEffect(() => console.log("effect"), [user]);Type Declarations
import type { DependencyList, EffectCallback } from 'react';
export type CompareFunction = (current: any, previous: any) => boolean;API
Parameters
| Name | Type | Default | Note |
|---|---|---|---|
| effect | EffectCallback | - | The effect callback |
| deps | DependencyList | - | The dependencies list for the effect |
| compare | CompareFunction | deepEqual | The function that returns `true` when a dependency is equal to its previous value |
Contributors
ddebabinRRoman Gontar
Last updated on