@vueuse/core

Bug Fixes

• useStorage: fix Set serialize error (#1475) (9b23828)

Features

• useElementBounding: new options (de05a18)

Bug Fixes

• nuxt: disable auto import from [@vueuse](https://github.com/vueuse)/integrations (dfac157)

Bug Fixes

• useStorage: update on same tick (#1472) (711053d)

Features

• useStorage: support serializing Date (#1471) (f5f6a39)

Bug Fixes

• useAxios: reuse url when only AxiosRequestConfig is passed to execute (#1438) (788a7ff)
• useKeyModifier: getModifierState is not a function (#1441) (946f6bc)
• useMediaQuery: media query before mount (#1461) (7edd0c6)

Features

• usePermission: support more permissions (#1462) (8dfbe99)

Bug Fixes

• nuxt: deprioritize auto imports (13fde88)
• useMagicKeys: handle meta key in MacOS (#1312) (bde6b1f)
• useStorage: fix sync racing and shreding (#1459) (1ae321b)
• bump vue-demi (#1451) (87e7a8b)

Features

• createInjectionState: init createInjectionState (#1456) (d98c4d8)

Bug Fixes

• metadata: unexported note entry (2f8ca30)

Features

• useWebSocket: allow to pass predicate function to autoReconnect… (#1433) (e3de556)

Bug Fixes

• useStroage: synced timing (27d1ba2)

Bug Fixes

• useEventListener: support component target (#1408) (981c651)
• useStorage sync race condition, closes #808 (#1430) (1ee0ae0)
• onKeyStroke: make directive only registered once (#1410) (da440ab)
• unrefElement: improve types (#1409) (3e19431)
• useElementHover: make directive only registered once (#1412) (db4f7a2)
• useElementSize: make directive only registered once (#1414) (bc1bd48)
• useElementVisibility: directive should work fine (#1424) (be803af)
• useInfiniteScroll: make directive only registered once (#1413) (554a17e)
• useIntersectionObserver: make directive only registered once (#1411) (fb71532)
• useScroll: make directive only registered once (#1415) (efc6cc5)

Features

• onClickOutside: customizable phase (#1406) (c31b01e)
• useElementVisibility: directive support (#1377) (de14228)

Bug Fixes

• useFetch: make helper methods return PromiseLike<UseFetchReturn<T>> (#1402) (b9e8e8a)
• useMediaQuery: removeEventListener in guard target should be med… (#1401) (92cedd1)

Breaking Changes

• Deprecated usage of @vueuse/core/nuxt has been removed, use @vueuse/nuxt instead
• syncRef renamed to syncRefs (5ec1da1d8f6920ad915fe5d5bd0397cb341a48c8)
• biSyncRef renamed to syncRef, with configurable syncing direction (360833d901df2acd019464984aaa2e5ed194f91e)
• fix(useTextSelection)!: listen to selectionchange event by @okxiaoliang4 in https://github.com/vueuse/vueuse/pull/1194
• refactor(useFocus)!: made target an required argument instead of an option by @wtykirby in https://github.com/vueuse/vueuse/pull/1010

Bug Fixes

• useAxios: args param need limit (#1343) (42fc7a7)
• useFetch: uppercase HTTP methods in useFetch (#1336) (4ce7c72)
• useTextSelection: ssr compactible (2a87733)
• onClickOutside: should work normal w/ directive (#1366) (66cefd5)

New Features

• New @vueuse/metadata package to replace the indexes.json with proper types
• Better support of related functions in docs
• Support alias of functions
• New functions
  • useTimeoutPoll: new function (#1178) (abd59a2)
  • useDateFormat: new function (#1123) (5c445d8)
  • useGamepad: new function (#1355) (5071118)
  • useFileSystemAccess: new function (#1243) (28066cb)
  • integrations: add useChangeCase (#1371) (a98e569)
• Enhancements
  • useAxios: allow useAxios to be awaited (#1228) (8812e7e)
  • useAxios: allow not passing url in constructor (#1388) (2a582d4)
  • useDraggable: add stopPropagation option (#1391) (7445f0a)
• Directive support for functions
  • onKeyStroke: directive support (#1362) (9f8eabb)
  • useElementHover: directive support (#1359) (73b0def)
  • useInfiniteScroll: directive support (#1340) (fd8ca8e)
  • useIntersectionObserver: directive support (#1339) (53d4dfd)
  • useScroll: directive support (#1348) (0daf86f)
  • useScrollLock: directive support (#1360) (4356613)
  • useElementSize: directive support (#1365) (1346456)

Refactoring

• Normalize the function names with the backward compact alias
  • eagerComputed -> computedEager
  • asyncComputed -> computedAsync
  • controlledComputed -> computedWithControl
  • useThrottle, throttledRef -> refThrottled
  • useDebounce, debouncedRef -> refDebounced
  • controlledRef -> refWithControl
  • pasuableWatch -> watchPasuable
  • ignorableWatch -> watchIgnorable
  • debouncedWatch -> watchDebounced
  • throttledWatch -> watchThrottled
  • and, or, not -> logicAnd, logicOr, logicNot
  • autoResetRef -> refAutoReset

New Contributors

• @Glandos made their first contribution in https://github.com/vueuse/vueuse/pull/1336
• @WuLianN made their first contribution in https://github.com/vueuse/vueuse/pull/1343
• @hengshanMWC made their first contribution in https://github.com/vueuse/vueuse/pull/1363
• @Rolanddoda made their first contribution in https://github.com/vueuse/vueuse/pull/1380
• @Flamenco made their first contribution in https://github.com/vueuse/vueuse/pull/1384
• @dospunk made their first contribution in https://github.com/vueuse/vueuse/pull/1392

New Team Members

• @webfansplz
• @okxiaoliang4

Full Changelog: https://github.com/vueuse/vueuse/compare/v7.7.1...v8.0.0

Bug Fixes

• onClickOutside: should work normal w/ directive (#1366) (66cefd5)

Features

• integrations: add useChangeCase (#1371) (a98e569)
• useElementSize: directive support (#1365) (1346456)

Full changelog at https://github.com/vueuse/vueuse/releases/tag/v8.0.0-beta.1

Bug Fixes

• useScrollLock: should work normal with initialState (#1257) (75146b8)
• use indirect type (#1337) (54a9ac0)
• useFetch: make error shallow (#1270) (53d1983)

Bug Fixes

• useCycleList: nullish check (#1280) (aef8a2b)
• useFetch: fix run afterFetch condition (#1271) (23b12a3)

Features

• reactiveComputed: new function (fcfec1c)
• reactiveOmit: add reactiveOmit (#1292) (3b5079c)
• useEventBus: payload support (#1279) (e4ceb92)
• useFullscreen: autoExit support (#1272) (c0b1ad0)
• useMouse: support eventFilter (#1261) (3927dd3)

Bug Fixes

• useElementBouding: should reset value while element unmounted (#1253) (aba020f)
• useElementSize: should reset value while element unmounted (#1254) (7b40091)
• useFps,useMemory: ssr support (#1244) (0e1e211)
• useMagicKeys: filter undefined event key (#1235) (03929c7)
• useToggle: toggle function return value (#1256) (8d190ae)

Features

• useCssVar: support prop be ref (#1236) (f99ea0d)
• useScriptTag: custom attrs support (#1229) (ef8684c)
• whenever: add type for callback param (#1246) (322cdcb)

Bug Fixes

• onLongPress: dir case (#1227) (768af79)

Bug Fixes

• integrations: relax peerDeps version, close #1189 (94411ad)
• ssr-handlers: fix _global is undefined (#1190) (5418f3b)
• UseDraggable: add prop key[storageType] (#1191) (20df83c)
• useElementBounding: update jsdoc (e1f64dc)

Features

• onClickOutside: add ignore option (#1205) (c275a2e)
• onLongPress: new function (#1225) (eed2889)
• useCached: new function (#1169) (fb37135)
• useEagerComputed: allow specify watchOptions (#1192) (2473407)
• useFetch: support more http methods (#1149) (#1193) (01f8dfb)
• useInfiniteScroll: new function (#1219) (4f0ad36)
• useInterval: support ref as interval (#1215) (a2b2b0d)
• useOffsetPagination: new function (#1104) (b4b7e8e)

Bug Fixes

• globalThis, close #1187, close #1163, close #1175 (3c8cdde)
• useCycleList: operator precedence (#1176) (6d2cb26)
• watchOnce: watchOnce when called with immediate flag (#1180) (b61ceec)

Features

• useAxios: added option to control whether the request fires immediately (#1170) (467522d)
• useStyleTag: new function (#1154) (0a696d4)

Bug Fixes

• ssr-handlers: compatible with QQ browser (#1133) (7dac4f8)
• types: do not use ShallowRef, close #1151 (3c38434)
• useDraggable: onEnd() runs even if target wasn't dragged directly in exact mode (#1145) (4879255)
• useWebSocket: close WebSocket (#1137) (f6b5994)
• useWebWorkerFn: fix multiple dependencies handling (#1138) (e6968fb)

Bug Fixes

• nuxt: types (503b4ec)
• storage: caught DOMException accessing storage (#1124) (77fe0fb)
• useAsyncState: improve types (#1119) (247cc73)

Bug Fixes

• useBroadcastChannel: fix demo (90c2593)

Features

• nuxt: use nuxt kit (de1ccf9)

Bug Fixes

• stricter eslint rules (c6abd6f)

Bug Fixes

• fromEvent: set immediate for from (issue #1099) (#1100) (0af4450)
• useScriptTag: unload should remove script tag (#1114) (970fe23)

Features

• useAsyncState: add property isLoading (#1116) (f0b9618)
• useBroadcastChannel: new function (#1085) (1a565bd)
• useMemoize: new function (#1045) (9645f98)
• useVibrate: new function (#1082) (cdeb95a)
• useWebNotification: new function (#979) (bf9b039)

Bug Fixes

• nuxt: cookies as storage should not expire (762a043)

Features

• ssr handlers (#1060) (3aa4997)
• useTitle: added optional titleTemplate injection (357ac93)

Bug Fixes

• useWebSocket: close WebSocket gently (#1057) (f4bb901)
• add @vueuse/core and @vueuse/shared to Nuxt build.transpile (#1064) (dadbff7)
• useElementBounding: fix target is null or undefined (#1043) (d6d1daf)
• useRafFn: only runs on client, close #1044 (c63616b)

Features

• useColorMode: new function (#1051) (ae5bfb4)
• useCycleList: new function (#1052) (adcebf8)
• useFetch: allow useFetch to be awaited (#1056) (8ee7677)
• useNavigatorLanguage: new function (#1046) (63e13cb)
• useScroll: pass original scroll event to callbacks (#1023) (a44eb92)

Bug Fixes

• useScrollLock: set the overflow property on iOS device as well (#1033) (1cae15d)
• useWebSocket: close WebSocket gently (#1018) (4b296c7)

Features

• throttleFilter: leading fix (#1039) (496dbd9)
• useAsyncState: add option for choosing shallowRef or ref (#1040) (b995216)
• useElementByPoint: new function (#1022) (3edf763)
• useSafeArea: new function (#985) (3de76e1)
• useStorageAsync: new function (169b02b)
• useSubject: new function (#1012) (edc8cf6)
• useTextSelection: new function (#1038) (0b83b0f)

Bug Fixes

• nuxt: import path (050be70)

Bug Fixes

• nuxt: build (879756c)

Bug Fixes

• useAsyncState: optional argument of execute (#972) (6661a09)
• UseVirtualList: fix list not being reactive in component (#968) (fb7cd78)

Features

• useEyeDropper: add initialValue option, improve types (#950) (cf8ced3)

Bug Fixes

• improve package.json (0c4e770)
• useMemory: import path (bd2346b)

Bug Fixes

• nuxt: add useCookie in disabled composables for Nuxt (#965) (4088dad)

Features

• useAsyncQueue: new function (#921) (4e40c6f)
• useClamp: new function (#953) (e6659b0)
• useLockScroll: new function (#958) (930890a)
• useMounted: new function (b6a36e0)

Bug Fixes

• nuxt: nuxt module mjs (8d38b6e)

Bug Fixes

• nuxt: provide mjs version for nuxt module (bf80643)
• useWindowSize: improve SSR (42ae437)

Features

• useMediaQuery: improve SSR (7b67da6)

Bug Fixes

• useBase64: improve SSR compatibility (6bc5f04)
• useEyeDropper: improve SSR compatibility (9b5f2c4)
• useFocuseTrap: types import path (8e0f424)

Features

• useDevicesList: add option (#943) (ea051e9)

BREAKING CHANGES

• refactor(onClickOutside)!: listen click event, remove event option (#817)
• fix(useGeolocation)!: latitude and longitude default to Infinity (#839)
• fix(useElementBounding)!: use getBoundingClientRect instead of contentRect (#870)
• fix(useClipboard)!: disable read by default (#941)

Bug Fixes

• useFocus: resolve issues when used with v-if (#927) (4755036)
• useWebWorker: explicit define return interface (#935) (d19a6a3)
• interface typos (#938) (8040940)

Features

• useCounter: add options (#928) (3c63842)
• useEventSource: add options (#939) (eda5d1e)
• useMemory: new function (#923) (8508d28)

Bug Fixes

• nuxt: opt-out vite optimization (2b11461)

Features

• createReactiveFn: new alias (6677e58)
• createUnrefFn: new function (#789) (083319c)
• debouncedRef: new alias (c5e0134)
• syncRef: support more watch source type (#918) (ca0ff73)
• throttledRef: new alias (52fcae7)
• useDraggable: add onEnd hook (#916) (07d4898)
• useEyeDropper: Reactive EyeDropper API (#911) (b65f705)
• useFocus: new function (#818) (355a945)
• useVirtualList: adding support for reactive lists (#904) (23356b2)

Bug Fixes

• toRefs: call set method on computed (#895) (0219f9d)

Features

• useBase64: new function (#879) (ef6b706)
• useBreakpoints: shortcuts (#905) (0bcf52a)
• useDebounce & useDebounceFn: accept maxMs parameter (#877) (529acc4)
• useFps: reactive fps (#898) (87d1741)

Bug Fixes

• esm compactiblity, close #847 (251e663)

Bug Fixes

• Could not resolve "@vueuse/shared" (#894) (d6beee8)
• useElementVisibility: prop 'as' does not work as expected (#889) (b58cce7)

Bug Fixes

• nuxt: do not register apis duplicately (732926c)
• exports useFetch return type (868ddb9)

Features

• useFetch: timeout (#869) (30e6901)
• useFuse: improve the demo (#857) (0d28ee4), closes #821

Bug Fixes

• nuxt module (3857b5d)

Bug Fixes

• useStorage: macro task for listening to storage change (c643549)

Features

• support Nuxt auto importing (399e5e9)
• controlledComputed: expose invalidate function (db7e607)
• useStorage: new writeDefaults option (bdce147)
• useStorage: support Map and Set (bc223d5)

Bug Fixes

• useStorage: macro task for listening to storage change (6206fd5)

Features

• controlledComputed: expose invalidate function (db7e607)
• useStorage: new writeDefaults option (39e3806)
• useStorage: support Map and Set (5239786)

Features

• UseFocusTrap: component (#820) (bdea8ea)

Features

• usePointerSwipe: support pointerTypes (4343c5b)

Bug Fixes

• types: MaybeElementRef type, close #685 (9728a14)
• useSpeechRecognition: reactive speech language (#741) (ec310e3)
• exports common types (9a45b9b)

Features

• asyncComputed: onError option (#749) (706a049)
• useBreakpoints: add breakpoints for Quasar (#756) (130c372)
• useDrauu: New function (#744) (4440b7c)
• useScroll: new Function (#739) (bc6c342)
• useThrottle: trailing option, useThrottledRefHistory updated (#760) (4a33eb4)
• useVirtualList: add useVirtualList function (#710) (bde7f1a)
• watchAtMost: new function (#764) (7c4fefc)
• added 'as' prop to renderable components (#742) (e557fa0)

Bug Fixes

• useDraggable: ssr support (1196cf6)

Features

• usePointer: suppor target and isInside flag (789dda6)
• useRefHistory: new option eventFilter, new functions useThrottledRefHistory and useDebouncedRefHistory (#740) (c05d5d6)
• useStorage: support pass ref to useStorage (8a9c425)
• useStorage: support writing null value to storage, close #452 (d6dd1ba)

Bug Fixes

• update linter rule, close #729 (4fbe8d5)

Features

• eagerComputed: new function (#720) (4690509)

Bug Fixes

• support TypeScript 4.4 (dee2f4d)
• useAsyncState: onError param type (#692) (ada7aca)
• bug in throttleFilter (#690) (b465d89)

Features

• onClickOutside: whitelist click event (#693) (9548a08)
• tryOnBeforeUnmount: new function (#709) (f573b95)
• useEventBus: new Function once (#680) (a39ec87)
• useFetch: payload supports ref and follow changed (#694) (e589935)
• useKeyModifier: new function (#698) (3b2d884)
• useVModel: new options deep to emit for deep changes (#669) (db319af)
• useWakeLock: new function (#687) (fd08371)
• useWebSocket: Added support for optional protocols (#705) (3816c29)