46 lines
1.1 KiB
JavaScript
46 lines
1.1 KiB
JavaScript
/**
|
||
* 后台返回事件总线
|
||
*
|
||
* 触发方：App.vue 在 onShow 中检测到"从后台切回前台"时调用
|
||
* emitAppReturnFromBackground()
|
||
* 订阅方：页面通过 composables/useBackgroundRefresh.js 注册回调
|
||
*
|
||
* 为什么不用 uni.$emit / uni.$on：
|
||
* 1. 事件名是字符串，缺乏约束，容易和其他业务事件撞名
|
||
* 2. 集中在一处便于后续加日志、节流、灰度等横切逻辑
|
||
*/
|
||
|
||
const listeners = new Set()
|
||
|
||
/**
|
||
* 注册后台返回监听
|
||
* @param {Function} fn 回调函数
|
||
* @returns {Function} 取消监听的函数
|
||
*/
|
||
export function onAppReturnFromBackground(fn) {
|
||
if (typeof fn !== 'function') return () => {}
|
||
listeners.add(fn)
|
||
return () => listeners.delete(fn)
|
||
}
|
||
|
||
/**
|
||
* 触发后台返回事件，通知所有订阅者
|
||
*/
|
||
export function emitAppReturnFromBackground() {
|
||
listeners.forEach(fn => {
|
||
try {
|
||
fn()
|
||
} catch (e) {
|
||
// 单个监听者异常不影响其他监听者
|
||
console.error('[backgroundRefreshBus] listener error:', e)
|
||
}
|
||
})
|
||
}
|
||
|
||
/**
|
||
* 清空所有监听（仅用于测试或强制重置）
|
||
*/
|
||
export function clearAppReturnFromBackgroundListeners() {
|
||
listeners.clear()
|
||
}
|