@wxn0brp/event-emitter 0.0.3 → 0.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -0
- package/dist/index.d.ts +7 -6
- package/dist/index.js +8 -6
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -54,6 +54,11 @@ emitter.emit('data', 42, new Date()); // Typescript suggests number and Date par
|
|
|
54
54
|
|
|
55
55
|
// You can still emit events without strict type checking
|
|
56
56
|
emitter.emit('unknown_event', 'any', 'data'); // This is still allowed at runtime
|
|
57
|
+
|
|
58
|
+
// Catch-all event listener for all events
|
|
59
|
+
emitter.on('*', (originalEvent, ...originalArgs) => {
|
|
60
|
+
console.log(`Received event "${originalEvent}":`, originalArgs);
|
|
61
|
+
});
|
|
57
62
|
```
|
|
58
63
|
|
|
59
64
|
## API
|
|
@@ -78,6 +83,17 @@ Removes an event listener.
|
|
|
78
83
|
|
|
79
84
|
Emits an event.
|
|
80
85
|
|
|
86
|
+
### Catch-all Event Listener
|
|
87
|
+
|
|
88
|
+
The special `*` event acts as a catch-all that receives all emitted events. When any event is emitted, it will also trigger listeners registered for the `*` event with the original event name as the first argument, followed by the original arguments.
|
|
89
|
+
|
|
90
|
+
Example:
|
|
91
|
+
```typescript
|
|
92
|
+
emitter.on("*", (originalEvent, ...originalArgs) => {
|
|
93
|
+
console.log(`Caught event "${originalEvent}" with args:`, originalArgs);
|
|
94
|
+
});
|
|
95
|
+
```
|
|
96
|
+
|
|
81
97
|
### `listenerCount(event: string): number`
|
|
82
98
|
|
|
83
99
|
Returns the number of listeners for the given event.
|
package/dist/index.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
type EventMap = {
|
|
1
|
+
export type EventMap = {
|
|
2
2
|
[event: string]: (...args: any[]) => void;
|
|
3
3
|
};
|
|
4
|
-
type EventName<T extends EventMap> = keyof T | (string & {});
|
|
5
|
-
type EventArgs<T extends EventMap, K extends EventName<T>> = K extends keyof T ? Parameters<T[K]> : any[];
|
|
4
|
+
export type EventName<T extends EventMap> = keyof T | (string & {});
|
|
5
|
+
export type EventArgs<T extends EventMap, K extends EventName<T>> = K extends keyof T ? Parameters<T[K]> : any[];
|
|
6
6
|
export declare class VEE<T extends EventMap = {}> {
|
|
7
7
|
_events: {
|
|
8
8
|
[event: string]: Function[];
|
|
@@ -12,19 +12,20 @@ export declare class VEE<T extends EventMap = {}> {
|
|
|
12
12
|
* @param {K} event - event name
|
|
13
13
|
* @param {Function} listener - function to be called when event occurs
|
|
14
14
|
*/
|
|
15
|
-
on<K extends EventName<T>>(event: K, listener:
|
|
15
|
+
on<K extends EventName<T>>(event: K, listener: T[K]): void;
|
|
16
16
|
/**
|
|
17
17
|
* Registers a one-time event listener
|
|
18
18
|
* @param {K} event - event name
|
|
19
19
|
* @param {Function} listener - function to be called once
|
|
20
20
|
*/
|
|
21
|
-
once<K extends EventName<T>>(event: K, listener:
|
|
21
|
+
once<K extends EventName<T>>(event: K, listener: T[K]): void;
|
|
22
22
|
/**
|
|
23
23
|
* Removes an event listener.
|
|
24
24
|
* @param {K} event - event name
|
|
25
25
|
* @param {Function} listener - listener to remove
|
|
26
26
|
*/
|
|
27
|
-
off<K extends EventName<T>>(event: K, listener:
|
|
27
|
+
off<K extends EventName<T>>(event: K, listener: T[K]): void;
|
|
28
|
+
_emit(event: string, ...args: any[]): void;
|
|
28
29
|
/**
|
|
29
30
|
* Emits an event
|
|
30
31
|
* @param {K} event - event name
|
package/dist/index.js
CHANGED
|
@@ -34,18 +34,20 @@ export class VEE {
|
|
|
34
34
|
return;
|
|
35
35
|
this._events[_event] = this._events[_event].filter(l => l !== listener);
|
|
36
36
|
}
|
|
37
|
+
_emit(event, ...args) {
|
|
38
|
+
const listeners = this._events[event];
|
|
39
|
+
if (!listeners?.length)
|
|
40
|
+
return;
|
|
41
|
+
listeners.forEach(listener => listener(...args));
|
|
42
|
+
}
|
|
37
43
|
/**
|
|
38
44
|
* Emits an event
|
|
39
45
|
* @param {K} event - event name
|
|
40
46
|
* @param {...EventArgs<T, K>} args - arguments to be passed to listeners
|
|
41
47
|
*/
|
|
42
48
|
emit(event, ...args) {
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
listeners.forEach(listener => {
|
|
46
|
-
listener(...args);
|
|
47
|
-
});
|
|
48
|
-
}
|
|
49
|
+
this._emit(event, ...args);
|
|
50
|
+
this._emit("*", event, ...args);
|
|
49
51
|
}
|
|
50
52
|
/**
|
|
51
53
|
* Returns the number of listeners for the given event
|
package/package.json
CHANGED