👍
react-use

^{Collection of essential React Hooks. Port of libreact.
Translations: 🇨🇳 汉语}

npm i react-use

• Sensors
  • useBattery — tracks device battery state.
  • useGeolocation — tracks geo location state of user's device.
  • useHover and useHoverDirty — tracks mouse hover state of some element.
  • useHash — tracks location hash value.
  • useIdle — tracks whether user is being inactive.
  • useIntersection — tracks an HTML element's intersection.
  • useKey, useKeyPress, useKeyboardJs, and useKeyPressEvent — track keys.
  • useLocation and useSearchParam — tracks page navigation bar location state.
  • useLongPress — tracks long press gesture of some element.
  • useMedia — tracks state of a CSS media query.
  • useMediaDevices — tracks state of connected hardware devices.
  • useMotion — tracks state of device's motion sensor.
  • useMouse and useMouseHovered — tracks state of mouse position.
  • useMouseWheel — tracks deltaY of scrolled mouse wheel.
  • useNetworkState — tracks the state of browser's network connection.
  • useOrientation — tracks state of device's screen orientation.
  • usePageLeave — triggers when mouse leaves page boundaries.
  • useScratch — tracks mouse click-and-scrub state.
  • useScroll — tracks an HTML element's scroll position.
  • useScrolling — tracks whether HTML element is scrolling.
  • useStartTyping — detects when user starts typing.
  • useWindowScroll — tracks Window scroll position.
  • useWindowSize — tracks Window dimensions.
  • useMeasure and useSize — tracks an HTML element's dimensions.
  • createBreakpoint — tracks innerWidth
  • useScrollbarWidth — detects browser's native scrollbars width.
  • usePinchZoom — tracks pointer events to detect pinch zoom in and out status.
    
    
• UI
  • useAudio — plays audio and exposes its controls.
  • useClickAway — triggers callback when user clicks outside target area.
  • useCss — dynamically adjusts CSS.
  • useDrop and useDropArea — tracks file, link and copy-paste drops.
  • useFullscreen — display an element or video full-screen.
  • useSlider — provides slide behavior over any HTML element.
  • useSpeech — synthesizes speech from a text string.
  • useVibrate — provide physical feedback using the Vibration API.
  • useVideo — plays video, tracks its state, and exposes playback controls.
    
    
• Animations
  • useRaf — re-renders component on each requestAnimationFrame.
  • useInterval and useHarmonicIntervalFn — re-renders component on a set interval using setInterval.
  • useSpring — interpolates number over time according to spring dynamics.
  • useTimeout — re-renders component after a timeout.
  • useTimeoutFn — calls given function after a timeout.
  • useTween — re-renders component, while tweening a number from 0 to 1.
  • useUpdate — returns a callback, which re-renders component when called.
    
    
• Side-effects
  • useAsync, useAsyncFn, and useAsyncRetry — resolves an async function.
  • useBeforeUnload — shows browser alert when user try to reload or close the page.
  • useCookie — provides way to read, update and delete a cookie.
  • useCopyToClipboard — copies text to clipboard.
  • useDebounce — debounces a function.
  • useError — error dispatcher.
  • useFavicon — sets favicon of the page.
  • useLocalStorage — manages a value in localStorage.
  • useLockBodyScroll — lock scrolling of the body element.
  • useRafLoop — calls given function inside the RAF loop.
  • useSessionStorage — manages a value in sessionStorage.
  • useThrottle and useThrottleFn — throttles a function.
  • useTitle — sets title of the page.
  • usePermission — query permission status for browser APIs.
    
    
• Lifecycles
  • useEffectOnce — a modified useEffect hook that only runs once.
  • useEvent — subscribe to events.
  • useLifecycles — calls mount and unmount callbacks.
  • useMountedState and useUnmountPromise — track if component is mounted.
  • usePromise — resolves promise only while component is mounted.
  • useLogger — logs in console as component goes through life-cycles.
  • useMount — calls mount callbacks.
  • useUnmount — calls unmount callbacks.
  • useUpdateEffect — run an effect only on updates.
  • useIsomorphicLayoutEffect — useLayoutEffect that that works on server.
  • useDeepCompareEffect, useShallowCompareEffect, and useCustomCompareEffect
    
    
• State
  • createMemo — factory of memoized hooks.
  • createReducer — factory of reducer hooks with custom middleware.
  • createReducerContext and createStateContext — factory of hooks for a sharing state between components.
  • useDefault — returns the default value when state is null or undefined.
  • useGetSet — returns state getter get() instead of raw state.
  • useGetSetState — as if useGetSet and useSetState had a baby.
  • useLatest — returns the latest state or props
  • usePrevious — returns the previous state or props.
  • usePreviousDistinct — like usePrevious but with a predicate to determine if previous should update.
  • useObservable — tracks latest value of an Observable.
  • useRafState — creates setState method which only updates after requestAnimationFrame.
  • useSetState — creates setState method which works like this.setState.
  • useStateList — circularly iterates over an array.
  • useToggle and useBoolean — tracks state of a boolean.
  • useCounter and useNumber — tracks state of a number.
  • useList ~and useUpsert~ — tracks state of an array.
  • useMap — tracks state of an object.
  • useSet — tracks state of a Set.
  • useQueue — implements simple queue.
  • useStateValidator — tracks state of an object.
  • useStateWithHistory — stores previous state values and provides handles to travel through them.
  • useMultiStateValidator — alike the useStateValidator, but tracks multiple states at a time.
  • useMediatedState — like the regular useState but with mediation by custom function.
  • useFirstMountState — check if current render is first.
  • useRendersCount — count component renders.
  • createGlobalState — cross component shared state.
  • useMethods — neat alternative to useReducer.
    
    
• Miscellaneous
  • useEnsuredForwardedRef and ensuredForwardRef — use a React.forwardedRef safely.

Usage — how to import.
Unlicense — public domain.
Support — add yourself to backer list below.

17.6.0 (2024-12-09)

Features

• add onChange callback to useWindowSize (ea656f7)
• add onChange callback to useWindowSize (3eb531a)

17.5.1 (2024-07-20)

Bug Fixes

• 🐛 bump nano-css dependency (adfb337)

17.5.0 (2024-01-22)

Features

• add isFirst and isLast methods to useStateList hook (ac64414)
• pencil: add isFirst and isLast return value to 'useStateList' (75218e4)
• pencil: fix with yarn lint:fix (6a9dde5)

17.4.4 (2024-01-21)

Bug Fixes

• typo in example (0534648)

17.4.3 (2024-01-13)

Bug Fixes

• update useMedia hook to use recommended approach of MDN (e7379f0)

17.4.2 (2023-12-01)

Bug Fixes

• correct peer dependencies (d770587)

17.4.1 (2023-11-28)

Bug Fixes

• 🐛 bump nano-css version (812952b)

17.4.0 (2022-05-20)

Features

• add usePinchZoom sensor hook (3e042cb)

17.3.3 (2022-05-20)

Bug Fixes

• bump React peer dependency version (532e865)
• resolve #2319 (4884b2c)
• resolve @types/react@18 break change, React.FC (20b7817)

17.3.2 (2021-12-30)

Bug Fixes

• useMedia SSR hydration bug with defaultState (#2216) (5c01189)

17.3.1 (2021-08-31)

Performance Improvements

• ⚡️ change title only if it changed (51ef8d9)

17.3.0 (2021-08-31)

Bug Fixes

• do not re-render unncessarily in useAsyncFn hook (fa3ba25)

Features

• useAudio add playing state (3203610)

17.2.4 (2021-04-23)

Bug Fixes

• lint issues. (66b0f23)
• useLocalStorage: reinitialize on key change (fdd1b23)
• add generic typing to createHTMLMediaHook. no typecheck problem with ref anymore. (1f547ef)
• add generic typing to createHTMLMediaHook. no typecheck problem with ref anymore. (ac4dd78)

17.2.3 (2021-04-06)

Bug Fixes

• lint issues. (5a5a575)

17.2.2 (2021-04-06)

Bug Fixes

• useStateWithHistory: support callback style setState (fca687d)

17.2.1 (2021-03-11)

Bug Fixes

• lint issues. (3e8af15)
• useMeasure type definitions for SVG (e200f7f)
• useUnmountPromise stops on immediate update (9ff5c09)

17.2.0 (2021-03-10)

Bug Fixes

• delete isClient (72f4cb9)
• lint issues. (dc5bbe0)
• useOrientation: handle orientation being 0 (793b053)
• useOrientation: update tests to increase coverage (f9c743f)
• use window inside useEffect (2f33aa8)

Features

• useOrientation: add tests (f45cb70)

17.1.1 (2021-02-10)

Bug Fixes

• useMountedState should not change state on componentDidUpdate lifecycle (701b306)

17.1.0 (2021-02-01)

Features

• prettier: make prettier a part of eslint. (b6993a6)

17.0.2 (2021-02-01)

Bug Fixes

• proper definition for useMeasure (1461527)

17.0.1 (2021-01-31)

Bug Fixes

• proper definition for isBrowser and isNavigator states. (a087deb), closes #1777

17.0.0 (2021-01-31)

Features

• refactor the useNetwork hook. (23037f2)

BREAKING CHANGES

• useNetwork hook renamed to useNetworkState.

16.1.0 (2021-01-31)

Features

• improve on and off util functions typing. (723c588)

16.0.0 (2021-01-30)

chore

• refactoring and rearrangement. (a27f09f)

BREAKING CHANGES

• all create* factories been moved to factory subdirectory and in case direct import should be imported like react-use/esm/factory/createBreakpoint
• comps directory renamed to component

15.3.8 (2021-01-08)

Bug Fixes

• improve useStateValidator and useMultiStateValidator typings. (acff81d)

15.3.7 (2021-01-08)

Bug Fixes

• #1646 (ebc7094)

15.3.6 (2021-01-07)

Bug Fixes

• Fix issues in tests (7668ce5)

15.3.4 (2020-09-04)

Bug Fixes

• useLongPress hook linting fixes. (479dd99)

15.3.3 (2020-07-24)

Bug Fixes

• replace createFactory usages with createElement (ad29bea)

15.3.2 (2020-06-29)

Bug Fixes

• useFullscreen: fix typings so #1205 can be merged. (e6e55a3)

15.3.1 (2020-06-29)

Bug Fixes

• usePrevious: revert the reworked variant as a fix of #1315 (a4279eb)

15.3.0 (2020-06-19)

Features

• usePrevious: reworked the hook, now it is more memory-efficient. (8c6f467)

15.2.5 (2020-06-15)

Bug Fixes

• bump react-universal-interface (1540c1a)

15.2.4 (2020-06-13)

Bug Fixes

• doesn't unlock the body on unmount (1ead4ef)

15.2.3 (2020-06-13)

Bug Fixes

• 🐛 improve how text is dropped in useDrop hook (b2f46d1)

15.2.2 (2020-06-08)

Bug Fixes

• repair useKeyboardJs hook (8410bb0)

15.2.1 (2020-06-08)

Bug Fixes

• 🐛 bump fast-deep-equal, and consume it through ES import (f3c715c)

15.2.0 (2020-06-07)

Features

• add useMouseWheel hook (d714b12)

15.1.1 (2020-05-30)

Bug Fixes

• 🐛 use useIsomorphicLayoutEffect everywhere (dad26e5)

15.1.0 (2020-05-18)

Bug Fixes

• display alert timeout in story (2bb65ef)
• mutate ref in render directly (5488f5e)

Features

• add useLatest hook (d6fe267)

15.0.3 (2020-05-18)

Bug Fixes

• 🐛 correct useMeasure typings (bedbad7)

15.0.2 (2020-05-17)

Bug Fixes

• 🐛 dont memoize useScratch event handlers (ffc7579)

15.0.1 (2020-05-16)

Bug Fixes

• deps: update dependency tslib to v2 (6aebf3c)

15.0.0 (2020-05-16)

• v15 release (0f82ba6)

Bug Fixes

• 🐛 better serialization handling in useLocalStorage hook (68fb835)
• 🐛 correctly test if env is browser in useMeasure (9ae494f)
• 🐛 make useMeasure work on server (2daf769)
• 🐛 remove set dependencies in useSet hook (90ba9d0)
• 🐛 revert useMeasure defaults to zeros (dc92b64)
• remove console log 🤓 (f17c8a0)
• useLocalStorage: using undefined for empty value instead of null (1620e01)
• use latest set object in useSet "has" method (41f9452)

Features

• 🎸 add useScratch() sensor hook (58db2f9)
• 🎸 catch up with v14 (be69035)
• 🎸 improve implementation of useMeasure() hook (a164843)
• 🎸 improve implementation of useMeasure() hook (4d88240)
• 🎸 mock useMeasure() hook on server and w/o ResizeObserver (866f3d7)
• 🎸 mock useMeasure() hook on server and w/o ResizeObserver (2bbc73a)
• 🎸 remove resize-observer-polyfill from useMeasure (2a13fba)
• 🎸 remove resize-observer-polyfill from useMeasure (bf11131)
• Dependencies inference for useCustomCompareEffect (477c164)
• improve useAsyncFn and useAsync typings (85967e2)
• keep previous state in useAsyncFn (54ac91b)
• use useReducer in useUpdate hook, instead of useState + useCallback (6575b14)
• useLocalStorage: add remove feature. (#229) (587de16)

BREAKING CHANGES

• implementation of useMeasure and useLocalStorage changed
• resize-observer-polyfill package is not used with useMeasure() hook anymore.
• useMeasure() now defaults all values to -1, if they were not set and internal implementation heavily refactored.
• useAsyncFn now keeps hold of old result/error when called multiple times
• resize-observer-polyfill package is not used with useMeasure() hook anymore.
• useMeasure() now defaults all values to -1, if they were not set and internal implementation heavily refactored.

14.3.0 (2020-05-16)

Features

• 🎸 add useScratch hook (2a2a298)

14.2.0 (2020-04-24)

Features

• 🎸 onScrubStop provide value where scrub stopped (138b43c)

14.1.1 (2020-04-11)

Bug Fixes

• deps: update dependency @types/js-cookie to v2.2.6 (f9f4fae)

14.1.0 (2020-04-08)

Features

• add useHash hook (44a6cde)

14.0.0 (2020-04-04)

Features

• useRafLoop: implement #1090 (1ef1272)
• useRafLoop: reworked the hook, now it do not re-render parent component. (baa2f75)

BREAKING CHANGES

• useRafLoop: changed return array, now it returns only functions in next order: [stop, start, isActive].

Parent component is not re-rendered on loop start/stop.

13.27.1 (2020-03-25)

Bug Fixes

• deps: update dependency @xobotyi/scrollbar-width to v1.9.5 (9751390)

13.27.0 (2020-03-03)

Features

• useSet: add toggle a method (#968) (477614f)

13.26.5 (2020-03-02)

Bug Fixes

• deps: update dependency @xobotyi/scrollbar-width to v1.9.4 (29d017b)

13.26.4 (2020-02-29)

Bug Fixes

• useHoverDirty eslint fix (0ed6521)

13.26.3 (2020-02-26)

Bug Fixes

• deps: update dependency @types/js-cookie to v2.2.5 (1f3217a)

13.26.2 (2020-02-24)

Bug Fixes

• deps: update dependency @xobotyi/scrollbar-width to v1.9.3 (6e2287d)

13.26.1 (2020-02-16)

Bug Fixes

• deps: update dependency @xobotyi/scrollbar-width to v1.9.0 (601d787)

13.26.0 (2020-02-15)

Bug Fixes

• add initialState to deps (b394f3d)

Features

• add useMethods state hook (7554b9a)

13.25.1 (2020-02-15)

Bug Fixes

• 🐛 support default event in useClickAway() (24281cd)
• generic type on event arg in onClickAway callback on useClickAway (4ffe454)

13.25.0 (2020-02-15)

Features

• useBeforeUnload: allow passing a dirty function (#842) (c4a14a4)

13.24.1 (2020-02-15)

Performance Improvements

• use fast-deep-equal for deep comparisons (b9a8aad)

13.24.0 (2020-02-04)

Features

• add createReducerContext and createStateContext factories (84b8310)

13.23.0 (2020-02-04)

Features

• add createGlobalState hook generator (fda7199)

13.22.5 (2020-02-04)

Bug Fixes

• 🐛 don't throw in useMediaDevices on missing browser API (0f119fe)
• handle undefined mediaDevices (6f68437)

13.22.4 (2020-01-30)

Bug Fixes

• deps: update dependency @xobotyi/scrollbar-width to v1.8.2 (#930) (727b950)

13.22.3 (2020-01-28)

Bug Fixes

• useIntersection: disconnect an old IntersectionObserver instance when the ref changes (ac2f54a)
• useIntersection: reset an intersectionObserverEntry when the ref changes (3f8687e)
• useIntersection: return null if IntersectionObserver is not supported (4f6d388)

13.22.2 (2020-01-27)

Bug Fixes

• deps: update dependency @xobotyi/scrollbar-width to v1.7.0 (db74101)

13.22.1 (2020-01-27)

Bug Fixes

• deps: update dependency @xobotyi/scrollbar-width to v1.6.0 (431ba5d)

13.22.0 (2020-01-24)

Bug Fixes

• Fail testing and update doc (57b9041)

Features

• add useLongPress hook (45681b8)

13.21.0 (2020-01-20)

Features

• Typings for useDefault (fa0f53b)

13.20.0 (2020-01-17)

Features

• useMap: allow resetting with provided value other then initial (7645f72)

13.19.0 (2020-01-16)

Features

• add useError hook (65f3644)

13.18.0 (2020-01-16)

Bug Fixes

• check for null (d619c39)

Features

• add serializer/deserializer option to useLocalStorage (5316510)

13.17.0 (2020-01-15)

Features

• add support for body lock on iOS (d778408)

13.16.1 (2020-01-14)

Bug Fixes

• update the types dep for js-cookie (5c55d59)

13.16.0 (2020-01-14)

Features

• add option to useTitle to restore title on un-mount (b8b3e47)

13.15.0 (2020-01-13)

Features

• add useCookie hook (4e5c90f)

13.14.3 (2020-01-08)

Bug Fixes

• useUpdateEffect cleanup test returns false positive (9b31c42)
• useUpdateEffect test returning false positive (#865) (1946006)

13.14.2 (2020-01-08)

Bug Fixes

• bump fast-shallow-equal (19b2b39)

13.14.1 (2020-01-07)

Bug Fixes

• useUpdateEffect returns optional cleanup function (0ce421c)
• useUpdateEffect returns optional cleanup function (#864) (7960127)

13.14.0 (2020-01-03)

Features

• 🎸 add [vertical] flag to useSlider() hook (777865c)

13.13.0 (2019-12-27)

Features

• add useShallowCompareEffect and useCustomCompareEffect hooks (ba8803e)

13.12.2 (2019-12-10)

Bug Fixes

• useSet: "has" method in useSet updated to reference latest set object (4f1d8c2)

13.12.1 (2019-12-09)

Bug Fixes

• useMap: methods with side effects should be stable across renders. (020b4db)

13.12.0 (2019-12-09)

Features

• useScrollbarWidth hook; (#825) (125c7e9)

13.11.0 (2019-12-08)

Features

• 🎸 add useUnmountPromise hook (01421bc)

13.10.2 (2019-12-05)

Bug Fixes

• useUpdate hitting maxInt, failing to trigger rerender (93e7291)

13.10.1 (2019-12-03)

Bug Fixes

• "get" method in useMap updated to reference latest map object (044d267)

13.10.0 (2019-11-28)

Features

• useStateHistory (#709) (0a66359)

13.9.0 (2019-11-23)

Features

• add useFirstMountState & useRendersCount hooks (#769) (30abe2b)

13.8.2 (2019-11-22)

Bug Fixes

• #792: make useUnmount invoke the current callback version instead of very first (75284c6), closes #792

13.8.1 (2019-11-21)

Bug Fixes

• useAsyncFn does not discard old promises and might produce races (022fa0b)

13.8.0 (2019-11-14)

Features

• useStateValidator: Refactor method and improve typings; (436c210)

13.7.0 (2019-11-14)

Features

• Add useSet hook (095b4de)

13.6.3 (2019-11-12)

Bug Fixes

• remove any types in useThrottleFn (bb5baea)

13.6.2 (2019-11-11)

Bug Fixes

• restrict useThrottleFn types (61a83d1)

13.6.1 (2019-11-10)

Bug Fixes

• 🐛 check window.Event constructor exists in useLocation (ad09431)

13.6.0 (2019-11-10)

Features

• useCounter: reset to the newest initialValue (#667) (e653383)

13.5.0 (2019-11-08)

Bug Fixes

• resolveHookState: by accident removed needed type. (59aa41c)

Features

• useList: reimplemented useList hook; (1840b57)

13.4.0 (2019-11-08)

Features

• useStateList: implemented currentIndex, setState, setStateAt methods as requested in #634; (43cb6aa)

13.3.0 (2019-11-06)

Features

• useDebounce add cancel (693aec8)
• useDebounce add cancel (26cab31)

13.2.2 (2019-11-06)

Bug Fixes

• #749: now should work with SSR (c12976c), closes #749

13.2.1 (2019-11-04)

Bug Fixes

• yarn.lock: re-create the yarn.lock file with nailed versions in devDeps (f094a3a)

13.2.0 (2019-11-04)

Features

• re-create yarn.lock (d48e03e)
• re-create yarn.lock (ccdffe0)
• usePreviousDistinct: add tests for undefined value behaviour; (cb373f9)
• usePreviousDistinct: improve types; (30f53e8)
• usePreviousDistinct: now predicate not called on initial render; (fbe9b13)
• useStateList: rework useStateList to make it work properly. (242c274)
• useTitle: reworked hook to make it synchronous without useUpdate; (a133267)
• useWindowSize: A bit changed lyfecycle and added types; (03bdecf)

13.1.0 (2019-11-01)

Features

• pull request template for features (1dc21f3)

13.0.1 (2019-11-01)

Bug Fixes

• useLockBodyScroll: infer overflow type directly from declaration. (26baf47)

13.0.0 (2019-11-01)

• Merge pull request #711 from streamich/remove-react-wait (8d40f18), closes #711

Features

• remove useRefMounted hook (ad74d3d)
• useRefMounted: remove obsolete hook; (dc364c8)
• useWait: removed from package due to it is simple reexport of other package; (d7c38bd)

BREAKING CHANGES

• useWait hook has been removed from react-use
• deprecated useRefMounted hook is now removed, use useMountedState hook instead

12.13.0 (2019-10-31)

Features

• useCounter: reworked with use of new resolveHookState function plus improved memory usage; (befcf84)
• useGetSet: reworked with use of new resolveHookState function plus improved memory usage; (9b5d0f2)
• react-like state resolver to use it in stateful hooks; (9fd02eb)

12.12.0 (2019-10-31)

Features

• add typings for createReducer (f1cf036)

12.11.0 (2019-10-31)

Features

• useWait: add deprecation messages to readme and export; (d338245)

12.10.0 (2019-10-30)

Features

• useUpdate: improve memory usage - now single function instance to increment all counters; (0f02fd0)

12.9.1 (2019-10-28)

Bug Fixes

• useSize avoid crash in Safari 11 (da0e66b)

12.9.0 (2019-10-26)

Features

• add createBreakpoint (79ba4ef)

12.8.0 (2019-10-25)

Features

• add ensuredForwardRef and useEnsuredForwardedRef (1bfe063)

12.7.2 (2019-10-23)

Bug Fixes

• 🐛 bump set-harmonic-interval package version (f7c709a)

12.7.1 (2019-10-17)

Bug Fixes

• example in the docs; (7f54cad)
• rename story's mediator and add g flag to it's regex; (652b318)

12.7.0 (2019-10-17)

Bug Fixes

• error throw tests; (056875b)
• useMultiStateValidator readme description; (8c7f7f5)

Features

• useMultiStateValidator (ae26988)

12.6.0 (2019-10-16)

Features

• useRafState (#684) (00816a4)

12.5.0 (2019-10-13)

Features

• useList allow pushing multiple items (#621) (a624364)

12.4.0 (2019-10-12)

Features

• useIntersection (#652) (d5f359f)

12.3.2 (2019-10-12)

Bug Fixes

• improve use of refs in dependency lists (#655) (ed8e26d)

12.3.1 (2019-10-10)

Bug Fixes

• move @types/react-wait to dependencies, closes #661 (#662) (6bdd74e)

12.3.0 (2019-10-07)

Features

• reset util callback for useList (#654) (9ea3548)

12.2.3 (2019-10-05)

Bug Fixes

• move react-wait types to dev dependencies, closes #644 (49372ac)

12.2.2 (2019-09-26)

Bug Fixes

• useDebounce remove deps from function arguments (#623) (23d6a5a)

12.2.1 (2019-09-23)

Bug Fixes

• remove attempt from deps of retry in useAsyncRetry (#614) (adce59e)

12.2.0 (2019-09-02)

Features

• improve useWindowSize performance rAF (60a4937)

12.1.0 (2019-09-01)

Features

• 🎸 add useSearchParam() hook (b22f32f)
• 🎸 support server-side rendering in useSearchParam() hook (64ac924)

12.0.0 (2019-09-01)

Features

• store "paused" instead of "isPlaying" in media state (ff900d5)

BREAKING CHANGES

• now media players return "paused" instead of "isPlaying" in their state.

11.3.2 (2019-08-25)

Bug Fixes

• useThrottle & useThrottleFn proper timeout type; (e2cdb94)

11.3.1 (2019-08-25)

Bug Fixes

• update createReducer to fix initial state (fd083f2)

11.3.0 (2019-08-25)

Features

• add usePreviousDistinct (#551) (6c3e569)

11.2.0 (2019-08-25)

Features

• add useCircularIterate (8d84340)

11.1.1 (2019-08-25)

Bug Fixes

• #550 (2617d74)

11.1.0 (2019-08-25)

Features

• 🎸 add useHarmonicIntervalFn() hook (d9f21e3)

11.0.2 (2019-08-23)

Bug Fixes

• useSetState: memoize setState callback (0275329)
• useSetState: memoize setState callback (16f023f)

11.0.1 (2019-08-23)

Bug Fixes

• correct useSpring() hook behaviour (d7a622d)

11.0.0 (2019-08-22)

Features

• add cancel and reset methods to useTimeout (283045a)
• add useTimeoutFn (284e6fd)

BREAKING CHANGES

• useTimeout now returns a tuple

10.8.0 (2019-08-20)

Bug Fixes

• Reworked useBattery hook (1069060)
• succeed useRafLoop tests (09167df)

Features

• 🎸 support useBattery hook on server side (5d31cf0)
• 🎸 use only one useState and one useEffect call (2d0fabf)

10.7.1 (2019-08-20)

Bug Fixes

• async test warnings (#543) (7af237e)

10.7.0 (2019-08-19)

Features

• 🎸 add useUpsert (6875e13)
• 🎸 export useUpsert from index (3eda2b2)
• add useUpsert (a7c2899)

10.6.4 (2019-08-19)

Bug Fixes

• return from useUpdateEffect (2f70dc2)
• useUpdateEffect add return (8b24df4)

10.6.3 (2019-08-19)

Bug Fixes

• allow import default for ESM (bd3a062)
• rollup build error: Cannot call a namespace ('writeText') (b3e672b)

10.6.2 (2019-08-18)

Bug Fixes

• 🐛 fix master (d1df7a5)

10.6.1 (2019-08-17)

Bug Fixes

• useUpdateEffect run on the wrong time (1d5cd10)

10.6.0 (2019-08-17)

Features

• add min/max to useNumber (586faab)

10.5.0 (2019-08-03)

Features

• add useRafLoop hook (be7d7c3)

10.4.0 (2019-08-02)

Features

• add useMountedState hook (9081b99)

10.3.1 (2019-08-02)

Bug Fixes

• storybook: fix useKeyboardJs import path (b7481f6)
• useKeyboardJs: fix argument type error (8c820ce)
• allow string list in useKeyboardJs hook (aecbd0b)

10.3.0 (2019-07-26)

Features

• add useDefault hook (ade0557)

10.2.0 (2019-07-25)

Features

• useWindowScroll - for cross-browser compatibility (5987cc8)
• useWindowScroll - for cross-browser compatibility (#480) (e37dd8d)

10.1.2 (2019-07-21)

Bug Fixes

• remove OpenCollective postinstall hook (26dcebc)

10.1.1 (2019-07-21)

Bug Fixes

• useMouse & useMouseHovered type definitions for SVG (9e97451)
• useMouse & useMouseHovered type definitions for SVG (#479) (e2e4a60)

10.1.0 (2019-07-17)

Features

• add latest react-wait types (6ebe3bb)

10.0.0 (2019-07-17)

Features

• remove big libs from peerDependencies (1dbdc5d)

BREAKING CHANGES

• useSpring and useKeyboardJs hooks need to be imported directly now and libs they depend on are not in peerDependencies anymore.

9.12.0 (2019-07-16)

Bug Fixes

• 🐛 fix useDebounce import (40b33da)

Features

• add useInterval hook (6645ed9)

9.11.2 (2019-07-16)

Bug Fixes

• support useMedia usage server-side (50a5160)

9.11.1 (2019-07-16)

Bug Fixes

• createReducer stable dispatch function identity (9780545)

9.11.0 (2019-07-11)

Features

• useMedia - initialize state with call to media query (#454) (ab81897)

9.10.0 (2019-07-10)

Features

• expose useIsomorphicLayoutEffect + docs (#451) (8dcbbf1)

9.9.0 (2019-07-10)

Features

• add usePermission (4da40b9)
• usePermission (588a0c5)

9.8.3 (2019-07-10)

Bug Fixes

• useLocalStorage types for functional updates (e2b8278)

9.8.2 (2019-07-08)

Bug Fixes

• useSize: prevents accessing iframe's property when it's not defined (c9b5cdc), closes #442
• useSize: prevents accessing iframe's property when it's not… (#443) (8f04e8f)
• iframe can be null (a9e3bab)

9.8.1 (2019-06-30)

Bug Fixes

• lint fixes via lint:fix (7ce8e4f)
• useMap uses prevMap state which is safer (3554f79)
• useMap: remove now also uses prevMap state to not overwrite or lose state (0a59869)

9.8.0 (2019-06-30)

Bug Fixes

• 🐛 fix test and add pre-push hook (1353b6c)

Features

• add voice option in use speech (6dc2dd5)
• add voice option in useSpeech (#422) (c32d02b)

9.7.2 (2019-06-27)

Bug Fixes

• save to localStorage only when state changes (ba6d375)
• use correct list variable in useList (#412) (b937296)

9.7.1 (2019-06-23)

Bug Fixes

• 🐛 use synchronouse effect to subscribe to observables (376eea3)

9.7.0 (2019-06-19)

Features

• improve useClickAway() hook (#394) (c60df19)

9.6.0 (2019-06-18)

Bug Fixes

• add additional ref check on clean up (d18d2d8)
• always return something from effect (3355426)

Features

• 🎸 add useScrolling hook (bd9928e)
• 🎸 add useScrolling hook to index (b3ba702)
• add useScrolling docs (25a93f6)
• add useScrolling story (760edf1)

9.5.0 (2019-06-16)

Bug Fixes

• add missing rate property (fb795a6)

Features

• add rate option in useSpeech (f52f1f7)
• add rate option in useSpeech (#399) (0e4ebc6)

9.4.1 (2019-06-12)

Bug Fixes

• fix Storybook docs Markdown import (962a312)

9.4.0 (2019-06-04)

Bug Fixes

• fix TypeScript error (72e3036)
• docs: syntax error, improve examples (8bbe9d8)

Features

• improve createReducer function (6ba2d93), closes #164

9.3.0 (2019-05-31)

Features

• improve useAsync and useAsyncFn (3ab1d5d)

9.2.0 (2019-05-31)

Features

• 🎸 improve useObservable() type annotations (d0c3713)
• improve useSetState() typings (fad4440)

9.1.2 (2019-05-24)

Bug Fixes

• useAudio: src change should reset isPlaying state (65bffca)

9.1.1 (2019-05-24)

Bug Fixes

• useMap: more stringent type (7bbbe47)

9.1.0 (2019-05-24)

Features

• pass arguments to useAsyncFn function (6789d10)

9.0.0 (2019-05-09)

Features

• improve useToggle interface (81b1cac)

BREAKING CHANGES

• useToggle interface changed

8.4.0 (2019-05-07)

Features

• add usePrevious hook (4861a39)

8.3.1 (2019-04-29)

Bug Fixes

• useRefMounted: only run and cleanup once (6a651be)

8.3.0 (2019-04-29)

Features

• add type define for createMemo (6638c1a)

8.2.0 (2019-04-23)

Bug Fixes

• make options useGeolocation optional (01959a1)

Features

• support options for useGeolocation (7d4c59e)

8.1.4 (2019-04-23)

Bug Fixes

• 🐛 support click away on iOS, allow user to chose events (f14e1d7)

8.1.3 (2019-04-18)

Bug Fixes

• 🐛 don't fire typing event on modifier keys pressed (ce76edf)

8.1.2 (2019-04-12)

Bug Fixes

• useIdle: include 'ms' prop in uesEffect dependencies (7a670a2)

8.1.1 (2019-04-09)

Bug Fixes

• 🐛 make useLocation work on server, improve hook (6f6030a)

8.1.0 (2019-04-08)

Features

• add useAsyncCallback hook (c6ecb36)

8.0.0 (2019-04-08)

Features

• change useCopyToClipboard implementation (c391038)

BREAKING CHANGES

• useCopyToClipboard interface changed

7.6.0 (2019-04-07)

Bug Fixes

• 🐛 handle case when activeElement is empty (3d83705)

Features

• 🎸 add useStartTypings hook (5fda2e0)

7.5.0 (2019-04-07)

Features

• 🎸 add onCopy and onError events and use NPM copy library (2553225)
• 🎸 improve useCopyToClipboard() hook (f185044)
• 🎸 make useCopyToClipboard hook interface more idiomatic (0a6d773)
• add useCopyToClipboard() hook (4d8e276)

7.4.0 (2019-04-07)

Features

• add useDeepCompareEffect hook (77e015b)

7.3.1 (2019-03-31)

Bug Fixes

• 🐛 call key{up/donw} callbacks in useKeyPressEvent correct (60064a6)

7.3.0 (2019-03-31)

Features

• add useEffectOnce hook (06c12d4)

7.2.0 (2019-03-31)

Features

• default dependency array for useAsync and useAsyncRetry (cb140a0)

7.1.1 (2019-03-30)

Bug Fixes

• consistent refs in useFullscreen hook (dc85499)

7.1.0 (2019-03-29)

Bug Fixes

• useClickAway TypeScript typings (4b20083)

Features

• pass click event in useClickAway to user (01e38bc)

7.0.2 (2019-03-29)

Bug Fixes

• 🐛 add rebound and keyboards deps back to peerDependencies (4fc46aa)

7.0.1 (2019-03-29)

Bug Fixes

• add optional attributes in AsyncState (b0c9770)

7.0.0 (2019-03-28)

Bug Fixes

• 🐛 fix TypeScript build errors (5c95f28)
• 🐛 make sure all paths in usePageLeave return (6655092)
• 🐛 track "over" state better in useDrop hook (acc355c)

Features

• 🎸 add clear() to useList, use fn for state updates (b20cf7c)
• 🎸 add createRenderProp function for creating render-props (f4fd748)
• 🎸 add useDrop hook (6e415cf)
• 🎸 add useDropArea hook (676d0de)
• 🎸 add useEvent hook (2a13cfb)
• 🎸 add useKey hook (299fd86)
• 🎸 add useKeyboardJs hook (3516aa6)
• 🎸 add usePageLeave hook (33ac91b)
• 🎸 add useThrottleFn hook that throttles function (0ccdf95)
• 🎸 improve useFullscreen hook (7c38165)
• 🎸 keep keyboard events in useKeyPress hook (00fecab)
• 🎸 refactor useKeyPressEvent hook (c0658f6)
• 🎸 return events from useKeyboardJs hook (aa277b8)
• 🎸 simplify and improve useThrottle hook (452e8d9)
• 🎸 useKeyPress hook now uses useKey, KeyboardJS removed (727743b)

BREAKING CHANGES

• 🧨 useKeyPressEvent hook modified for dependency injection and providing event objects to user
• 🧨 KeyboardJS now available anymore in useKeyPress hook, instead it will be a separate useKeyPressKJ hook.
• 🧨 useThrottle is now a completely different hook

6.2.2 (2019-03-28)

Bug Fixes

• fix deps arg and union type in useAsync and useAsyncRetry (929e726)

6.2.1 (2019-03-27)

Bug Fixes

• set 'module' field properly (35d4fc2)

6.2.0 (2019-03-27)

Bug Fixes

• add esm to 'files' in package.json (fc1ba07)
• clean esm folder as well (0a10a6e)

Features

• emit code in ES Module mode (464642e)

6.1.0 (2019-03-26)

Features

• add useThrottle hook (756bc99)

6.0.0 (2019-03-26)

Bug Fixes

• 🐛 bump nano-css (f1f36dc), closes #90
• 🐛 don't throw only in development (f5faba5)

chore

• 🤖 don't install only large dependencies (6170067)

Features

• 🎸 add {bound} option to useMouse (9bb02a1)
• 🎸 implement useClickAway, remove useOutsideClick (a03143a)
• 🎸 keep global state of all useLockBodyScroll hooks (5dd10e9)
• 🎸 move extra mouse functionality into useMouseHovered (8b0580e)
• more precise size for useMouse (b887075)

BREAKING CHANGES

• 🧨 error is logged instead of thrown in development environment
• 🧨 useOutsideClick is now useClickAway
• 🧨 useCallbag hook is removed, some hooks KeyboardJS and Rebound installed separately

5.16.1 (2019-03-26)

Bug Fixes

• types for useGeolocation (b72c098)

5.16.0 (2019-03-25)

Features

• more precise size for useMouse (1761031)

5.15.0 (2019-03-25)

Features

• add useMouse hook (17dfa8e)

5.14.0 (2019-03-24)

Features

• 🎸 keep global state of all useLockBodyScroll hooks (9bb7047)
• add useLockBodyScroll hook (d990db4)

5.13.0 (2019-03-23)

Features

• add useScroll hook (a92e9b2)

5.12.1 (2019-03-23)

Bug Fixes

• 🐛 cancel animation frame on un-mount in useWindowScroll() (bc021ce)

5.12.0 (2019-03-23)

Features

• add useWindowScroll hook (076d0de)

5.11.0 (2019-03-22)

Features

• 🎸 refresh useCss hook (0116cc9)

5.10.0 (2019-03-21)

Features

• add useUpdateEffect hook (c2afd23)

5.9.0 (2019-03-21)

Features

• add useAsyncRetry hook (576cf42)

Performance Improvements

• remove asyn/await wrapper (8e3de1c)

5.8.1 (2019-03-20)

Bug Fixes

• 🐛 use useLayoutEffect() in useCss() to inject CSS quick (7328f26)

5.8.0 (2019-03-19)

Features

• release useKeyPressEvent() (96798e2)

5.7.1 (2019-03-15)

Bug Fixes

• 🐛 allow every promise in usePromise() hook have own type (d60fef7)

5.7.0 (2019-03-15)

Bug Fixes

• 🐛 fix TypeScript typings for usePromise() (ba0acb6)

Features

• 🎸 add usePromise() hook (aad368b)

5.6.0 (2019-03-13)

Features

• transpile down to ES5 (61382e3)

5.5.6 (2019-03-11)

Bug Fixes

• correct createMemo.md (4e2d639)
• correct createMemo.story (9c8e093)

5.5.5 (2019-03-04)

Bug Fixes

• 🐛 make useWindowSize work on server (8f93853)

5.5.4 (2019-02-25)

Bug Fixes

• 🐛 new React behaviour needs useState to set something (e926faf), closes #128

5.5.3 (2019-02-25)

Bug Fixes

• deps: update dependency use-callbag to ^0.2.0 (4d49d0b)

5.5.2 (2019-02-24)

Bug Fixes

• deps: update dependency use-onclickoutside to ^0.3.0 (0baae6d)

5.5.1 (2019-02-24)

Bug Fixes

• deps: update dependency ts-easing to ^0.2.0 (3321e11)

5.5.0 (2019-02-23)

Bug Fixes

• add type definition for useList() remove() method (ea2dc43)
• useSetState bug (83611a1)

Features

• Add remove method for useList (5a295d9)

5.4.1 (2019-02-19)

Bug Fixes

• 🐛 better async loading for keyboardjs (2096bae), closes #103

5.4.0 (2019-02-19)

Features

• add error and loading fields to useGeolocation (6909a69)

5.3.1 (2019-02-17)

Bug Fixes

• 🐛 fix typings in useOrientation sensor (afbacac)
• 🐛 fix useSetState after React update (524abe5), closes #107 #107
• useOrientation breaks in some devices (d89bd54)

5.3.0 (2019-02-07)

Features

• Add updateAt method for useList (ad05609)

5.2.3 (2019-02-07)

Bug Fixes

• 🐛 fix build and update React deps (27e26a0)

5.2.2 (2019-02-02)

Bug Fixes

• release useDebounce and useToggle fixes (12ad880)

5.2.1 (2019-01-04)

Bug Fixes

• use function to correctly update state in useToggle (d854d27)

5.2.0 (2019-01-02)

Features

• 🎸 add useKeyPress hook (01df885)
• useKeyPress: allow complex bindings via key combos (e53a20f)

5.1.2 (2018-12-29)

Bug Fixes

• reset state when calling useEffect in useAsync (2f5af2c)

5.1.1 (2018-12-20)

Bug Fixes

• lock react and react-dom to a fixed version (#83) (455812d)

5.1.0 (2018-12-19)

Bug Fixes

• 🐛 just use any for setTimeout because of diff environments (55673cb)
• 🐛 memoized does not receive arguments (244a533)
• 🐛 use Timeout type for build to work (8c66abe)

Features

• added useDebounce (91ff6ba)
• pass arguments to memoized callback (#81) (88dd513)

5.0.0 (2018-12-17)

Features

• 🎸 list all useAsync state props so that TS dont complain (7c1b107)
• 🎸 remove experimental hooks (533e26f)
• use discriminated union in useAsync (966af4a)

BREAKING CHANGES

• useRenderProp and useAsync are removed

4.11.1 (2018-12-16)

Bug Fixes

• synchronously re-render bug of useRaf hook (#77) (5d74348)

4.11.0 (2018-12-05)

Features

• 🎸 add useRefMounted hook (dfb0510)

4.10.0 (2018-11-10)

Features

• bump useWait (124ef99)

4.9.0 (2018-11-06)

Features

• add useSessionStorage hook (eca432a)
• add useWait hook (61c6058)

4.8.0 (2018-11-02)

Features

• allow useSetState setter to accept function (bfd114a)

4.7.0 (2018-10-30)

Features

• 🎸 add useHoverDirty hook (c2aee59)

4.6.0 (2018-10-30)

Features

• 🎸 implement useLocalStorage without events (d211722)

4.5.0 (2018-10-29)

Features

• 🎸 add useAdopt hook (91bee9a)
• 🎸 add useRenderProp hook (2d85c61)

4.4.0 (2018-10-29)

Features

• 🎸 add useCallbag hook (ead142c)

4.3.0 (2018-10-29)

Features

• 🎸 add useOutsideClick hook (90d2c22)

4.2.0 (2018-10-29)

Features

• 🎸 add useVideo hook (ff05419)
• 🎸 allow to pass React

4.1.0 (2018-10-29)

Features

• 🎸 add createMemo hook factory (8730eaa)

4.0.0 (2018-10-29)

Features

• 🎸 add useNumber alias (a58a4a7)
• 🎸 improve useCounter interface (395e82b)

BREAKING CHANGES

• useCounter interface changed

3.1.0 (2018-10-29)

Features

• 🎸 add useGetSetState (dcd1013)

Performance Improvements

• ⚡️ wrape useGetSetState callbacks in useCallback (3c1e57d)

3.0.0 (2018-10-29)

Features

• 🎸 accept any value type in useToggle and cast it to bool (869f767)

BREAKING CHANGES

• now useToggle and useBoolean accept any value type and cast it to boolean.

2.3.0 (2018-10-29)

Features

• 🎸 add useBoolean hook (ce6de24)

2.2.0 (2018-10-29)

Features

• 🎸 add useGetSet hook (bfc30b9)
• 🎸 add useUpdate hook (c00f308)

2.1.0 (2018-10-28)

Features

• 🎸 add useObservable (711e831)

2.0.0 (2018-10-28)

Features

• 🎸 change API for useToggle hook (#16) (5a6da18)

BREAKING CHANGES

• useToggle interface changed

1.0.0 (2018-10-28)

chore

• 🤖 release v1 (4236cf0)

Continuous Integration

• 🎡 store CircleCI artifacts, add git-cz (690dd5e)

Features

• 🎸 add useAsync hook (258d696)
• 🎸 add useAudio hook (4336aa1)
• 🎸 add useBattery hook (73ce535)
• 🎸 add useCounter hook (79e5b8c)
• 🎸 add useCss hook (2c0a7e4)
• 🎸 add useFavicon hook (ab1739a)
• 🎸 add useGeolocation hook (13a7326)
• 🎸 add useHover hook (406af20)
• 🎸 add useIdle hook (74d3ece)
• 🎸 add useLifecycles hook (f99c89f)
• 🎸 add useList hook (4bea508)
• 🎸 add useLocation hook (46a8e2c)
• 🎸 add useLogger hook (7c38b75)
• 🎸 add useMap hook (6509c25)
• 🎸 add useMedia hook (e1cc9ab)
• 🎸 add useMediaDevices hook (4ea0277)
• 🎸 add useMotion hook (91eb4ea)
• 🎸 add useMount and useUnmount hooks (63a1444)
• 🎸 add useNetwork hook (5881fa6)
• 🎸 add useOrientation hook (c533b97)
• 🎸 add useRaf hook (26b2593)
• 🎸 add useSetState hook (972541d)
• 🎸 add useSize hook (620b171)
• 🎸 add useSpeech hook (3b971a2)
• 🎸 add useSprgin hook (b4fe5b0)
• 🎸 add useTimeout hook (86f094e)
• 🎸 add useTitle hook (1bff6d8)
• 🎸 add useToggle() hook (a36dceb)
• 🎸 add useTween hook (877343e)
• 🎸 add useWindowSize() hook (2c46899)
• 🎸 do work on useLocaStorage (2541716)
• 🎸 improve useSize, pass through state to the element (5b1356a)

BREAKING CHANGES

• make semantic-release bump version
• Released v1.0.0