组合式函数 useUnreadPolling 封装了未读消息轮询,集成定时请求、状态管理与自动清理,支持登录态控制、失败重试、页面可见性暂停、卸载清理及手动刷新。

用组合式函数封装未读消息轮询,核心是把“定时请求 + 状态管理 + 自动清理”抽离成可复用、可配置的逻辑,而不是在每个组件里写一堆 setInterval 和 onUnmounted。
明确轮询要解决的几个关键问题
未读消息轮询不是简单地每隔几秒发个请求——它需要:
- 只在用户登录态有效时运行(避免无效轮询)
- 请求失败时有重试机制(比如网络抖动、401/403)
- 页面隐藏或标签页失焦时暂停(节省资源、符合规范)
- 组件卸载时自动停止,不残留定时器
- 支持手动触发刷新(比如用户下拉刷新)
- 返回可响应式使用的数据、加载状态、错误信息
推荐方案:基于 @vueuse/core 的轻量封装
@vueuse/core 提供了 useIntervalFn 和 useOnline、usePageVisibility 等能力,组合起来比手写 setTimeout 更健壮。你可以这样封装一个 useUnreadPolling:
(文件路径建议:composables/useUnreadPolling.ts)
import { ref, watch, onUnmounted } from 'vue'
import { useIntervalFn, usePageVisibility, useOnline } from '@vueuse/core'
import { getUnreadCount } from '@/api/message' // 你的实际接口
export function useUnreadPolling(options: {
interval?: number
enabled?: boolean // 是否启用轮询(例如登录后才设为 true)
} = {}) {
const { interval = 30_000, enabled = true } = options
const count = ref<number>(0)
const loading = ref(false)
const error = ref<error null>(null)
const isPolling = ref(enabled)
// 页面可见性 & 网络状态联动控制
const isVisible = usePageVisibility()
const isOnline = useOnline()
const fetch = async () => {
if (!isPolling.value || !isVisible.value || !isOnline.value) return
loading.value = true
error.value = null
try {
const res = await getUnreadCount()
count.value = res?.unread ?? 0
} catch (err) {
error.value = err as Error
} finally {
loading.value = false
}
}
// 启动轮询(立即执行一次 + 定期间隔)
const { pause, resume, isActive } = useIntervalFn(fetch, interval, {
immediate: true,
callback: fetch
})
// 自动暂停/恢复逻辑
watch([isVisible, isOnline], ([vis, online]) => {
if (vis && online && isPolling.value) resume()
else pause()
})
// 外部可调用的手动刷新
const refresh = () => {
if (isPolling.value) fetch()
}
// 组件销毁时确保停止
onUnmounted(() => {
pause()
})
return {
count,
loading,
error,
refresh,
pause,
resume,
isActive,
// 可开关轮询(比如登出时调用 stop())
stop: () => {
isPolling.value = false
pause()
},
start: () => {
isPolling.value = true
resume()
}
}
}</error></number>
在组件中使用示例
非常干净,只需两行调用 + 解构:
<script setup lang="ts">
import { useUnreadPolling } from '@/composables/useUnreadPolling'
import { useUserStore } from '@/stores/user'
const userStore = useUserStore()
const { count, loading, refresh, pause, resume } = useUnreadPolling({
enabled: userStore.isLoggedIn
})
// 登录状态变化时动态启停
watch(() => userStore.isLoggedIn, (isLoggedIn) => {
if (isLoggedIn) resume()
else pause()
})
</script><template><div class="badge" v-if="!loading">
<span v-if="count > 0">{{ count }}</span>
</div>
<button>手动刷新</button>
</template>
进阶:对接消息推送(长连接兜底)
纯轮询有延迟,生产环境建议搭配 WebSocket 或 SSE。此时组合式函数可以扩展:
- 增加
onMessage回调,接收实时推送的未读数 - 收到推送后自动
refresh(),并重置轮询计时器(防重复) - 断连时 fallback 到轮询,连上后再切回推送
这些逻辑依然可以封装在同一个 useUnreadPolling 内,对外接口不变,内部策略可插拔。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











