events-ex 2.0.0-alpha.6 → 2.0.0-alpha.7

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [2.0.0-alpha.7](https://github.com/snowyu/events-ex.js/compare/v2.0.0-alpha.6...v2.0.0-alpha.7) (2024-03-20)
+
+
+### Features
+
+* The listener throw error should not broke the notification, but it will emit error after notification. ([7dce4f6](https://github.com/snowyu/events-ex.js/commit/7dce4f68c516a0169fa4f64f3a5c5277f0c2b743))
+
 ## [2.0.0-alpha.6](https://github.com/snowyu/events-ex.js/compare/v2.0.0-alpha.5...v2.0.0-alpha.6) (2024-03-15)
 
 ## [2.0.0-alpha.5](https://github.com/snowyu/events-ex.js/compare/v2.0.0-alpha.4...v2.0.0-alpha.5) (2024-03-15)

package/README.cn.md

@@ -40,6 +40,7 @@ TODO: 异步事件,添加`emitAsync`方法. 没这么简单,因为要支持bubbl
   * 添加了 `listenerCount()` 类方法，以保持与 Node 事件模块的兼容性。
   * 添加了`emitAsync`方法,支持异步事件
 
+注意: 时间内部引发错误不会中断通知，但是会在通知结束时 emit 错误事件(`emit('error', error, 'notify', listener, args)`)
 
 ### 安装
 

package/README.md

@@ -31,6 +31,7 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
   + Adds listenerCount() class method to keep compatibility with node events.
   * Adds async event emitting via `emitAsync` method.
 
+Note: The listener throw error should not broke the notification, but it will emit error(`emit('error', error, 'notify', listener, args)`) after notification.
 
 ### Installation
 

package/docs/README.md

@@ -32,6 +32,8 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
   + Adds listenerCount() class method to keep compatibility with node events.
   * Adds async event emitting via `emitAsync` method.
 
+Note: The listener throw error should not broke the notification, but it will emit error(`emit('error', error, 'notify', listener, args)`) after notification.
+
 ### Installation
 
 ```bash

package/docs/classes/event.Event.md

@@ -47,7 +47,7 @@ Event Object that contains information about the event, such as the target eleme
 
 #### Defined in
 
-[src/event.js:8](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event.js#L8)
+[src/event.js:8](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L8)
 
 ## Properties
 
@@ -59,7 +59,7 @@ Keep your event result here if any.
 
 #### Defined in
 
-[src/event.js:38](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event.js#L38)
+[src/event.js:38](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L38)
 
 ___
 
@@ -71,7 +71,7 @@ Whether stop the bubbling event
 
 #### Defined in
 
-[src/event.js:32](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event.js#L32)
+[src/event.js:32](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L32)
 
 ___
 
@@ -83,7 +83,7 @@ Who trigger the event
 
 #### Defined in
 
-[src/event.js:26](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event.js#L26)
+[src/event.js:26](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L26)
 
 ## Methods
 
@@ -101,7 +101,7 @@ The result of the event.
 
 #### Defined in
 
-[src/event.js:45](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event.js#L45)
+[src/event.js:45](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L45)
 
 ___
 
@@ -123,4 +123,4 @@ Initializes the event with the target object.
 
 #### Defined in
 
-[src/event.js:20](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event.js#L20)
+[src/event.js:20](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L20)

package/docs/classes/event_emitter-1.EventEmitter.md

@@ -26,4 +26,4 @@ Class that represents an event emitter.
 
 #### Defined in
 
-[src/event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.js#L7)
+[src/event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.js#L7)

package/docs/classes/event_emitter.EventEmitter.md

@@ -47,7 +47,7 @@ Class that represents an event emitter.
 
 #### Defined in
 
-[src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L7)
+[src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L7)
 
 ## Methods
 
@@ -72,7 +72,7 @@ The result of the event.
 
 #### Defined in
 
-[src/event-emitter.d.ts:38](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L38)
+[src/event-emitter.d.ts:38](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L38)
 
 ___
 
@@ -97,7 +97,7 @@ A promise that resolves with the result of the event.
 
 #### Defined in
 
-[src/event-emitter.d.ts:44](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L44)
+[src/event-emitter.d.ts:44](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L44)
 
 ___
 
@@ -121,7 +121,7 @@ Returns the count of listeners that are registered to listen for the specified e
 
 #### Defined in
 
-[src/event-emitter.d.ts:66](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L66)
+[src/event-emitter.d.ts:66](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L66)
 
 ___
 
@@ -145,7 +145,7 @@ Returns an array of functions that are registered to listen for the specified ev
 
 #### Defined in
 
-[src/event-emitter.d.ts:59](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L59)
+[src/event-emitter.d.ts:59](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L59)
 
 ___
 
@@ -174,7 +174,7 @@ If the listener is not a function.
 
 #### Defined in
 
-[src/event-emitter.d.ts:32](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L32)
+[src/event-emitter.d.ts:32](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L32)
 
 ___
 
@@ -203,7 +203,7 @@ If the listener is not a function.
 
 #### Defined in
 
-[src/event-emitter.d.ts:16](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L16)
+[src/event-emitter.d.ts:16](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L16)
 
 ___
 
@@ -232,7 +232,7 @@ If the listener is not a function.
 
 #### Defined in
 
-[src/event-emitter.d.ts:24](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L24)
+[src/event-emitter.d.ts:24](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L24)
 
 ___
 
@@ -256,7 +256,7 @@ Removes all listeners for a specific event or all events from an event emitter.
 
 #### Defined in
 
-[src/event-emitter.d.ts:51](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L51)
+[src/event-emitter.d.ts:51](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L51)
 
 ___
 
@@ -276,7 +276,7 @@ ___
 
 #### Defined in
 
-[src/event-emitter.d.ts:52](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L52)
+[src/event-emitter.d.ts:52](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L52)
 
 ___
 
@@ -297,4 +297,4 @@ ___
 
 #### Defined in
 
-[src/event-emitter.d.ts:67](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/event-emitter.d.ts#L67)
+[src/event-emitter.d.ts:67](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event-emitter.d.ts#L67)

package/docs/modules/all_off.md

@@ -41,4 +41,4 @@ Removes all listeners for a specific event or all events from an event emitter.
 
 #### Defined in
 
-[src/all-off.js:12](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/all-off.js#L12)
+[src/all-off.js:12](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/all-off.js#L12)

package/docs/modules/consts.md

@@ -25,4 +25,4 @@
 
 #### Defined in
 
-[src/consts.js:6](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/consts.js#L6)
+[src/consts.js:6](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/consts.js#L6)

package/docs/modules/default_methods.md

@@ -48,4 +48,4 @@ Renames and re-exports [getEventableMethods](default_methods.md#geteventablemeth
 
 #### Defined in
 
-[src/default-methods.js:8](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/default-methods.js#L8)
+[src/default-methods.js:8](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/default-methods.js#L8)

package/docs/modules/has_listeners.md

@@ -37,4 +37,4 @@ Renames and re-exports [hasListeners](has_listeners.md#haslisteners)
 
 #### Defined in
 
-[src/has-listeners.js:10](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/has-listeners.js#L10)
+[src/has-listeners.js:10](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/has-listeners.js#L10)

package/docs/modules/pipe.md

@@ -46,4 +46,4 @@ Creates a pipeline between two event emitters, so that any events emitted by the
 
 #### Defined in
 
-[src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/pipe.js#L21)
+[src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/pipe.js#L21)

package/docs/modules/pipe_async.md

@@ -46,4 +46,4 @@ Creates a pipeline between two event emitters, so that any events emitted by the
 
 #### Defined in
 
-[src/pipe-async.js:21](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/pipe-async.js#L21)
+[src/pipe-async.js:21](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/pipe-async.js#L21)

package/docs/modules/unify.md

@@ -43,4 +43,4 @@ Unifies the event listeners of two event emitter objects so that they share the
 
 #### Defined in
 
-[src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/unify.js#L17)
+[src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/unify.js#L17)

package/docs/modules/util_array_remove.md

@@ -36,4 +36,4 @@ Renames and re-exports [remove](util_array_remove.md#remove)
 
 #### Defined in
 
-[src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/util/array-remove.js#L5)
+[src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/util/array-remove.js#L5)

package/docs/modules/util_object_for_each.md

@@ -38,4 +38,4 @@ Renames and re-exports [forEach](util_object_for_each.md#foreach)
 
 #### Defined in
 
-[src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/util/object-for-each.js#L6)
+[src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/util/object-for-each.js#L6)

package/docs/modules/util_string_pad.md

@@ -37,4 +37,4 @@ Renames and re-exports [pad](util_string_pad.md#pad)
 
 #### Defined in
 
-[src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/util/string-pad.js#L8)
+[src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/util/string-pad.js#L8)

package/docs/modules/util_to_int.md

@@ -36,4 +36,4 @@ Renames and re-exports [toInt](util_to_int.md#toint)
 
 #### Defined in
 
-[src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/util/to-int.js#L2)
+[src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/util/to-int.js#L2)

package/docs/modules/util_valid_callable.md

@@ -36,4 +36,4 @@ Renames and re-exports [validCallable](util_valid_callable.md#validcallable)
 
 #### Defined in
 
-[src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/util/valid-callable.js#L1)
+[src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/util/valid-callable.js#L1)

package/docs/modules/util_valid_object.md

@@ -36,4 +36,4 @@ Renames and re-exports [validObject](util_valid_object.md#validobject)
 
 #### Defined in
 
-[src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/util/valid-object.js#L3)
+[src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/util/valid-object.js#L3)

package/docs/modules/wrap_event_emitter.md

@@ -30,7 +30,7 @@ Renames and re-exports [wrapEventEmitter](wrap_event_emitter.md#wrapeventemitter
 
 #### Defined in
 
-[src/wrap-event-emitter.js:6](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/wrap-event-emitter.js#L6)
+[src/wrap-event-emitter.js:6](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/wrap-event-emitter.js#L6)
 
 ## Functions
 
@@ -54,4 +54,4 @@ o or new Event instance
 
 #### Defined in
 
-[src/wrap-event-emitter.js:33](https://github.com/snowyu/events-ex.js/blob/e575b9f/src/wrap-event-emitter.js#L33)
+[src/wrap-event-emitter.js:33](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/wrap-event-emitter.js#L33)

package/lib/default-methods.js

@@ -95,16 +95,30 @@ function getEventableMethods(aClass) {
       const args = r.args;
       const listeners = r.listeners;
       const evt = (0, _event.Event)(this);
+      const errs = [];
       try {
         let i = 0;
         let listener;
         while (listener = listeners[i]) {
-          _notify(listener, evt, args);
-          if (evt.stopped) {
-            break;
+          try {
+            _notify(listener, evt, args);
+            if (evt.stopped) {
+              break;
+            }
+          } catch (err) {
+            errs.push({
+              err: err,
+              listener: listener
+            });
           }
           ++i;
         }
+        if (errs.length) {
+          for (let i = 0; i < errs.length; i++) {
+            const it = errs[i];
+            this.emit('error', it.err, 'notify', it.listener, args);
+          }
+        }
       } finally {
         // eslint-disable-next-line no-unsafe-finally
         return evt.end();
@@ -124,11 +138,25 @@ function getEventableMethods(aClass) {
       const args = r.args;
       const listeners = r.listeners;
       const evt = (0, _event.Event)(this);
+      const errs = [];
       try {
         for (const listener of listeners) {
-          await _notify(listener, evt, args);
-          if (evt.stopped) {
-            break;
+          try {
+            await _notify(listener, evt, args);
+            if (evt.stopped) {
+              break;
+            }
+          } catch (err) {
+            errs.push({
+              err: err,
+              listener: listener
+            });
+          }
+        }
+        if (errs.length) {
+          for (let i = 0; i < errs.length; i++) {
+            const it = errs[i];
+            this.emit('error', it.err, 'notify', it.listener, args);
           }
         }
       } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "events-ex",
-  "version": "2.0.0-alpha.6",
+  "version": "2.0.0-alpha.7",
   "description": "Browser-friendly enhanced events most compatible with standard node.js, it's powerful eventable ability.",
   "contributors": [
     {

package/src/default-methods.js

@@ -92,14 +92,25 @@ export function getEventableMethods(aClass) {
       const args = r.args
       const listeners = r.listeners
       const evt = Event(this)
+      const errs = []
       try {
         let i = 0
         let listener
         while (listener = listeners[i]){
-          _notify(listener, evt, args)
-          if (evt.stopped) {break}
+          try {
+            _notify(listener, evt, args)
+            if (evt.stopped) {break}
+          } catch(err) {
+            errs.push({err: err, listener: listener})
+          }
           ++i
         }
+        if (errs.length) {
+          for (let i=0;i<errs.length;i++) {
+            const it = errs[i]
+            this.emit('error', it.err, 'notify', it.listener, args)
+          }
+        }
       } finally {
         // eslint-disable-next-line no-unsafe-finally
         return evt.end()
@@ -117,10 +128,21 @@ export function getEventableMethods(aClass) {
       const args = r.args
       const listeners = r.listeners
       const evt = Event(this)
+      const errs = []
       try {
         for (const listener of listeners) {
-          await _notify(listener, evt, args);
-          if (evt.stopped) {break}
+          try {
+            await _notify(listener, evt, args);
+            if (evt.stopped) {break}
+          } catch(err) {
+            errs.push({err: err, listener: listener})
+          }
+        }
+        if (errs.length) {
+          for (let i=0;i<errs.length;i++) {
+            const it = errs[i]
+            this.emit('error', it.err, 'notify', it.listener, args)
+          }
         }
       } finally {
         // eslint-disable-next-line no-unsafe-finally