@lijuhong1981/jsevents 1.2.12 → 1.2.14

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2022-2026 lijuhong1981
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,11 +1,22 @@
-# `@lijuhong1981/jsevents`
-
-> TODO: description
-
-## Usage
-
-```
-const jsevents = require('@lijuhong1981/jsevents');
-
-// TODO: DEMONSTRATE API
-```
+# @lijuhong1981/jsevents
+
+> 事件系统，提供 `EventDispatcher`（事件分发）、`EventEmitter`（发布/订阅）与 `EventSubscriber`（事件封装），均支持 `Destroyable` 销毁。
+
+## 安装
+
+```bash
+npm install @lijuhong1981/jsevents
+```
+
+## 导出
+
+- `EventDispatcher` — 事件分发管理器（`addEventListener`/`removeEventListener`/`dispatch`/`dispatchEvent` 等）
+- `EventEmitter` — 发布/订阅模式
+- `EventSubscriber` — 单类型事件的监听器封装
+
+监听选项 `options`：
+
+| 项 | 说明 |
+| --- | --- |
+| `scope` | 回调函数的 `this` 指针对象 |
+| `once` | 是否单次事件（触发后自动移除） |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lijuhong1981/jsevents",
-  "version": "1.2.12",
-  "description": "> TODO: description",
+  "version": "1.2.14",
+  "description": "Event system with EventDispatcher, EventEmitter and EventSubscriber.",
   "author": "lijuhong1981 <lijuhong@hotmail.com>",
   "homepage": "https://github.com/lijuhong1981/jslibs#readme",
   "license": "ISC",
@@ -19,8 +19,8 @@
     "url": "https://github.com/lijuhong1981/jslibs/issues"
   },
   "dependencies": {
-    "@lijuhong1981/jscheck": "^1.1.6",
-    "@lijuhong1981/jsdestroy": "^1.2.6"
+    "@lijuhong1981/jscheck": "^1.1.8",
+    "@lijuhong1981/jsdestroy": "^1.2.8"
   },
-  "gitHead": "0aa8a09a9c5bc3ad3fd3710892adf1efb223e5a6"
+  "gitHead": "5d4bd57b654be98c46364160070d5dd11600afa6"
 }

package/src/EventDispatcher.js

@@ -33,6 +33,10 @@ function removeListener(events, type, callback) {
     if (event) {
         if (callback) {
             event.removeEventListener(callback);
+            if (event.numberOfListeners === 0) {
+                events.delete(type);
+                event.destroy();
+            }
         } else {
             events.delete(type);
             event.destroy();
@@ -147,7 +151,7 @@ class EventDispatcher extends Destroyable {
 
         const event = this._events.get(type);
 
-        return event && event.numberOfListeners > 0;
+        return !!(event && event.numberOfListeners > 0);
     }
 
     /**

package/src/EventSubscriber.js

@@ -2,8 +2,8 @@ import Check from "@lijuhong1981/jscheck/src/Check.js";
 import Destroyable from "@lijuhong1981/jsdestroy/src/Destroyable.js";
 
 /**
- * A generic utility class for managing subscribers for a particular event. This class is usually instantiated inside of a container class and exposed as a property for others to subscribe to.
- * 
+ * 用于管理某个事件的订阅者的通用工具类。该类通常在容器类内部实例化，并作为属性暴露给其他对象以进行订阅。
+ *
  * @class EventSubscriber
  * @extends Destroyable
 */
@@ -134,11 +134,11 @@ class EventSubscriber extends Destroyable {
      * @returns {this}
      */
     raiseEvent(...args) {
-        const listeners = this._listenersMap.values();
+        const listeners = Array.from(this._listenersMap.values());
         for (const listener of listeners) {
             const options = listener.options;
             const callback = listener.callback;
-            callback.apply(options.scope, arguments);
+            callback.apply(options.scope, args);
             if (options.once) {
                 this._listenersMap.delete(callback);
             }