CustomEventSingleton.ts

// CustomEventSingleton.ts - 自定义事件单例导出

import { CustomEventBridge, CustomEventHandler } from './CustomEventBridge'

// 单例实例(挂载在 window 上)
const bridge =
  typeof window !== 'undefined'
    ? new CustomEventBridge(window, 'shared:')
    : new CustomEventBridge(new EventTarget(), 'shared:')

// ========== 类型导出 ==========
export type { CustomEventHandler }
export type SharedDataSubscriber<T = any> = CustomEventHandler<T>

// ========== 最推荐的调用方式(DOM 事件风格) ==========

export const on = <T>(key: string, handler: CustomEventHandler<T>): void => {
  bridge.subscribe(key, handler)
}

export const off = <T>(key: string, handler: CustomEventHandler<T>): void => {
  bridge.unsubscribe(key, handler)
}

export const dispatch = <T>(key: string, detail: T): void => {
  bridge.publish(key, detail)
}

export const once = <T>(key: string, handler: CustomEventHandler<T>): void => {
  bridge.once(key, handler)
}

export const get = <T>(key: string): T | undefined => {
  return bridge.get<T>(key)
}

export const clear = (key: string): void => {
  bridge.clear(key)
}

// ========== 共享数据(自定义事件) ==========

/**
 * 发布共享数据
 */
export const publishSharedData = <T>(key: string, data: T): void => {
  dispatch(key, data)
}

/**
 * 获取共享数据
 */
export const getSharedData = <T>(key: string): T | undefined => {
  return get<T>(key)
}

/**
 * 清除共享数据
 */
export const clearSharedData = (key: string): void => {
  clear(key)
}

/**
 * 订阅共享数据变化
 */
export const subscribeSharedData = <T>(
  key: string,
  callback: SharedDataSubscriber<T>
): void => {
  on(key, callback)
}

/**
 * 取消订阅共享数据变化
 */
export const unsubscribeSharedData = <T>(
  key: string,
  callback: SharedDataSubscriber<T>
): void => {
  off(key, callback)
}

/**
 * 一次性订阅
 */
export const onceSharedData = <T>(
  key: string,
  callback: SharedDataSubscriber<T>
): void => {
  once(key, callback)
}

// 导出实例(供高级用法)
export { CustomEventBridge, bridge }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
上次更新:
(adsbygoogle = window.adsbygoogle || []).push({});