@restart/hooks

A set of utility and general-purpose React hooks.

Install

npm install @restart/hooks

Usage

import useInterval from '@restart/hooks/useInterval'

useInterval(() => loop(), 300, false)

0.6.2 (2025-01-07)

Bug Fixes

• exports definition again (364e4a6)

0.6.1 (2025-01-07)

Bug Fixes

• exports definition (523780d)

0.6.0 (2025-01-07)

• build!: Update build, export real ESM (#100) (9e272d3), closes #100

BREAKING CHANGES

• exports native esm modules and removes the index file in favor of sub imports

0.5.1 (2025-01-02)

Bug Fixes

• useTimeout: isPending never updates (51e14ec)

0.5.0 (2024-11-25)

• A number of StrictMode fixes and updates (#99) (1511129), closes #99

BREAKING CHANGES

• no longer supports cancelPrevious this is always true

• fix:(useDebouncedCallback): Clean up timeout logic in strict mode

• chore: deprecate useWillUnmount

This hook is not possible in StrictMode, and can cause bugs

• fix(useForceUpdate): ensure that chained calls produce an update

• Update useCustomEffect.ts

• address feedback

0.4.16 (2024-02-10)

Bug Fixes

• useDebouncedCallback: fix behavior in strict mode (#98) (9a01792)

0.4.15 (2023-12-07)

Bug Fixes

• useDebouncedState: Add factory function overload to type, clarify setter purity (9aa18fb)

0.4.14 (2023-12-07)

Bug Fixes

• useDebouncedCallback: wrap handler in useEventCallback so it's not stale (63f897a)

0.4.13 (2023-12-06)

Features

• useDebouncedCallback: return value from debounced function (d1ead47)

0.4.12 (2023-12-06)

Features

• add leading, and maxWait options to debounce hooks (#97) (c8d69b2)

0.4.11 (2023-07-17)

Bug Fixes

• useIsInitialRenderRef: clarify usage and fix ordering (437c417)

0.4.10 (2023-07-13)

Features

• useFocusManager: fire focused change immediately (#92) (7bb6d5a)

0.4.9 (2023-02-10)

Features

• add exports field in package.json (#88) (1c325b0)

0.4.8 (2023-01-25)

Bug Fixes

• useDebouncedCallback: fix return type (#85) (f2e26a0)

0.4.7 (2022-04-27)

Features

• useBreakpoint: add xxl breakpoint (#75) (8021cea)

0.4.6 (2022-04-01)

Bug Fixes

• useMounted: adjust to work with strict effects (#70) (8deba46)

0.4.5 (2021-12-10)

Features

• add useUpdateLayoutEffect (1914f7e)

0.4.4 (2021-12-07)

Bug Fixes

• use targetWindow (6c8fc0d)

0.4.3 (2021-12-07)

Bug Fixes

• store matchers per window (6509df8)

0.4.2 (2021-12-07)

Bug Fixes

• minor typo in useCommittedRef (#59) (0ceb834)

Features

• allow specifying window with useMedia/useBreakpoint (#61) (bf9716d)

0.4.1 (2021-09-27)

Bug Fixes

• useFocusManager: memo returned handlers (410bd5a)

Features

• add useDebouncedValue (362dedf)

0.4.0 (2021-06-17)

Features

• useIntersectionObserver: allow lazy roots (4c8b77a)
• useIntersectionObserver: allow lazy roots (#53) (6b035cf)

BREAKING CHANGES

• useIntersectionObserver: null in the native API means "the window", this is a departure to allow a consumer to hold off setting up the observer until the have a ref to the root. This was possible before by explicitly setting element to null until the root is available but still created an extra observer

0.3.27 (2021-06-16)

Bug Fixes

• types: fix ts errors (#47) (310e1ec)

Features

• useIntersectionObserver: add more performant overload (6c532d8)
• useMutationObserver: add overload to return records and trigger updates (1eaa621)
• useToggleState: add useToggleState hook (#48) (5f95dd0)
• add useDebouncedCallback hook (05fb8da)
• add useDebouncedState hook (a87dd3b)
• remove lodash (#35) (fefa63c)

0.3.26 (2021-01-05)

Bug Fixes

• Allow React 17 as peer dependency (#42) (d0fea56)

0.3.25 (2020-05-14)

Bug Fixes

• set crossOrigin prior to src (#31) (1d585ec)

0.3.24 (2020-05-13)

Features

• add useThrottledEventHandler (#30) (f03d52b)

0.3.23 (2020-05-13)

Bug Fixes

• improve initial state type (#29) (35613e4)

0.3.22 (2020-03-18)

Features

• useImmediateUpdateEffect: allow teardown from last effect like builtin effect hooks (b85ad85)
• add useCustomEffect (76b18d0)
• add useMutationObserver (c9df89c)

0.3.21 (2020-02-25)

Features

• add useMountEffect (f4c4753)
• add useRefWithInitialValueFactory (31188e2)
• add useUpdateEffect (a0d17b1)

0.3.20 (2020-01-23)

Features

• useTimeout: handle large delays (#21) (32d6951)

0.3.19 (2019-11-26)

Features

• Add option in useInterval to run immediately (#15) (899369f)

0.3.18 (2019-11-22)

Bug Fixes

• Fix React peer dependency (ea56c3d)

0.3.17 (2019-11-22)

Bug Fixes

• Clean up package.json (#16) (d167136)

0.3.16 (2019-11-22)

Features

• add useImmediateUpdateEffect (#14) (b6f5870)

0.3.15 (2019-10-23)

Features

• add useSafeState (#13) (88c53cb)

0.3.14 (2019-09-20)

Features

• add useAsyncSetState (#12) (0db4bb4)

0.3.13 (2019-09-06)

Bug Fixes

• useStableMemo infinite loop (ad6fc5a)

0.3.12 (2019-08-12)

Bug Fixes

• useMediaQuery: matches immediately in a DOM environment (#11) (5d1053d)

0.3.11 (2019-08-09)

Features

• add useMergedRef (#9) (83bd6e1)

0.3.10 (2019-08-09)

Features

• add useMap and useSet (#8) (c21429c)

0.3.9 (2019-08-05)

Features

• add useForceUpdate() (ba91b5f)

0.3.8 (2019-07-18)

Bug Fixes

• useInterval: don't call callback in useEffect (#7) (264fbeb)

0.3.7 (2019-07-11)

Bug Fixes

• useIntersectionObserver: fix internal set state call triggering warnings (7bc1d0c)

0.3.6 (2019-07-08)

Bug Fixes

• wrong useStableMemo export (16bda32)
• useAnimationFrame: stable return value (5cca2d4)

0.3.5 (2019-07-06)

Bug Fixes

• useIntersectionObserver: return an array consistently (ad3bb35)

Features

• add useMediaQuery and useBreakpoint (0d165ec)

0.3.4 (2019-07-04)

Bug Fixes

• useIntersectionObserver: make SSR compatible (fc56257)

0.3.3 (2019-07-03)

Bug Fixes

• useEventListener: correct listener options type (96503dc)

Features

• useAnimationFrame: add the ability to not clear previous callbacks (541b82c)
• useIntersectionObserver: add an IntersectionObserver hook (5791b22)
• useIsomorphicEffect: add hook to avoid SSR warning with useLayoutEffect (6e6b5fa)
• useResizeObserver: use with isomorphic safe effect (4a5d976)
• useStableMemo: add useStableMemo for a stable...useMemo (ff981fb)

0.3.2 (2019-06-26)

Features

• add esm support (#5) (ec456c1)
• useEventListener allows a function, useGlobalListener works in SSR (c67b9bc)

0.3.1 (2019-06-07)

Bug Fixes

• useMergeState: calling setState twice (#4) (ec7d569)

0.3.0 (2019-05-28)

Features

• better name (dca4d54)

BREAKING CHANGES

• useRequestAnimationFrame -> useAnimationFrame

0.2.14 (2019-05-28)

Features

• add useRequestAnimationFrame (5c8dff1)

0.2.13 (2019-05-15)

Bug Fixes

• types: useInterval overloads (f592102)

0.2.12 (2019-05-08)

Bug Fixes

• types: make useFocusManger options optional (c1ee506)
• useMounted: provides a stable isMounted function (3703508)

0.2.11 (2019-05-02)

Bug Fixes

• allow nullable handlers in event callback (c423cb8)

0.2.10 (2019-05-02)

Features

• add useFocusManager() (1cbeb66)
• add useTimeout() (4cb8fa1)
• add useUpdatedRef (79b3a49)
• add useWillUnmount() (ab3e4df)

0.2.9 (2019-04-22)

0.2.8 (2019-04-22)

Features

• add useCallbackRef (722f6f5)

0.2.7 (2019-04-16)

Bug Fixes

• types: allow null or undefined for useImage (6806fd4)
• useResizeObserver: allow element to be null or undefined (d441fa2)

0.2.6 (2019-04-15)

0.2.5 (2019-04-10)

Features

• support Images directly in useImage (f16210b)

0.2.3 (2019-03-28)

Features

• allow return null from useMergeState updater function (c14a4e5)

0.2.2 (2019-03-28)

Bug Fixes

• optional crossOrigin on useImage (2e08a7d)

0.2.1 (2019-03-28)

Features

• add useImage (5b5de01)

0.2.0 (2019-03-28)

Bug Fixes

• Target ES5 in build (#1) (1f49c80)

Features

• add use*Interval overloads (94dea26)
• add useEventListener (bc3f520)
• useEffect over LayoutEffect (95c3416)

BREAKING CHANGES

• changed arg order around on useInterval and useRafInterval
• useCommittedRef fires latter now on useEffect

0.1.6 (2019-03-27)

Features

• better globalListener types (b0ae1ed)

0.1.5 (2019-03-26)

Bug Fixes

• remove usePrevious console.log (aeb56d8)

0.1.4 (2019-03-26)

Bug Fixes

• deploy new code (be0689c)

0.1.3 (2019-03-26)

Features

• add useMounted (36ed090)