events-ex 2.3.1 → 2.4.1
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/.babelrc +1 -1
- package/CHANGELOG.md +25 -0
- package/README.cn.md +114 -3
- package/README.md +106 -5
- package/coverage/all-off.js.html +133 -0
- package/coverage/base.css +224 -0
- package/coverage/block-navigation.js +87 -0
- package/coverage/clover.xml +572 -0
- package/coverage/consts.js.html +154 -0
- package/coverage/default-methods.js.html +2068 -0
- package/coverage/event-emitter.js.html +121 -0
- package/coverage/event.js.html +286 -0
- package/coverage/eventable.js.html +355 -0
- package/coverage/favicon.png +0 -0
- package/coverage/has-listeners.js.html +166 -0
- package/coverage/index.html +281 -0
- package/coverage/lcov-report/all-off.js.html +133 -0
- package/coverage/lcov-report/base.css +224 -0
- package/coverage/lcov-report/block-navigation.js +87 -0
- package/coverage/lcov-report/consts.js.html +154 -0
- package/coverage/lcov-report/default-methods.js.html +2068 -0
- package/coverage/lcov-report/event-emitter.js.html +121 -0
- package/coverage/lcov-report/event.js.html +286 -0
- package/coverage/lcov-report/eventable.js.html +355 -0
- package/coverage/lcov-report/favicon.png +0 -0
- package/coverage/lcov-report/has-listeners.js.html +166 -0
- package/coverage/lcov-report/index.html +281 -0
- package/coverage/lcov-report/once-promise.js.html +325 -0
- package/coverage/lcov-report/pipe-async.js.html +385 -0
- package/coverage/lcov-report/pipe.js.html +244 -0
- package/coverage/lcov-report/prettify.css +1 -0
- package/coverage/lcov-report/prettify.js +2 -0
- package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
- package/coverage/lcov-report/sorter.js +210 -0
- package/coverage/lcov-report/unify.js.html +259 -0
- package/coverage/lcov-report/wrap-event-emitter.js.html +223 -0
- package/coverage/lcov.info +1201 -0
- package/coverage/once-promise.js.html +325 -0
- package/coverage/pipe-async.js.html +385 -0
- package/coverage/pipe.js.html +244 -0
- package/coverage/prettify.css +1 -0
- package/coverage/prettify.js +2 -0
- package/coverage/sort-arrow-sprite.png +0 -0
- package/coverage/sorter.js +210 -0
- package/coverage/unify.js.html +259 -0
- package/coverage/wrap-event-emitter.js.html +223 -0
- package/docs/README.md +106 -5
- package/docs/all-off/functions/allOff.md +1 -1
- package/docs/consts/README.md +4 -0
- package/docs/consts/functions/createAbortError.md +18 -0
- package/docs/consts/variables/RegExpEventSymbol.md +1 -1
- package/docs/consts/variables/states.md +2 -2
- package/docs/default-methods/functions/getEventableMethods.md +33 -17
- package/docs/event/classes/Event.md +23 -13
- package/docs/event-emitter/classes/EventEmitter-1.md +2 -2
- package/docs/event-emitter/classes/EventEmitter.md +28 -28
- package/docs/eventable/functions/eventable.md +1 -1
- package/docs/has-listeners/functions/hasListeners.md +2 -2
- package/docs/index/README.md +12 -0
- package/docs/modules.md +1 -0
- package/docs/once-promise/README.md +17 -0
- package/docs/once-promise/functions/oncePromise.md +60 -0
- package/docs/pipe/functions/pipe.md +3 -3
- package/docs/pipe-async/functions/pipeAsync.md +3 -3
- package/docs/unify/functions/unify.md +1 -1
- package/docs/util/array-remove/functions/remove.md +1 -1
- package/docs/util/object-for-each/functions/forEach.md +1 -1
- package/docs/util/string-pad/functions/pad.md +1 -1
- package/docs/util/to-int/functions/toInt.md +1 -1
- package/docs/util/valid-callable/functions/validCallable.md +1 -1
- package/docs/util/valid-object/functions/validObject.md +1 -1
- package/docs/wrap-event-emitter/functions/wrapEventEmitter.md +3 -3
- package/docs/wrap-event-emitter/variables/methods.md +1 -1
- package/lib/all-off.mjs +16 -0
- package/lib/consts.d.ts +7 -1
- package/lib/consts.js +17 -2
- package/lib/consts.mjs +23 -0
- package/lib/default-methods.d.ts +12 -4
- package/lib/default-methods.js +171 -19
- package/lib/default-methods.mjs +661 -0
- package/lib/event-emitter.mjs +12 -0
- package/lib/event.d.ts +10 -4
- package/lib/event.js +6 -0
- package/lib/event.mjs +67 -0
- package/lib/eventable.d.ts +1 -1
- package/lib/eventable.js +2 -2
- package/lib/eventable.mjs +90 -0
- package/lib/has-listeners.d.ts +1 -1
- package/lib/has-listeners.mjs +27 -0
- package/lib/index.d.ts +1 -0
- package/lib/index.js +12 -0
- package/lib/index.mjs +16 -0
- package/lib/once-promise.d.ts +23 -0
- package/lib/once-promise.js +82 -0
- package/lib/once-promise.mjs +80 -0
- package/lib/pipe-async.d.ts +4 -2
- package/lib/pipe-async.js +19 -6
- package/lib/pipe-async.mjs +100 -0
- package/lib/pipe.d.ts +1 -1
- package/lib/pipe.js +3 -3
- package/lib/pipe.mjs +53 -0
- package/lib/unify.js +1 -1
- package/lib/unify.mjs +58 -0
- package/lib/util/array-remove.mjs +16 -0
- package/lib/util/object-for-each.mjs +20 -0
- package/lib/util/promise-any.mjs +45 -0
- package/lib/util/string-pad.mjs +19 -0
- package/lib/util/to-int.mjs +9 -0
- package/lib/util/valid-callable.mjs +6 -0
- package/lib/util/valid-object.mjs +8 -0
- package/lib/wrap-event-emitter.d.ts +1 -1
- package/lib/wrap-event-emitter.mjs +46 -0
- package/package.json +29 -20
- package/scripts/copy-to-mjs.mjs +79 -0
- package/src/consts.js +10 -0
- package/src/default-methods.js +166 -21
- package/src/event.js +6 -0
- package/src/eventable.js +1 -1
- package/src/index.js +1 -0
- package/src/once-promise.js +80 -0
- package/src/pipe-async.js +17 -4
- package/src/pipe.js +1 -1
- package/src/unify.js +1 -1
- package/tsconfig.json +2 -1
- package/vitest.config.js +61 -0
- package/.mocharc.yml +0 -3
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Class: Event
|
|
8
8
|
|
|
9
|
-
Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/
|
|
9
|
+
Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L8)
|
|
10
10
|
|
|
11
11
|
Creates a new Event object instance that contains information about the event, such as the target element and the return value of the event.
|
|
12
12
|
|
|
@@ -24,7 +24,7 @@ Who trigger the event
|
|
|
24
24
|
|
|
25
25
|
> **new Event**(`target`, `type`): `Event`
|
|
26
26
|
|
|
27
|
-
Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/
|
|
27
|
+
Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L8)
|
|
28
28
|
|
|
29
29
|
Creates a new Event object instance that contains information about the event, such as the target element and the return value of the event.
|
|
30
30
|
|
|
@@ -52,11 +52,21 @@ Event Object that contains information about the event, such as the target eleme
|
|
|
52
52
|
|
|
53
53
|
## Properties
|
|
54
54
|
|
|
55
|
+
### aborted
|
|
56
|
+
|
|
57
|
+
> **aborted**: `boolean` \| `undefined`
|
|
58
|
+
|
|
59
|
+
Defined in: [src/event.js:38](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L38)
|
|
60
|
+
|
|
61
|
+
Whether the event emission was aborted via AbortSignal.
|
|
62
|
+
|
|
63
|
+
***
|
|
64
|
+
|
|
55
65
|
### resolved
|
|
56
66
|
|
|
57
|
-
> **resolved**: `boolean`
|
|
67
|
+
> **resolved**: `boolean` \| `undefined`
|
|
58
68
|
|
|
59
|
-
Defined in: [src/event.js:
|
|
69
|
+
Defined in: [src/event.js:44](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L44)
|
|
60
70
|
|
|
61
71
|
Whether a result has been resolved (for 'first' result mode)
|
|
62
72
|
|
|
@@ -66,7 +76,7 @@ Whether a result has been resolved (for 'first' result mode)
|
|
|
66
76
|
|
|
67
77
|
> **result**: `any`
|
|
68
78
|
|
|
69
|
-
Defined in: [src/event.js:
|
|
79
|
+
Defined in: [src/event.js:50](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L50)
|
|
70
80
|
|
|
71
81
|
Keep your event result here if any.
|
|
72
82
|
|
|
@@ -74,9 +84,9 @@ Keep your event result here if any.
|
|
|
74
84
|
|
|
75
85
|
### stopped
|
|
76
86
|
|
|
77
|
-
> **stopped**: `boolean`
|
|
87
|
+
> **stopped**: `boolean` \| `undefined`
|
|
78
88
|
|
|
79
|
-
Defined in: [src/event.js:32](https://github.com/snowyu/events-ex.js/blob/
|
|
89
|
+
Defined in: [src/event.js:32](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L32)
|
|
80
90
|
|
|
81
91
|
Whether stop the bubbling event
|
|
82
92
|
|
|
@@ -84,9 +94,9 @@ Whether stop the bubbling event
|
|
|
84
94
|
|
|
85
95
|
### target
|
|
86
96
|
|
|
87
|
-
> **target**: `
|
|
97
|
+
> **target**: `Object` \| `undefined`
|
|
88
98
|
|
|
89
|
-
Defined in: [src/event.js:26](https://github.com/snowyu/events-ex.js/blob/
|
|
99
|
+
Defined in: [src/event.js:26](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L26)
|
|
90
100
|
|
|
91
101
|
Who trigger the event
|
|
92
102
|
|
|
@@ -94,9 +104,9 @@ Who trigger the event
|
|
|
94
104
|
|
|
95
105
|
### type
|
|
96
106
|
|
|
97
|
-
> **type**: `string`
|
|
107
|
+
> **type**: `string` \| `undefined`
|
|
98
108
|
|
|
99
|
-
Defined in: [src/event.js:
|
|
109
|
+
Defined in: [src/event.js:56](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L56)
|
|
100
110
|
|
|
101
111
|
The type of the event.
|
|
102
112
|
|
|
@@ -106,7 +116,7 @@ The type of the event.
|
|
|
106
116
|
|
|
107
117
|
> **end**(): `any`
|
|
108
118
|
|
|
109
|
-
Defined in: [src/event.js:
|
|
119
|
+
Defined in: [src/event.js:63](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L63)
|
|
110
120
|
|
|
111
121
|
Ends the event and returns the result.
|
|
112
122
|
|
|
@@ -122,7 +132,7 @@ The result of the event.
|
|
|
122
132
|
|
|
123
133
|
> **init**(`target`, `type`): `void`
|
|
124
134
|
|
|
125
|
-
Defined in: [src/event.js:20](https://github.com/snowyu/events-ex.js/blob/
|
|
135
|
+
Defined in: [src/event.js:20](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event.js#L20)
|
|
126
136
|
|
|
127
137
|
Initializes the event with the target object.
|
|
128
138
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Class: EventEmitter
|
|
8
8
|
|
|
9
|
-
Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/
|
|
9
|
+
Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.js#L8)
|
|
10
10
|
|
|
11
11
|
## Classdesc
|
|
12
12
|
|
|
@@ -18,7 +18,7 @@ Class that represents an event emitter.
|
|
|
18
18
|
|
|
19
19
|
> **new EventEmitter**(): `EventEmitter`
|
|
20
20
|
|
|
21
|
-
Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/
|
|
21
|
+
Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.js#L8)
|
|
22
22
|
|
|
23
23
|
#### Returns
|
|
24
24
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Class: EventEmitter
|
|
8
8
|
|
|
9
|
-
Defined in: [src/event-emitter.d.ts:6](https://github.com/snowyu/events-ex.js/blob/
|
|
9
|
+
Defined in: [src/event-emitter.d.ts:6](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L6)
|
|
10
10
|
|
|
11
11
|
Class that represents an event emitter.
|
|
12
12
|
|
|
@@ -26,7 +26,7 @@ Class that represents an event emitter.
|
|
|
26
26
|
|
|
27
27
|
> `static` **defaultMaxListeners**: `number`
|
|
28
28
|
|
|
29
|
-
Defined in: [src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/
|
|
29
|
+
Defined in: [src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L7)
|
|
30
30
|
|
|
31
31
|
## Methods
|
|
32
32
|
|
|
@@ -34,7 +34,7 @@ Defined in: [src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/bl
|
|
|
34
34
|
|
|
35
35
|
> **emit**(`eventName`, ...`args`): `any`
|
|
36
36
|
|
|
37
|
-
Defined in: [src/event-emitter.d.ts:58](https://github.com/snowyu/events-ex.js/blob/
|
|
37
|
+
Defined in: [src/event-emitter.d.ts:58](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L58)
|
|
38
38
|
|
|
39
39
|
Emits the specified event type with the given arguments.
|
|
40
40
|
|
|
@@ -62,7 +62,7 @@ The result of the event.
|
|
|
62
62
|
|
|
63
63
|
> **emitAsync**(`eventName`, ...`args`): `Promise`\<`any`\>
|
|
64
64
|
|
|
65
|
-
Defined in: [src/event-emitter.d.ts:64](https://github.com/snowyu/events-ex.js/blob/
|
|
65
|
+
Defined in: [src/event-emitter.d.ts:64](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L64)
|
|
66
66
|
|
|
67
67
|
Asynchronously emits the specified event type with the given arguments.
|
|
68
68
|
|
|
@@ -90,7 +90,7 @@ A promise that resolves with the result of the event.
|
|
|
90
90
|
|
|
91
91
|
> **listenerCount**(`eventName`): `number`
|
|
92
92
|
|
|
93
|
-
Defined in: [src/event-emitter.d.ts:93](https://github.com/snowyu/events-ex.js/blob/
|
|
93
|
+
Defined in: [src/event-emitter.d.ts:93](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L93)
|
|
94
94
|
|
|
95
95
|
Returns the count of listeners that are registered to listen for the specified event.
|
|
96
96
|
|
|
@@ -98,9 +98,9 @@ Returns the count of listeners that are registered to listen for the specified e
|
|
|
98
98
|
|
|
99
99
|
##### eventName
|
|
100
100
|
|
|
101
|
-
|
|
101
|
+
`string` \| `RegExp`
|
|
102
102
|
|
|
103
|
-
|
|
103
|
+
The name of the event to get the listeners for.
|
|
104
104
|
|
|
105
105
|
#### Returns
|
|
106
106
|
|
|
@@ -114,7 +114,7 @@ The name of the event to get the listeners for.
|
|
|
114
114
|
|
|
115
115
|
> **listeners**(`eventName`): `Function`[]
|
|
116
116
|
|
|
117
|
-
Defined in: [src/event-emitter.d.ts:86](https://github.com/snowyu/events-ex.js/blob/
|
|
117
|
+
Defined in: [src/event-emitter.d.ts:86](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L86)
|
|
118
118
|
|
|
119
119
|
Returns an array of functions that are registered to listen for the specified event.
|
|
120
120
|
|
|
@@ -122,9 +122,9 @@ Returns an array of functions that are registered to listen for the specified ev
|
|
|
122
122
|
|
|
123
123
|
##### eventName
|
|
124
124
|
|
|
125
|
-
|
|
125
|
+
`string` \| `RegExp`
|
|
126
126
|
|
|
127
|
-
|
|
127
|
+
The name of the event to get the listeners for.
|
|
128
128
|
|
|
129
129
|
#### Returns
|
|
130
130
|
|
|
@@ -138,7 +138,7 @@ The name of the event to get the listeners for.
|
|
|
138
138
|
|
|
139
139
|
> **off**(`eventName`, `listener`): `EventEmitter`
|
|
140
140
|
|
|
141
|
-
Defined in: [src/event-emitter.d.ts:43](https://github.com/snowyu/events-ex.js/blob/
|
|
141
|
+
Defined in: [src/event-emitter.d.ts:43](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L43)
|
|
142
142
|
|
|
143
143
|
Removes a listener function from the specified event type.
|
|
144
144
|
|
|
@@ -146,7 +146,7 @@ Removes a listener function from the specified event type.
|
|
|
146
146
|
|
|
147
147
|
##### eventName
|
|
148
148
|
|
|
149
|
-
`string`
|
|
149
|
+
`string` \| `RegExp`
|
|
150
150
|
|
|
151
151
|
##### listener
|
|
152
152
|
|
|
@@ -174,7 +174,7 @@ If the listener is not a function.
|
|
|
174
174
|
|
|
175
175
|
> **on**(`eventName`, `listener`, `index?`): `EventEmitter`
|
|
176
176
|
|
|
177
|
-
Defined in: [src/event-emitter.d.ts:21](https://github.com/snowyu/events-ex.js/blob/
|
|
177
|
+
Defined in: [src/event-emitter.d.ts:21](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L21)
|
|
178
178
|
|
|
179
179
|
Adds a listener function to the specified event type.
|
|
180
180
|
|
|
@@ -182,7 +182,7 @@ Adds a listener function to the specified event type.
|
|
|
182
182
|
|
|
183
183
|
##### eventName
|
|
184
184
|
|
|
185
|
-
`string`
|
|
185
|
+
`string` \| `RegExp`
|
|
186
186
|
|
|
187
187
|
##### listener
|
|
188
188
|
|
|
@@ -192,14 +192,14 @@ The listener function to be called when the event is emitted.
|
|
|
192
192
|
|
|
193
193
|
##### index?
|
|
194
194
|
|
|
195
|
+
`number` \| `"first"` \| `"last"`
|
|
196
|
+
|
|
195
197
|
The index at which to insert the listener.
|
|
196
198
|
- 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
|
|
197
199
|
- 'last' or Infinity: adds to the end of the listeners (stay at the back).
|
|
198
200
|
- number: inserts at the specified index within the normal listeners zone.
|
|
199
201
|
If not specified, the listener will be added at the end of the normal listeners.
|
|
200
202
|
|
|
201
|
-
`number` | `"first"` | `"last"`
|
|
202
|
-
|
|
203
203
|
#### Returns
|
|
204
204
|
|
|
205
205
|
`EventEmitter`
|
|
@@ -216,7 +216,7 @@ If the listener is not a function.
|
|
|
216
216
|
|
|
217
217
|
> **once**(`eventName`, `listener`, `index?`): `EventEmitter`
|
|
218
218
|
|
|
219
|
-
Defined in: [src/event-emitter.d.ts:34](https://github.com/snowyu/events-ex.js/blob/
|
|
219
|
+
Defined in: [src/event-emitter.d.ts:34](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L34)
|
|
220
220
|
|
|
221
221
|
Adds a one-time listener function to the specified event type.
|
|
222
222
|
|
|
@@ -224,7 +224,7 @@ Adds a one-time listener function to the specified event type.
|
|
|
224
224
|
|
|
225
225
|
##### eventName
|
|
226
226
|
|
|
227
|
-
`string`
|
|
227
|
+
`string` \| `RegExp`
|
|
228
228
|
|
|
229
229
|
##### listener
|
|
230
230
|
|
|
@@ -234,14 +234,14 @@ The listener function to be called once when the event is emitted.
|
|
|
234
234
|
|
|
235
235
|
##### index?
|
|
236
236
|
|
|
237
|
+
`number` \| `"first"` \| `"last"`
|
|
238
|
+
|
|
237
239
|
The index at which to insert the listener.
|
|
238
240
|
- 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
|
|
239
241
|
- 'last' or Infinity: adds to the end of the listeners (stay at the back).
|
|
240
242
|
- number: inserts at the specified index within the normal listeners zone.
|
|
241
243
|
If not specified, the listener will be added at the end of the normal listeners.
|
|
242
244
|
|
|
243
|
-
`number` | `"first"` | `"last"`
|
|
244
|
-
|
|
245
245
|
#### Returns
|
|
246
246
|
|
|
247
247
|
`EventEmitter`
|
|
@@ -258,7 +258,7 @@ If the listener is not a function.
|
|
|
258
258
|
|
|
259
259
|
> **removeAllListeners**(`eventName?`): `EventEmitter`
|
|
260
260
|
|
|
261
|
-
Defined in: [src/event-emitter.d.ts:71](https://github.com/snowyu/events-ex.js/blob/
|
|
261
|
+
Defined in: [src/event-emitter.d.ts:71](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L71)
|
|
262
262
|
|
|
263
263
|
Removes all listeners for a specific event or all events from an event emitter.
|
|
264
264
|
|
|
@@ -266,9 +266,9 @@ Removes all listeners for a specific event or all events from an event emitter.
|
|
|
266
266
|
|
|
267
267
|
##### eventName?
|
|
268
268
|
|
|
269
|
-
|
|
269
|
+
`string` \| `RegExp`
|
|
270
270
|
|
|
271
|
-
|
|
271
|
+
The event to remove listeners for. If not provided, all listeners for all events will be removed.
|
|
272
272
|
|
|
273
273
|
#### Returns
|
|
274
274
|
|
|
@@ -282,7 +282,7 @@ The event to remove listeners for. If not provided, all listeners for all events
|
|
|
282
282
|
|
|
283
283
|
> **removeListener**(`eventName`, `listener`): `EventEmitter`
|
|
284
284
|
|
|
285
|
-
Defined in: [src/event-emitter.d.ts:52](https://github.com/snowyu/events-ex.js/blob/
|
|
285
|
+
Defined in: [src/event-emitter.d.ts:52](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L52)
|
|
286
286
|
|
|
287
287
|
Removes a listener function from the specified event type.
|
|
288
288
|
|
|
@@ -290,7 +290,7 @@ Removes a listener function from the specified event type.
|
|
|
290
290
|
|
|
291
291
|
##### eventName
|
|
292
292
|
|
|
293
|
-
`string`
|
|
293
|
+
`string` \| `RegExp`
|
|
294
294
|
|
|
295
295
|
##### listener
|
|
296
296
|
|
|
@@ -318,7 +318,7 @@ If the listener is not a function.
|
|
|
318
318
|
|
|
319
319
|
> **setMaxListeners**(`n`): `EventEmitter`
|
|
320
320
|
|
|
321
|
-
Defined in: [src/event-emitter.d.ts:79](https://github.com/snowyu/events-ex.js/blob/
|
|
321
|
+
Defined in: [src/event-emitter.d.ts:79](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L79)
|
|
322
322
|
|
|
323
323
|
Sets the maximum number of listeners allowed for the event emitter.
|
|
324
324
|
|
|
@@ -346,7 +346,7 @@ If `n` is not a positive integer.
|
|
|
346
346
|
|
|
347
347
|
> `static` **listenerCount**(`emitter`, `eventName`): `number`
|
|
348
348
|
|
|
349
|
-
Defined in: [src/event-emitter.d.ts:101](https://github.com/snowyu/events-ex.js/blob/
|
|
349
|
+
Defined in: [src/event-emitter.d.ts:101](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/event-emitter.d.ts#L101)
|
|
350
350
|
|
|
351
351
|
Returns the count of listeners that are registered to listen for the specified event.
|
|
352
352
|
|
|
@@ -358,7 +358,7 @@ Returns the count of listeners that are registered to listen for the specified e
|
|
|
358
358
|
|
|
359
359
|
##### eventName
|
|
360
360
|
|
|
361
|
-
`string`
|
|
361
|
+
`string` \| `RegExp`
|
|
362
362
|
|
|
363
363
|
#### Returns
|
|
364
364
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **eventable**\<`T`\>(`targetClass?`, `options?`): `EnhancedClass`\<`T`, (`aClass?`) => `Function`\>
|
|
10
10
|
|
|
11
|
-
Defined in: [src/eventable.js:89](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/eventable.js:89](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/eventable.js#L89)
|
|
12
12
|
|
|
13
13
|
Adds event-emitting capabilities to a class by injecting necessary methods and properties.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **hasListeners**(`obj`, `type?`): `boolean`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/has-listeners.js:20](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/has-listeners.js:20](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/has-listeners.js#L20)
|
|
12
12
|
|
|
13
13
|
Checks if an object has event listeners.
|
|
14
14
|
|
|
@@ -16,7 +16,7 @@ Checks if an object has event listeners.
|
|
|
16
16
|
|
|
17
17
|
### obj
|
|
18
18
|
|
|
19
|
-
`
|
|
19
|
+
`Object`
|
|
20
20
|
|
|
21
21
|
The object to check. Must not be null or undefined.
|
|
22
22
|
|
package/docs/index/README.md
CHANGED
|
@@ -14,6 +14,12 @@ Re-exports [allOff](../all-off/functions/allOff.md)
|
|
|
14
14
|
|
|
15
15
|
***
|
|
16
16
|
|
|
17
|
+
### createAbortError
|
|
18
|
+
|
|
19
|
+
Re-exports [createAbortError](../consts/functions/createAbortError.md)
|
|
20
|
+
|
|
21
|
+
***
|
|
22
|
+
|
|
17
23
|
### default
|
|
18
24
|
|
|
19
25
|
Renames and re-exports [EventEmitter](../event-emitter/classes/EventEmitter.md)
|
|
@@ -50,6 +56,12 @@ Re-exports [methods](../wrap-event-emitter/variables/methods.md)
|
|
|
50
56
|
|
|
51
57
|
***
|
|
52
58
|
|
|
59
|
+
### oncePromise
|
|
60
|
+
|
|
61
|
+
Re-exports [oncePromise](../once-promise/functions/oncePromise.md)
|
|
62
|
+
|
|
63
|
+
***
|
|
64
|
+
|
|
53
65
|
### pipe
|
|
54
66
|
|
|
55
67
|
Re-exports [pipe](../pipe/functions/pipe.md)
|
package/docs/modules.md
CHANGED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
[**events-ex**](../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[events-ex](../modules.md) / once-promise
|
|
6
|
+
|
|
7
|
+
# once-promise
|
|
8
|
+
|
|
9
|
+
## Functions
|
|
10
|
+
|
|
11
|
+
- [oncePromise](functions/oncePromise.md)
|
|
12
|
+
|
|
13
|
+
## References
|
|
14
|
+
|
|
15
|
+
### default
|
|
16
|
+
|
|
17
|
+
Renames and re-exports [oncePromise](functions/oncePromise.md)
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
[**events-ex**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[events-ex](../../modules.md) / [once-promise](../README.md) / oncePromise
|
|
6
|
+
|
|
7
|
+
# Function: oncePromise()
|
|
8
|
+
|
|
9
|
+
> **oncePromise**(`emitter`, `type`, `options?`): `Promise`\<[`Event`](../../event/classes/Event.md)\>
|
|
10
|
+
|
|
11
|
+
Defined in: [src/once-promise.js:23](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/once-promise.js#L23)
|
|
12
|
+
|
|
13
|
+
Returns a Promise that resolves with the Event object when the specified event is emitted on the given emitter.
|
|
14
|
+
If an 'error' event is emitted (and the waiting event is not 'error'), the promise rejects by default.
|
|
15
|
+
If the provided AbortSignal is aborted, the promise rejects with an AbortError.
|
|
16
|
+
|
|
17
|
+
Note: The resolved Event object's `result` field may not be the final value if other listeners have not yet run.
|
|
18
|
+
For the definitive emit return value, use `emit()` or `emitAsync()` directly.
|
|
19
|
+
|
|
20
|
+
## Parameters
|
|
21
|
+
|
|
22
|
+
### emitter
|
|
23
|
+
|
|
24
|
+
[`EventEmitter`](../../event-emitter/classes/EventEmitter.md)
|
|
25
|
+
|
|
26
|
+
The event emitter to listen on.
|
|
27
|
+
|
|
28
|
+
### type
|
|
29
|
+
|
|
30
|
+
`string` \| `RegExp`
|
|
31
|
+
|
|
32
|
+
The event type to wait for.
|
|
33
|
+
|
|
34
|
+
### options?
|
|
35
|
+
|
|
36
|
+
Optional configuration.
|
|
37
|
+
|
|
38
|
+
#### raiseError?
|
|
39
|
+
|
|
40
|
+
`boolean` \| `null`
|
|
41
|
+
|
|
42
|
+
Controls behavior when an 'error' event is emitted:
|
|
43
|
+
- `true` / `undefined` (default): The promise rejects with the error.
|
|
44
|
+
- `false`: The promise resolves with the error object instead of rejecting.
|
|
45
|
+
|
|
46
|
+
#### signal?
|
|
47
|
+
|
|
48
|
+
`any`
|
|
49
|
+
|
|
50
|
+
An AbortSignal to cancel the wait.
|
|
51
|
+
|
|
52
|
+
## Returns
|
|
53
|
+
|
|
54
|
+
`Promise`\<[`Event`](../../event/classes/Event.md)\>
|
|
55
|
+
|
|
56
|
+
- A promise that resolves with the Event object.
|
|
57
|
+
|
|
58
|
+
## Throws
|
|
59
|
+
|
|
60
|
+
- If emitter is not a valid event emitter object.
|
|
@@ -6,9 +6,9 @@
|
|
|
6
6
|
|
|
7
7
|
# Function: pipe()
|
|
8
8
|
|
|
9
|
-
> **pipe**(`e1`, `e2`, ...`args`): `
|
|
9
|
+
> **pipe**(`e1`, `e2`, ...`args`): `Object`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/pipe.js#L21)
|
|
12
12
|
|
|
13
13
|
Creates a pipeline between two event emitters, so that any events emitted by the first emitter are also emitted by the second emitter.
|
|
14
14
|
|
|
@@ -32,7 +32,7 @@ The second event emitter.
|
|
|
32
32
|
|
|
33
33
|
## Returns
|
|
34
34
|
|
|
35
|
-
`
|
|
35
|
+
`Object`
|
|
36
36
|
|
|
37
37
|
- An object with a `close` method that removes the pipeline between the two event emitters.
|
|
38
38
|
|
|
@@ -6,9 +6,9 @@
|
|
|
6
6
|
|
|
7
7
|
# Function: pipeAsync()
|
|
8
8
|
|
|
9
|
-
> **pipeAsync**(`e1`, `e2`, ...`args`): `
|
|
9
|
+
> **pipeAsync**(`e1`, `e2`, ...`args`): `Object`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/pipe-async.js:
|
|
11
|
+
Defined in: [src/pipe-async.js:26](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/pipe-async.js#L26)
|
|
12
12
|
|
|
13
13
|
Creates a pipeline between two event emitters, so that any events emitted by the first emitter are also emitted by the second emitter.
|
|
14
14
|
|
|
@@ -32,7 +32,7 @@ The second event emitter.
|
|
|
32
32
|
|
|
33
33
|
## Returns
|
|
34
34
|
|
|
35
|
-
`
|
|
35
|
+
`Object`
|
|
36
36
|
|
|
37
37
|
- An object with a `close` method that removes the pipeline between the two event emitters.
|
|
38
38
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **unify**(`e1`, `e2`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/unify.js#L17)
|
|
12
12
|
|
|
13
13
|
Unifies the event listeners of two event emitter objects so that they share the same set of listeners for each event.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **remove**(...`args`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/util/array-remove.js#L5)
|
|
12
12
|
|
|
13
13
|
## Parameters
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **forEach**(`obj`, `cb`, ...`args`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/util/object-for-each.js#L6)
|
|
12
12
|
|
|
13
13
|
## Parameters
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **pad**(`fill`, ...`args`): `string`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/util/string-pad.js#L8)
|
|
12
12
|
|
|
13
13
|
## Parameters
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **toInt**(`value`): `any`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/util/to-int.js#L2)
|
|
12
12
|
|
|
13
13
|
## Parameters
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **validCallable**(`fn`): `any`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/util/valid-callable.js#L1)
|
|
12
12
|
|
|
13
13
|
## Parameters
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **validObject**(`value`): `any`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/util/valid-object.js#L3)
|
|
12
12
|
|
|
13
13
|
## Parameters
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **wrapEventEmitter**(`o?`, `options?`): `any`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/wrap-event-emitter.js:37](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/wrap-event-emitter.js:37](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/wrap-event-emitter.js#L37)
|
|
12
12
|
|
|
13
13
|
Create or inject the eventable instance into the object
|
|
14
14
|
|
|
@@ -16,13 +16,13 @@ Create or inject the eventable instance into the object
|
|
|
16
16
|
|
|
17
17
|
### o?
|
|
18
18
|
|
|
19
|
-
`
|
|
19
|
+
`Object`
|
|
20
20
|
|
|
21
21
|
the optional instance to eventable
|
|
22
22
|
|
|
23
23
|
### options?
|
|
24
24
|
|
|
25
|
-
`
|
|
25
|
+
`Object`
|
|
26
26
|
|
|
27
27
|
optional configuration for the emitter
|
|
28
28
|
|
|
@@ -8,4 +8,4 @@
|
|
|
8
8
|
|
|
9
9
|
> `const` **methods**: `any`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/wrap-event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/
|
|
11
|
+
Defined in: [src/wrap-event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/wrap-event-emitter.js#L7)
|
package/lib/all-off.mjs
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import eventable from './eventable.mjs'
|
|
2
|
+
|
|
3
|
+
const removeAllListeners = eventable().methods.removeAllListeners;
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Removes all listeners for a specific event or all events from an event emitter.
|
|
7
|
+
*
|
|
8
|
+
* @param {import('./event-emitter').EventEmitter} emitter - The event emitter to remove listeners from.
|
|
9
|
+
* @param {string} [type] - The event to remove listeners for. If not provided, all listeners for all events will be removed.
|
|
10
|
+
* @returns {import('./event-emitter').EventEmitter} - The event emitter with all listeners removed.
|
|
11
|
+
*/
|
|
12
|
+
export function allOff(emitter, type) {
|
|
13
|
+
return removeAllListeners.call(emitter, type);
|
|
14
|
+
};
|
|
15
|
+
|
|
16
|
+
export default allOff;
|