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

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.9](https://github.com/snowyu/events-ex.js/compare/v2.0.0-alpha.8...v2.0.0-alpha.9) (2024-03-26)
+
+
+### Features
+
+* add type(event) to Event(this) for listener ([42b35e7](https://github.com/snowyu/events-ex.js/commit/42b35e75bf224b79d3b967469a7beb4f5aa120d1))
+
+## [2.0.0-alpha.8](https://github.com/snowyu/events-ex.js/compare/v2.0.0-alpha.7...v2.0.0-alpha.8) (2024-03-20)
+
+
+### Features
+
+* add eventName to the notify error event ([da3be72](https://github.com/snowyu/events-ex.js/commit/da3be7238689da19589e4d3a104d57b749d8a771))
+
 ## [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)
 
 

package/README.cn.md

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

package/README.md

@@ -31,7 +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.
+Note: The listener throw error should not broke the notification, but it will emit error(`emit('error', error, 'notify', eventName, listener, args)`) after notification.
 
 ### Installation
 

package/docs/README.md

@@ -32,7 +32,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.
+Note: The listener throw error should not broke the notification, but it will emit error(`emit('error', error, 'notify', eventName, listener, args)`) after notification.
 
 ### Installation
 

package/docs/classes/event.Event.md

@@ -15,6 +15,7 @@
 - [result](event.Event.md#result)
 - [stopped](event.Event.md#stopped)
 - [target](event.Event.md#target)
+- [type](event.Event.md#type)
 
 ### Methods
 
@@ -25,7 +26,7 @@
 
 ### constructor
 
-• **new Event**(`target`): [`Event`](event.Event.md)
+• **new Event**(`target`, `type`): [`Event`](event.Event.md)
 
 Creates a new Event object instance that contains information about the event, such as the target element and the return value of the event.
 
@@ -34,6 +35,7 @@ Creates a new Event object instance that contains information about the event, s
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `target` | [`EventEmitter`](event_emitter.EventEmitter.md) | Who trigger the event |
+| `type` | `any` | - |
 
 #### Returns
 
@@ -47,7 +49,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/7dce4f6/src/event.js#L8)
+[src/event.js:8](https://github.com/snowyu/events-ex.js/blob/42b35e7/src/event.js#L8)
 
 ## Properties
 
@@ -59,7 +61,7 @@ Keep your event result here if any.
 
 #### Defined in
 
-[src/event.js:38](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L38)
+[src/event.js:38](https://github.com/snowyu/events-ex.js/blob/42b35e7/src/event.js#L38)
 
 ___
 
@@ -71,7 +73,7 @@ Whether stop the bubbling event
 
 #### Defined in
 
-[src/event.js:32](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L32)
+[src/event.js:32](https://github.com/snowyu/events-ex.js/blob/42b35e7/src/event.js#L32)
 
 ___
 
@@ -83,7 +85,17 @@ Who trigger the event
 
 #### Defined in
 
-[src/event.js:26](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L26)
+[src/event.js:26](https://github.com/snowyu/events-ex.js/blob/42b35e7/src/event.js#L26)
+
+___
+
+### type
+
+• **type**: `any`
+
+#### Defined in
+
+[src/event.js:44](https://github.com/snowyu/events-ex.js/blob/42b35e7/src/event.js#L44)
 
 ## Methods
 
@@ -101,13 +113,13 @@ The result of the event.
 
 #### Defined in
 
-[src/event.js:45](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L45)
+[src/event.js:51](https://github.com/snowyu/events-ex.js/blob/42b35e7/src/event.js#L51)
 
 ___
 
 ### init
 
-▸ **init**(`target`): `void`
+▸ **init**(`target`, `type`): `void`
 
 Initializes the event with the target object.
 
@@ -116,6 +128,7 @@ Initializes the event with the target object.
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `target` | [`EventEmitter`](event_emitter.EventEmitter.md) | The target object for the event. |
+| `type` | `any` | - |
 
 #### Returns
 
@@ -123,4 +136,4 @@ Initializes the event with the target object.
 
 #### Defined in
 
-[src/event.js:20](https://github.com/snowyu/events-ex.js/blob/7dce4f6/src/event.js#L20)
+[src/event.js:20](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.js#L7)
+[src/event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L7)
+[src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L38)
+[src/event-emitter.d.ts:38](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L44)
+[src/event-emitter.d.ts:44](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L66)
+[src/event-emitter.d.ts:66](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L59)
+[src/event-emitter.d.ts:59](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L32)
+[src/event-emitter.d.ts:32](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L16)
+[src/event-emitter.d.ts:16](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L24)
+[src/event-emitter.d.ts:24](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L51)
+[src/event-emitter.d.ts:51](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L52)
+[src/event-emitter.d.ts:52](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/event-emitter.d.ts#L67)
+[src/event-emitter.d.ts:67](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/all-off.js#L12)
+[src/all-off.js:12](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/consts.js#L6)
+[src/consts.js:6](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/default-methods.js#L8)
+[src/default-methods.js:8](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/has-listeners.js#L10)
+[src/has-listeners.js:10](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/pipe.js#L21)
+[src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/pipe-async.js#L21)
+[src/pipe-async.js:21](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/unify.js#L17)
+[src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/util/array-remove.js#L5)
+[src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/util/object-for-each.js#L6)
+[src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/util/string-pad.js#L8)
+[src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/util/to-int.js#L2)
+[src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/util/valid-callable.js#L1)
+[src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/util/valid-object.js#L3)
+[src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/wrap-event-emitter.js#L6)
+[src/wrap-event-emitter.js:6](https://github.com/snowyu/events-ex.js/blob/42b35e7/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/7dce4f6/src/wrap-event-emitter.js#L33)
+[src/wrap-event-emitter.js:33](https://github.com/snowyu/events-ex.js/blob/42b35e7/src/wrap-event-emitter.js#L33)

package/lib/default-methods.js

@@ -94,7 +94,7 @@ function getEventableMethods(aClass) {
       }
       const args = r.args;
       const listeners = r.listeners;
-      const evt = (0, _event.Event)(this);
+      const evt = (0, _event.Event)(this, r.type);
       const errs = [];
       try {
         let i = 0;
@@ -116,7 +116,7 @@ function getEventableMethods(aClass) {
         if (errs.length) {
           for (let i = 0; i < errs.length; i++) {
             const it = errs[i];
-            this.emit('error', it.err, 'notify', it.listener, args);
+            this.emit('error', it.err, 'notify', r.type, it.listener, args);
           }
         }
       } finally {
@@ -137,7 +137,7 @@ function getEventableMethods(aClass) {
       }
       const args = r.args;
       const listeners = r.listeners;
-      const evt = (0, _event.Event)(this);
+      const evt = (0, _event.Event)(this, r.type);
       const errs = [];
       try {
         for (const listener of listeners) {
@@ -156,7 +156,7 @@ function getEventableMethods(aClass) {
         if (errs.length) {
           for (let i = 0; i < errs.length; i++) {
             const it = errs[i];
-            this.emit('error', it.err, 'notify', it.listener, args);
+            this.emit('error', it.err, 'notify', r.type, it.listener, args);
           }
         }
       } finally {
@@ -329,6 +329,7 @@ function _emit(type, msg) {
     listeners = listeners.slice();
   }
   return {
+    type,
     args,
     listeners
   };

package/lib/event.d.ts

@@ -5,7 +5,7 @@
  * @param {import('./event-emitter').EventEmitter} target - Who trigger the event
  * @returns {Event} - The new Event instance.
  */
-export function Event(target: import('./event-emitter').EventEmitter): Event;
+export function Event(target: import('./event-emitter').EventEmitter, type: any): Event;
 export class Event {
     /**
      * Creates a new Event object instance that contains information about the event, such as the target element and the return value of the event.
@@ -14,12 +14,12 @@ export class Event {
      * @param {import('./event-emitter').EventEmitter} target - Who trigger the event
      * @returns {Event} - The new Event instance.
      */
-    constructor(target: import('./event-emitter').EventEmitter);
+    constructor(target: import('./event-emitter').EventEmitter, type: any);
     /**
      * Initializes the event with the target object.
      * @param {import('./event-emitter').EventEmitter} target - The target object for the event.
      */
-    init(target: import('./event-emitter').EventEmitter): void;
+    init(target: import('./event-emitter').EventEmitter, type: any): void;
     /**
      * Who trigger the event
      * @type {Object}
@@ -38,6 +38,7 @@ export class Event {
      * @public
      */
     public result: any;
+    type: any;
     /**
      * Ends the event and returns the result.
      * @returns {*} The result of the event.

package/lib/event.js

@@ -12,19 +12,19 @@ exports.default = void 0;
  * @param {import('./event-emitter').EventEmitter} target - Who trigger the event
  * @returns {Event} - The new Event instance.
  */
-function Event(target) {
+function Event(target, type) {
   if (!(this instanceof Event)) {
-    const evt = new Event(target);
+    const evt = new Event(target, type);
     return evt;
   }
-  this.init(target);
+  this.init(target, type);
 }
 
 /**
  * Initializes the event with the target object.
  * @param {import('./event-emitter').EventEmitter} target - The target object for the event.
  */
-Event.prototype.init = function (target) {
+Event.prototype.init = function (target, type) {
   /**
    * Who trigger the event
    * @type {Object}
@@ -43,6 +43,12 @@ Event.prototype.init = function (target) {
    * @public
    */
   this.result = undefined;
+  /**
+   * The type of the event.
+   * @type {string}
+   * @public
+   */
+  if (type) this.type = type;
 };
 
 /**

package/package.json

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

package/src/default-methods.js

@@ -91,7 +91,7 @@ export function getEventableMethods(aClass) {
       if (!r) {return}
       const args = r.args
       const listeners = r.listeners
-      const evt = Event(this)
+      const evt = Event(this, r.type)
       const errs = []
       try {
         let i = 0
@@ -108,7 +108,7 @@ export function getEventableMethods(aClass) {
         if (errs.length) {
           for (let i=0;i<errs.length;i++) {
             const it = errs[i]
-            this.emit('error', it.err, 'notify', it.listener, args)
+            this.emit('error', it.err, 'notify', r.type, it.listener, args)
           }
         }
       } finally {
@@ -127,7 +127,7 @@ export function getEventableMethods(aClass) {
       if (!r) {return}
       const args = r.args
       const listeners = r.listeners
-      const evt = Event(this)
+      const evt = Event(this, r.type)
       const errs = []
       try {
         for (const listener of listeners) {
@@ -141,7 +141,7 @@ export function getEventableMethods(aClass) {
         if (errs.length) {
           for (let i=0;i<errs.length;i++) {
             const it = errs[i]
-            this.emit('error', it.err, 'notify', it.listener, args)
+            this.emit('error', it.err, 'notify', r.type, it.listener, args)
           }
         }
       } finally {
@@ -295,7 +295,7 @@ function _emit(type, msg) {
   } else {
     listeners = listeners.slice()
   }
-  return {args, listeners}
+  return {type, args, listeners}
 }
 
 function _notify(listener, evt, args) {

package/src/event.js

@@ -5,19 +5,19 @@
  * @param {import('./event-emitter').EventEmitter} target - Who trigger the event
  * @returns {Event} - The new Event instance.
  */
-export function Event(target) {
+export function Event(target, type) {
   if (!(this instanceof Event)) {
-    const evt = new Event(target)
+    const evt = new Event(target, type)
     return evt
   }
-  this.init(target)
+  this.init(target, type)
 }
 
 /**
  * Initializes the event with the target object.
  * @param {import('./event-emitter').EventEmitter} target - The target object for the event.
  */
-Event.prototype.init = function(target) {
+Event.prototype.init = function(target, type) {
   /**
    * Who trigger the event
    * @type {Object}
@@ -36,6 +36,12 @@ Event.prototype.init = function(target) {
    * @public
    */
   this.result = undefined
+  /**
+   * The type of the event.
+   * @type {string}
+   * @public
+   */
+  if (type) this.type = type;
 }
 
 /**