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.
Files changed (126) hide show
  1. package/.babelrc +1 -1
  2. package/CHANGELOG.md +25 -0
  3. package/README.cn.md +114 -3
  4. package/README.md +106 -5
  5. package/coverage/all-off.js.html +133 -0
  6. package/coverage/base.css +224 -0
  7. package/coverage/block-navigation.js +87 -0
  8. package/coverage/clover.xml +572 -0
  9. package/coverage/consts.js.html +154 -0
  10. package/coverage/default-methods.js.html +2068 -0
  11. package/coverage/event-emitter.js.html +121 -0
  12. package/coverage/event.js.html +286 -0
  13. package/coverage/eventable.js.html +355 -0
  14. package/coverage/favicon.png +0 -0
  15. package/coverage/has-listeners.js.html +166 -0
  16. package/coverage/index.html +281 -0
  17. package/coverage/lcov-report/all-off.js.html +133 -0
  18. package/coverage/lcov-report/base.css +224 -0
  19. package/coverage/lcov-report/block-navigation.js +87 -0
  20. package/coverage/lcov-report/consts.js.html +154 -0
  21. package/coverage/lcov-report/default-methods.js.html +2068 -0
  22. package/coverage/lcov-report/event-emitter.js.html +121 -0
  23. package/coverage/lcov-report/event.js.html +286 -0
  24. package/coverage/lcov-report/eventable.js.html +355 -0
  25. package/coverage/lcov-report/favicon.png +0 -0
  26. package/coverage/lcov-report/has-listeners.js.html +166 -0
  27. package/coverage/lcov-report/index.html +281 -0
  28. package/coverage/lcov-report/once-promise.js.html +325 -0
  29. package/coverage/lcov-report/pipe-async.js.html +385 -0
  30. package/coverage/lcov-report/pipe.js.html +244 -0
  31. package/coverage/lcov-report/prettify.css +1 -0
  32. package/coverage/lcov-report/prettify.js +2 -0
  33. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  34. package/coverage/lcov-report/sorter.js +210 -0
  35. package/coverage/lcov-report/unify.js.html +259 -0
  36. package/coverage/lcov-report/wrap-event-emitter.js.html +223 -0
  37. package/coverage/lcov.info +1201 -0
  38. package/coverage/once-promise.js.html +325 -0
  39. package/coverage/pipe-async.js.html +385 -0
  40. package/coverage/pipe.js.html +244 -0
  41. package/coverage/prettify.css +1 -0
  42. package/coverage/prettify.js +2 -0
  43. package/coverage/sort-arrow-sprite.png +0 -0
  44. package/coverage/sorter.js +210 -0
  45. package/coverage/unify.js.html +259 -0
  46. package/coverage/wrap-event-emitter.js.html +223 -0
  47. package/docs/README.md +106 -5
  48. package/docs/all-off/functions/allOff.md +1 -1
  49. package/docs/consts/README.md +4 -0
  50. package/docs/consts/functions/createAbortError.md +18 -0
  51. package/docs/consts/variables/RegExpEventSymbol.md +1 -1
  52. package/docs/consts/variables/states.md +2 -2
  53. package/docs/default-methods/functions/getEventableMethods.md +33 -17
  54. package/docs/event/classes/Event.md +23 -13
  55. package/docs/event-emitter/classes/EventEmitter-1.md +2 -2
  56. package/docs/event-emitter/classes/EventEmitter.md +28 -28
  57. package/docs/eventable/functions/eventable.md +1 -1
  58. package/docs/has-listeners/functions/hasListeners.md +2 -2
  59. package/docs/index/README.md +12 -0
  60. package/docs/modules.md +1 -0
  61. package/docs/once-promise/README.md +17 -0
  62. package/docs/once-promise/functions/oncePromise.md +60 -0
  63. package/docs/pipe/functions/pipe.md +3 -3
  64. package/docs/pipe-async/functions/pipeAsync.md +3 -3
  65. package/docs/unify/functions/unify.md +1 -1
  66. package/docs/util/array-remove/functions/remove.md +1 -1
  67. package/docs/util/object-for-each/functions/forEach.md +1 -1
  68. package/docs/util/string-pad/functions/pad.md +1 -1
  69. package/docs/util/to-int/functions/toInt.md +1 -1
  70. package/docs/util/valid-callable/functions/validCallable.md +1 -1
  71. package/docs/util/valid-object/functions/validObject.md +1 -1
  72. package/docs/wrap-event-emitter/functions/wrapEventEmitter.md +3 -3
  73. package/docs/wrap-event-emitter/variables/methods.md +1 -1
  74. package/lib/all-off.mjs +16 -0
  75. package/lib/consts.d.ts +7 -1
  76. package/lib/consts.js +17 -2
  77. package/lib/consts.mjs +23 -0
  78. package/lib/default-methods.d.ts +12 -4
  79. package/lib/default-methods.js +171 -19
  80. package/lib/default-methods.mjs +661 -0
  81. package/lib/event-emitter.mjs +12 -0
  82. package/lib/event.d.ts +10 -4
  83. package/lib/event.js +6 -0
  84. package/lib/event.mjs +67 -0
  85. package/lib/eventable.d.ts +1 -1
  86. package/lib/eventable.js +2 -2
  87. package/lib/eventable.mjs +90 -0
  88. package/lib/has-listeners.d.ts +1 -1
  89. package/lib/has-listeners.mjs +27 -0
  90. package/lib/index.d.ts +1 -0
  91. package/lib/index.js +12 -0
  92. package/lib/index.mjs +16 -0
  93. package/lib/once-promise.d.ts +23 -0
  94. package/lib/once-promise.js +82 -0
  95. package/lib/once-promise.mjs +80 -0
  96. package/lib/pipe-async.d.ts +4 -2
  97. package/lib/pipe-async.js +19 -6
  98. package/lib/pipe-async.mjs +100 -0
  99. package/lib/pipe.d.ts +1 -1
  100. package/lib/pipe.js +3 -3
  101. package/lib/pipe.mjs +53 -0
  102. package/lib/unify.js +1 -1
  103. package/lib/unify.mjs +58 -0
  104. package/lib/util/array-remove.mjs +16 -0
  105. package/lib/util/object-for-each.mjs +20 -0
  106. package/lib/util/promise-any.mjs +45 -0
  107. package/lib/util/string-pad.mjs +19 -0
  108. package/lib/util/to-int.mjs +9 -0
  109. package/lib/util/valid-callable.mjs +6 -0
  110. package/lib/util/valid-object.mjs +8 -0
  111. package/lib/wrap-event-emitter.d.ts +1 -1
  112. package/lib/wrap-event-emitter.mjs +46 -0
  113. package/package.json +29 -20
  114. package/scripts/copy-to-mjs.mjs +79 -0
  115. package/src/consts.js +10 -0
  116. package/src/default-methods.js +166 -21
  117. package/src/event.js +6 -0
  118. package/src/eventable.js +1 -1
  119. package/src/index.js +1 -0
  120. package/src/once-promise.js +80 -0
  121. package/src/pipe-async.js +17 -4
  122. package/src/pipe.js +1 -1
  123. package/src/unify.js +1 -1
  124. package/tsconfig.json +2 -1
  125. package/vitest.config.js +61 -0
  126. 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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L8)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L8)
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:38](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L38)
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:44](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L44)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L32)
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**: `any`
97
+ > **target**: `Object` \| `undefined`
88
98
 
89
- Defined in: [src/event.js:26](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L26)
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:50](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L50)
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:57](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L57)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L20)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.js#L8)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.js#L8)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L6)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L7)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L58)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L64)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L93)
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
- The name of the event to get the listeners for.
101
+ `string` \| `RegExp`
102
102
 
103
- `string` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L86)
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
- The name of the event to get the listeners for.
125
+ `string` \| `RegExp`
126
126
 
127
- `string` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L43)
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` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L21)
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` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L34)
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` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L71)
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
- The event to remove listeners for. If not provided, all listeners for all events will be removed.
269
+ `string` \| `RegExp`
270
270
 
271
- `string` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L52)
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` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L79)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L101)
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` | `RegExp`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/eventable.js#L89)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/has-listeners.js#L20)
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
- `any`
19
+ `Object`
20
20
 
21
21
  The object to check. Must not be null or undefined.
22
22
 
@@ -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
@@ -15,6 +15,7 @@
15
15
  - [eventable](eventable/README.md)
16
16
  - [has-listeners](has-listeners/README.md)
17
17
  - [index](index/README.md)
18
+ - [once-promise](once-promise/README.md)
18
19
  - [pipe](pipe/README.md)
19
20
  - [pipe-async](pipe-async/README.md)
20
21
  - [unify](unify/README.md)
@@ -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`): `any`
9
+ > **pipe**(`e1`, `e2`, ...`args`): `Object`
10
10
 
11
- Defined in: [src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/pipe.js#L21)
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
- `any`
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`): `any`
9
+ > **pipeAsync**(`e1`, `e2`, ...`args`): `Object`
10
10
 
11
- Defined in: [src/pipe-async.js:24](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/pipe-async.js#L24)
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
- `any`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/unify.js#L17)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/array-remove.js#L5)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/object-for-each.js#L6)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/string-pad.js#L8)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/to-int.js#L2)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/valid-callable.js#L1)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/valid-object.js#L3)
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/wrap-event-emitter.js#L37)
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
- `any`
19
+ `Object`
20
20
 
21
21
  the optional instance to eventable
22
22
 
23
23
  ### options?
24
24
 
25
- `any`
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/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/wrap-event-emitter.js#L7)
11
+ Defined in: [src/wrap-event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/4b0e5c2237202c2cc8b9e9244905d2c668799451/src/wrap-event-emitter.js#L7)
@@ -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;