CHANGELOG.md

改动日志

0.19.0 (2024-01-17)

• fix: 重构 useStorage / useStorageSync，使其更贴合 uniapp 的使用习惯
• feat: 强化 useRouter，增加功能。
• feat: 增加 uniUseAutoImports 函数。
• feat: 增加 tryOnBackPress 函数

0.18.0 (2023-01-15)

• feat!: 调整 useLoading，现在返回是一个对象，其中包含 showLoading 和 hideLoading 两个方法
• fix: 调整类型实现，支持 vue v3.2.47 和 @vueuse/core v10，但仍需要用户侧做部分调整，参考 uni-app#4604
• feat: useDownloadFile、useRequest、useSocket、useStorageAsync、useUploadFile 对标 @vueuse/core v10.7.1

0.17.1 (2023-11-14)

• fix: 修复 useStorage，关闭 #28

0.17.0 (2023-11-13)

• fix: 修复 useStorage，关闭 #28
• feat!: 要求 node>=18

0.16.0 (2023-10-17)

• feat: 增加 usePageScroll，感谢 okxiaoliang4 在 #27 的贡献！

0.15.1 (2023-09-22)

• fix: 修复导出

0.15.0 (2023-08-31)

• feat: 增加 UniUseAutoImports，方便和 unplugin-auto-import 结合使用

0.14.1 (2023-08-15)

• fix: 修复 useStorageAsync 逻辑判断，关闭 #25

0.14.0 (2023-07-28)

• feat: 新增 useSelectorQuery，感谢 edwinhuish 在 #23 的贡献！

0.13.0 (2023-05-05)

• feat!: 移除 useImmer
• fix: 修复 useSocket 类型

0.12.0 (2023-02-16)

• build: 设置目标为 es2017
• fix: 修复 useDownloadFile 没有正确中止的问题
• fix: 修复 useRequest 没有正确中止的问题
• fix: 修复 useUploadFile 没有正确中止的问题
• fix: 修复 useSocket 内部实现
• feat: 新增 useStorageAsync，和 vue-use 的 useStorageAsync 类似
• feat!: 移除遗留的组件版本
• feat!: 移除大量无状态逻辑方法，避免过度封装
• feat!: 调整 useClipboardData 实现，现在会返回一个 Ref
• feat!: 调整 useGlobalData 实现，现在会返回一个 Ref
• feat!: 调整 useLoading 实现，现在会返回可调用的方法，和 useActionSheet 类似
• feat!: 调整 useNetwork 初始默认值为 none 并移除传参
• feat!: 调整 useRouter 实现，移除了所有方法
• feat!: 调整 useScreenBrightness 实现，现在会返回一个 Ref
• feat!: 调整 useSocket 实现，现在和 vue-use 的 useWebSocket 类似
• feat!: 移除 useStorage
• feat!: 调整 useToast 实现，现在会返回可调用的方法，和 useActionSheet 类似

请先阅读 组合式函数 和 组合式 API 常见问答，以了解为什么这个版本移除了大量无状态逻辑方法。核心内容摘录如下。

在 Vue 应用的概念中，“组合式函数”(Composables) 是一个利用 Vue 的组合式 API 来封装和复用有状态逻辑的函数。

当构建前端应用时，我们常常需要复用公共任务的逻辑。例如为了在不同地方格式化时间，我们可能会抽取一个可复用的日期格式化函数。这个函数封装了无状态的逻辑：它在接收一些输入后立刻返回所期望的输出。复用无状态逻辑的库有很多，比如你可能已经用过的 lodash 或是 date-fns。

相比之下，有状态逻辑负责管理会随时间而变化的状态。一个简单的例子是跟踪当前鼠标在页面中的位置。在实际应用中，也可能是像触摸手势或与数据库的连接状态这样的更复杂的逻辑。

0.11.0 (2023-01-10)

• feat!: 因难以保证稳定性移除所有组件版本

0.10.4 (2023-01-04)

• fix: 修复情况判断
• build: 切换到 rollup

0.10.3 (2022-12-28)

• fix: 修复导出

0.10.2 (2022-12-26)

• fix: 修复类型

0.10.1 (2022-12-23)

• fix: 修复构建

0.10.0 (2022-12-15)

• feat!: 要求 node >= 14.18，这是为了对标 rollup 和 vite
• feat: 默认为 esm 包，但仍支持 cjs

0.9.1 (2022-11-16)

• fix: 修复构建

0.9.0 (2022-11-16)

• feat!: 迁移到 @uni-helper/uni-use

0.8.0 (2022-10-24)

• feat: 新增 UseAccountInfo
• feat: 新增 useAddress
• feat: 新增 useAppBaseInfo 和 UseAppBaseInfo
• feat: 新增 useAudio
• feat: 新增 useAuthorize
• feat: 新增 useBackground 导出
• feat: 新增 useCamera
• feat: 新增 useDeviceInfo 和 UseDeviceInfo
• feat: 新增 useFile
• feat: 新增 useImage 导出
• feat: 新增 useImmer
• feat: 新增 useInvoice
• feat: 新增 useLocation 导出
• feat: 新增 useMap
• feat: 新增 useMenuButtonBoundingClientRect
• feat: 新增 useRecorder
• feat: 新增 useSubscription
• feat: 新增 useSystemSetting
• feat: 新增 useUpdate
• feat: 新增 useUser
• feat: 新增 useVideo
• feat: 增加 useWindowInfo 和 UseWindowInfo
• fix: 修复组件没有正确导出的问题

0.7.2 (2022-10-12)

• perf: 优化 useRequest、useDownloadFile 和 useUploadFile 类型
• fix: 修复构建

0.7.1 (2022-09-30)

• fix: 修复了构建不正常的问题

0.7.0 (2022-09-29)

• feat!: 现在要求使用 node >= 14.16
• feat!: 现在构建目标是 esnext
• fix: 修复了构建不正常的问题
• feat: 新增 useAccountInfo
• feat: 新增 useLaunchOptions
• feat: 新增 useEnterOptions

0.6.1

• fix: 修复 useSelectorQuery 类型

0.6.0

• feat!: 放弃 vue@2 支持
• perf!: 调整 useApp 导出
• perf: 优化 useActionSheet 类型
• feat: useArrayBufferToBase64 支持传入 ref
• feat: useBase64ToArrayBuffer 支持传入 ref
• perf: 优化 useBackground 类型
• perf: 优化 useClipboardData 类型
• fix: 修复 useGlobalData 错误赋值
• perf: 优化 useGlobalData 类型
• fix: 修复 useGlobalData 导出
• perf: 优化 useImage 类型
• perf: 优化 useLoading 类型
• perf: 优化 useLocation 类型
• perf: 优化 useModal 类型
• perf: 优化 useNavigationBar 类型
• fix: 替换 useRouter 中的 at
• perf: 优化 useRouter 类型
• perf: 优化 useScanCode 类型
• perf: 优化 useScreenBrightness 类型
• perf: 优化 useStorage 类型
• perf: 优化 useSupported 类型
• perf: 优化 useTabBar 类型
• perf: 优化 useToast 类型
• perf: 优化 useVibrate 类型

0.5.0

• feat: 新增 useActionSheet
• perf!: 调整 useArrayBufferToBase64 实现
• feat: 新增 useBackground
• perf!: 调整 useBase64ToArrayBuffer 实现
• fix: 修复 useClipboardData 监听
• perf: 调整 useClipboardData 实现
• feat!: 移除 useColorMode
• feat!: 移除 useDark
• perf!: 调整 useGlobalData 实现
• feat: 新增 useImage
• fix: 修复 useInterceptor 监听
• feat: 新增 useLoading
• feat: 新增 useLocation
• feat: 新增 useModal
• feat: 新增 useNavigationBar
• perf: 调整 useNetwork 实现
• perf: 调整 UsePreferredDark 实现
• perf: 调整 UsePreferredLanguage 实现
• feat: 新增 usePullDownRefresh 实现
• feat: 新增 useScanCode
• feat: 新增 useScreenBrightness 和 UseScreenBrightness
• feat: 新增 useSelectorQuery
• feat: 新增 useStorage
• feat!: 移除 useStorageAsync
• feat: 新增 useSystemInfo 和 UseSystemInfo
• feat: 新增 useTabBar
• feat: 新增 useToast
• perf: 调整 useVibrate 实现

0.4.2

• fix: 修复链接

0.4.1

• fix: 修复 setClipboardData 未正确更新的问题
• fix: 修复 UseGlobalData 导出错误
• fix: 修复 UseUniPlatform 导出错误
• perf: 调整 useRouter 导出

0.4.0

• feat: 新增 usePrevPage
• feat: 新增 usePrevRoute
• feat: 新增 useRoute
• feat: 新增 useVibrate
• fix: 调整 useArrayBufferToBase64 类型
• fix: 调整 useBase64ToArrayBuffer 类型
• fix: 调整 useClipboardData 参数和内部实现

0.3.0

• feat: 新增 tryOnHide
• feat: 新增 tryOnInit
• feat: 新增 tryOnLoad
• feat: 新增 tryOnReady
• feat: 新增 tryOnShow
• feat: 新增 tryOnUnload
• feat: 新增 useApp
• feat: 新增 useArrayBufferToBase64
• feat: 新增 useBase64ToArrayBuffer
• feat: 新增 useClipboardData 和 UseClipboardData
• feat: 新增 useGlobalData 和 useGlobalData
• feat: 新增 usePage
• feat: 新增 usePages
• feat: 新增 useRouter
• feat: 新增 useUniPlatform 和 UseUniPlatform
• feat: 新增 useSocket
• feat: 新增 useSupported
• feat: 新增 useVisible
• fix: 修复 useStorageAsync 判断

0.2.0

• feat: 新增 useColorMode 和 UseColorMode
• feat: 新增 useDark 和 UseDark
• fix: 修复 UseNetwork 导入
• fix: 修复 UseOnline 导入
• feat: 新增 usePreferredDark 和 UsePreferredDark
• feat: 新增 usePreferredLanguage 和 UsePreferredLanguage

0.1.0

• feat: 新增 useDownloadFile
• feat: 新增 useInterceptor
• feat: 新增 useNetwork 和 UseNetwork
• feat: 新增 useOnline 和 UseOnline
• feat: 新增 useRequest
• feat: 新增 useStorageAsync
• feat: 新增 useUploadFile