events-ex 2.3.0 → 2.4.0

package/.babelrc

@@ -1,6 +1,6 @@
 {
   "plugins": [
-    ["@babel/plugin-proposal-dynamic-import"],
+    ["@babel/plugin-transform-dynamic-import"],
     ["@babel/plugin-transform-modules-commonjs", {
       "allowTopLevelThis": true,
       // "importInterop": "node",

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 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.4.0](https://github.com/snowyu/events-ex.js/compare/v2.3.1...v2.4.0) (2026-07-07)
+
+
+### Features
+
+* add AbortSignal support for async event emission ([ca3e851](https://github.com/snowyu/events-ex.js/commit/ca3e8519ec6c87de8e0ab0ef824b63b2abb1d391))
+* add oncePromise to convert event into Promise ([fe80487](https://github.com/snowyu/events-ex.js/commit/fe8048727b78365569cedc7d4aa9b71bfb01d715))
+* add raiseError option for error handling control ([d26b490](https://github.com/snowyu/events-ex.js/commit/d26b4907a6217095b9de61e0f698145fe9e2b7c6))
+* update esm support ([d26bdae](https://github.com/snowyu/events-ex.js/commit/d26bdae527dff2296ff52d0d7b94d37c9f694683))
+
+
+### Bug Fixes
+
+* **build:** strictly mjs import and chagnes ([1738d9b](https://github.com/snowyu/events-ex.js/commit/1738d9bce8d1eae4826213336afe3c0c8e5fa482))
+* emitAsync error-in-error propagation and error re-emission ([94f2e0f](https://github.com/snowyu/events-ex.js/commit/94f2e0f8f24029fcbc1455eee2a0f0fe299f10de))
+* **pipe-async:** default resultMode to 'last' to align with emitAsync ([a54de61](https://github.com/snowyu/events-ex.js/commit/a54de6103fb895e9096c764ea481fcc03e62f7aa))
+* prevent infinite recursion when error listener throws ([a52cebb](https://github.com/snowyu/events-ex.js/commit/a52cebb0771acddb2940a8e4d8868b4e0e5d7b04))
+
+## [2.3.1](https://github.com/snowyu/events-ex.js/compare/v2.3.0...v2.3.1) (2026-04-17)
+
+
+### Performance
+
+* minor optimition for index ([f6c4415](https://github.com/snowyu/events-ex.js/commit/f6c44157ffda17957fad5ad2e0aedbb8ec521be7))
+
 ## [2.3.0](https://github.com/snowyu/events-ex.js/compare/v2.2.0...v2.3.0) (2026-04-17)
 
 

package/README.cn.md

@@ -14,8 +14,9 @@
   * **可配置的并发性**：异步监听器支持 **顺序(Serial)**（默认）和 **并发(Parallel)** 执行。
   * **结果聚合策略**：支持多种收集返回值的方式：`last`（默认）、`first`（首个成功结果）和 `collect`（所有结果）。
   * **Fluent API 代理**：通过 `.parallel()` 和 `.configure()` 提供无副作用的临时执行上下文。
+  * **AbortSignal 支持**：通过 `configure({ signal })` 支持取消异步事件发射，也可用于 `oncePromise`。
 * **架构优势**：重写核心以提升性能与灵活性，同时保持广泛的兼容性。
-* **事件工具集**：内置支持 `pipe`, `pipeAsync`, `unify`, `allOff` 和 `hasListeners`。
+* **事件工具集**：内置支持 `pipe`, `pipeAsync`, `oncePromise`, `unify`, `allOff` 和 `hasListeners`。
 
 ### 区别
 
@@ -24,6 +25,7 @@
     * 事件对象(`Event Object`)作为监听器的 "this" 对象。
       * `result` 属性: 可选, 如果设置,则将该结果返回到事件发射器(`Event Emitter`)。
       * `stopped` 属性: 可选, 如果设置为 `true`，则会阻止剩余的监听器被执行。
+      * `aborted` 属性: (仅异步) `true` 表示事件发射被 `AbortSignal` 取消。
       * `target`属性: 事件发射器对象,原本的`this`
       * `type`属性: 触发的事件类型名称
       * `resolved`: (仅异步) 在 `first` 模式下，标识是否已找到成功的结果。
@@ -39,7 +41,7 @@
       * `collect`: 按注册顺序以数组形式返回所有结果。
   * **流式配置**: 使用 `.parallel()` 或 `.configure({...})` 进行单次定制化异步发射。
   * **事件监听器 API**: `on/once(event: string|RegExp, listener, index?: number|'first'|'last')`
-    * 📌 **Index 参数** (可选): 在监听器数组中指定插入位置。 
+    * 📌 **Index 参数** (可选): 在监听器数组中指定插入位置。
       * `'first'` (`-Infinity`): 始终保持在 **Head** 区。先注册的 `'first'` 监听器排在最前面。
       * `'last'` (`Infinity`): 始终保持在 **Tail** 区。先注册为 `'last'` 的监听器将始终位于数组的绝对末尾。
       * `number`: 常规 **Body** 区内的相对索引。
@@ -54,6 +56,13 @@
   * 添加了 `listenerCount()` 类方法，以保持与 Node 事件模块的兼容性。
   * 添加了`emitAsync`等方法,支持异步事件
 
+* 🔗 **事件管道与统一**：
+  * `pipe(source, target)`: 同步事件转发。
+  * `pipeAsync(source, target, options)`: 异步转发，支持可配置的并发性与聚合。
+  * `unify(emitter1, emitter2)`: 双向事件同步。
+
+> 注意：监听器抛出的错误不会打断通知流程——捕获到的错误会在所有监听器执行完毕后，以 `'error'` 事件形式重新触发。**例外**：如果错误是在 `'error'` 事件监听器内部抛出的，它会直接作为异常（同步）或 Promise rejection（异步）向外传播而非再次触发，以**避免无限递归/栈溢出**。此机制同时适用于 `emit()` 和 `emitAsync()`。
+
 ---
 
 ### 用法
@@ -140,6 +149,44 @@ const allResults = await ee.parallel('collect').emitAsync('task');
 const firstResult = await ee.parallel('first').emitAsync('task');
 ```
 
+#### AbortSignal 支持（仅针对异步）
+
+通过 `configure({ signal })` 或 `oncePromise` 的 `options` 参数支持标准的 `AbortSignal`，可取消异步事件发射。
+
+```js
+const emitter = new EventEmitter();
+const controller = new AbortController();
+
+emitter.on('task', async () => {
+  await sleep(500);
+  return '完成';
+});
+
+// emitAsync: 通过 configure 传递 signal
+setTimeout(() => controller.abort(), 200); // 200ms 后取消
+try {
+  await emitter.configure({ signal: controller.signal }).emitAsync('task');
+} catch (err) {
+  console.log(err.name); // 'AbortError'
+}
+
+// oncePromise: 通过 options 直接传递 signal
+const c2 = new AbortController();
+setTimeout(() => c2.abort(), 100);
+try {
+  await oncePromise(emitter, 'ready', { signal: c2.signal });
+} catch (err) {
+  console.log(err.name); // 'AbortError'
+}
+```
+
+**行为说明**：
+
+- **串行模式 (Serial)**：每个 listener 执行前检查 `signal.aborted`，触发则立即中断并抛出 `AbortError`。当显式设置了 `raiseError`（`true`/`false`/`null`）时，还会通过 `Promise.race` 打断**正在执行**的 listener。
+- **并发模式 (Parallel)**：用 `Promise.race` 将 listener 执行与 signal 竞速，signal 触发立即抛出 `AbortError`。
+- **pipeAsync**：串行模式下，向每个 pipe target 转发前检查 source 的 signal，已 abort 则跳过后续 targets。
+- `Event` 对象新增 `aborted` 字段，独立于 `stopped`，用于追踪取消状态。
+
 ### 高级特性
 
 #### 异步并发引擎 (仅针对 `emitAsync`)
@@ -151,6 +198,11 @@ const firstResult = await ee.parallel('first').emitAsync('task');
 | **`resultMode`** | `'last'` | **(默认)** 返回最后一个监听器的结果（并发模式下为最后一个完成的）。 |
 | | `'first'` | 返回第一个 **非 undefined** 且 **成功** 的结果。自动跳过错误。 |
 | | `'collect'` | 按注册顺序以数组形式返回所有监听器的结果。 |
+| **`signal`** | `AbortSignal` | 通过 `AbortController` 创建的信号，用于取消异步事件发射。仅在 `configure()` 中传递，不会固化到实例上。 |
+| **`raiseError`** | `true` | 立即抛出所有监听器错误。并发模式下多个错误会聚合为 `AggregateError`。 |
+| | `false` | 静默吞掉监听器错误。与 `signal` 配合时可在串行模式下打断正在执行的监听器（启用 `Promise.race`）。 |
+| | `null` | **(同步 `emit` 默认值)** 仅针对 `error` 事件：无 error 监听器时抛出（Node.js 默认行为）。 |
+| | `undefined` | **(默认值)** 对 `emitAsync` 等同于 `false`。保持现有行为不变。 |
 
 #### 代理隔离 (Fluent API)
 
@@ -204,9 +256,68 @@ eventable(MyClass, {
 
 创建异步管道。支持配置传播模式和结果聚合策略。
 
+- `options.asyncMode`: 传播模式 (`'serial' | 'parallel'`)。
+- `options.resultMode`: 结果聚合策略（`'last'` 默认 | `'first'` | `'collect'`）。
+
+#### oncePromise(emitter, type[, options]) _(events-ex/once-promise)_
+
+返回一个 `Promise`，当指定事件在 emitter 上触发时，resolve 并传入 **Event 对象**。
+如果 emitter 触发了 `error` 事件（且等待的事件不是 `error`），则 Promise reject。
+如果提供的 `AbortSignal` 被取消，则 Promise reject 并抛出 `AbortError`。
+
+- `emitter` _(EventEmitter)_: 要监听的事件发射器。
+- `type` _(string | RegExp)_: 要等待的事件类型。支持正则表达式匹配多个事件。
+- `options` _(Object)_: 可选配置。
+  - `signal` _(AbortSignal)_: 用于取消等待的 AbortSignal。
+  - `raiseError` _(boolean|null)_: 控制当 emitter 触发 `'error'` 事件时的行为。
+    - `true` / `undefined` **（默认）**: Promise reject 并传入错误对象。
+    - `false`: Promise resolve 并传入错误对象，而非 reject。
+- 返回: `Promise<Event>` — resolve 时传入 Event 对象，包含 `type`、`target` 等属性。
+
+> 注意：返回的 Event 对象中的 `result` 字段可能不是最终值（如果还有其他监听器尚未执行）。如需获取 emit 的最终返回值，请直接使用 `emit()` 或 `emitAsync()`。
+
+```js
+import {oncePromise, EventEmitter} from 'events-ex';
+
+const ee = new EventEmitter();
+
+// 等待 data 事件
+setTimeout(() => ee.emit('data', { id: 1 }), 100);
+const evt = await oncePromise(ee, 'data');
+console.log(evt.type);   // 'data'
+console.log(evt.target); // 发射器对象
+
+// 等待正则匹配的事件 – evt.type 会告诉你实际触发的事件类型
+setTimeout(() => ee.emit('user.login', { name: 'Alice' }), 100);
+const evt2 = await oncePromise(ee, /^user\./);
+console.log(evt2.type); // 'user.login' (而非正则表达式)
+
+// 错误处理：触发 error 时会 reject（除非等待的就是 'error'）
+try {
+  await oncePromise(ee, 'data');
+} catch (err) {
+  console.error('发生错误:', err);
+}
+
+// 等待 'error' 事件会正常 resolve
+ee.emit('error', new Error('预期的错误'));
+await oncePromise(ee, 'error'); // 正常 resolve，不会 reject
+
+// 配合 AbortSignal 实现超时取消
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 5000);
+try {
+  const evt = await oncePromise(ee, 'response', { signal: controller.signal });
+} catch (err) {
+  if (err.name === 'AbortError') {
+    console.log('等待超时或被取消');
+  }
+}
+```
+
 #### setEmitterOptions(options)
 
-配置实例级的默认选项。
+配置实例级的默认选项，包括 `asyncMode`、`resultMode`、`maxListeners` 和 `raiseError`。
 
 [event-emitter]: https://github.com/medikoo/event-emitter
 [Ability]: https://github.com/snowyu/custom-ability.js

package/README.md

@@ -14,8 +14,9 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
   * **Configurable Concurrency**: Choose between **Serial** (default) and **Parallel** execution for async listeners.
   * **Result Aggregation**: Strategies to gather return values: `last` (default), `first` (first success), and `collect` (all results).
   * **Fluent API Proxies**: Use `.parallel()` and `.configure()` for transient, side-effect-free execution context.
+  * **AbortSignal Support**: Cancel async event emissions via `configure({ signal })` or `oncePromise` with an `AbortSignal`.
 * **Architecture**: Rewritten core for improved performance and flexibility while maintaining broad compatibility.
-* **Event Utilities**: Built-in support for `pipe`, `pipeAsync`, `unify`, `allOff`, and `hasListeners`.
+* **Event Utilities**: Built-in support for `pipe`, `pipeAsync`, `oncePromise`, `unify`, `allOff`, and `hasListeners`.
 
 ### Differences
 
@@ -24,6 +25,7 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
     + the `event object` as listener's "this" object:
       * `result`: If set, the result is returned to the `Event Emitter`.
       * `stopped`: If set to `true`, it prevents the remaining listeners from being executed.
+      * `aborted`: (Async only) `true` if the emission was cancelled by an `AbortSignal`.
       * `target`: The `Event Emitter` object, which was originally the `this` object.
       * `type`: triggered event type(name).
       * `resolved`: (Async only) Indicates if a successful result has been found in `first` mode.
@@ -39,7 +41,7 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
       * `collect`: Returns an array of all results in registration order.
   * **Fluent Configuration**: Use `.parallel()` or `.configure({...})` for one-time customized async emits.
   * **Listener APIs**: `on/once(event: string|RegExp, listener, index?: number|'first'|'last')`
-    * 📌 **Index Parameter** (Optional): Insertion position in the listener array. 
+    * 📌 **Index Parameter** (Optional): Insertion position in the listener array.
       * `'first'` (`-Infinity`): Stays in the **Head** zone. The first listener added as `'first'` is placed at the very front.
       * `'last'` (`Infinity`): Stays in the **Tail** zone. The first listener added as `'last'` will always remain at the absolute end.
       * `number`: Relative index within the **Body** zone.
@@ -59,7 +61,7 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
   * `pipeAsync(source, target, options)`: Async forwarding with configurable concurrency and aggregation.
   * `unify(emitter1, emitter2)`: Bi-directional synchronization.
 
-Note: The listener throw error should not broke the notification, but it will emit error(`emit('error', error, 'notify', eventName, listener, args)`) after notification.
+Note: A listener's throw error does not break the notification flow—caught errors are collected and then re-emitted as an `'error'` event after all listeners run. **Exception**: If the error is thrown inside an `'error'` event listener itself, it propagates directly as a thrown exception (sync) or a rejected promise (async), preventing infinite recursion / stack overflow. This applies to both `emit()` and `emitAsync()`.
 
 ### Installation
 
@@ -170,6 +172,44 @@ const allResults = await ee.parallel('collect').emitAsync('task');
 const firstResult = await ee.parallel('first').emitAsync('task');
 ```
 
+#### AbortSignal Support (Async Only)
+
+Cancel async event emissions using the standard `AbortSignal` via `configure({ signal })` or `oncePromise` options.
+
+```js
+const emitter = new EventEmitter();
+const controller = new AbortController();
+
+emitter.on('task', async () => {
+  await sleep(500);
+  return 'done';
+});
+
+// emitAsync: pass signal via configure
+setTimeout(() => controller.abort(), 200); // cancel after 200ms
+try {
+  await emitter.configure({ signal: controller.signal }).emitAsync('task');
+} catch (err) {
+  console.log(err.name); // 'AbortError'
+}
+
+// oncePromise: pass signal directly via options
+const c2 = new AbortController();
+setTimeout(() => c2.abort(), 100);
+try {
+  await oncePromise(emitter, 'ready', { signal: c2.signal });
+} catch (err) {
+  console.log(err.name); // 'AbortError'
+}
+```
+
+**Behavior**:
+
+- **Serial mode**: Checks `signal.aborted` before each listener, throws `AbortError` immediately when triggered. When `raiseError` is explicitly set (`true`/`false`/`null`), uses `Promise.race` to interrupt an actively running listener as well.
+- **Parallel mode**: Races listener execution against the signal via `Promise.race`. Throws `AbortError` when the signal wins.
+- **pipeAsync**: In serial mode, checks the source's signal before forwarding to each pipe target; skips remaining targets if aborted.
+- `Event` objects have an `aborted` field (independent of `stopped`) to track cancellation state.
+
 ### Advanced Features
 
 #### Async Concurrency Engine (For `emitAsync` Only)
@@ -181,6 +221,11 @@ const firstResult = await ee.parallel('first').emitAsync('task');
 | **`resultMode`** | `'last'` | **(Default)** Returns the result of the last listener (or last to finish). |
 | | `'first'` | Returns the first **non-undefined** and **successful** result. Skips errors. |
 | | `'collect'` | Returns an array of all results in registration order. |
+| **`signal`** | `AbortSignal` | An `AbortSignal` from an `AbortController` to cancel async event emission. Only passed via `configure()`, not stored on the instance. |
+| **`raiseError`** | `true` | Throws all listener errors immediately. Parallel mode aggregates multiple errors into an `AggregateError`. |
+| | `false` | Silently swallows listener errors. Used with `signal` to interrupt an executing listener in serial mode (added `Promise.race`). |
+| | `null` | **(Default for sync `emit`)** For `'error'` events only: throws if there are no error listeners (Node.js default behavior). |
+| | `undefined` | **(Default)** Same as `false` for `emitAsync`. Keeps existing behavior unchanged. |
 
 #### Proxy Isolation (Fluent API)
 
@@ -248,11 +293,67 @@ hasListeners(emitter, 'foo'); // true
 Creates an asynchronous pipeline.
 
 - `options.asyncMode`: Propagation mode (`'serial' | 'parallel'`).
-- `options.resultMode`: Aggregation strategy.
+- `options.resultMode`: Aggregation strategy (`'last'` default | `'first'` | `'collect'`).
+
+#### oncePromise(emitter, type[, options]) _(events-ex/once-promise)_
+
+Returns a `Promise` that resolves with the **Event object** when the specified event is emitted on the given emitter.
+If an `error` event is emitted (and the waiting event is not `error`), the promise rejects.
+If the provided `AbortSignal` is aborted, the promise rejects with an `AbortError`.
+
+- `emitter` _(EventEmitter)_: The event emitter to listen on.
+- `type` _(string | RegExp)_: The event type to wait for. Supports regex for matching multiple events.
+- `options` _(Object)_: Optional configuration.
+  - `signal` _(AbortSignal)_: An AbortSignal to cancel the wait.
+  - `raiseError` _(boolean|null)_: Controls behavior when an `'error'` event is emitted on the emitter.
+    - `true` / `undefined` **(default)**: The promise rejects with the error.
+    - `false`: The promise resolves with the error object instead of rejecting.
+- Returns: `Promise<Event>` — resolves with the Event object, which provides `type`, `target`, etc.
+
+> Note: The resolved Event object's `result` field may not be the final value if other listeners have not yet run. For the definitive emit return value, use `emit()` or `emitAsync()` directly.
+
+```js
+import {oncePromise, EventEmitter} from 'events-ex';
+
+const ee = new EventEmitter();
+
+// Wait for a data event
+setTimeout(() => ee.emit('data', { id: 1 }), 100);
+const evt = await oncePromise(ee, 'data');
+console.log(evt.type);   // 'data'
+console.log(evt.target); // the emitter
+
+// Wait for a regex-matched event – evt.type reveals the actual event
+setTimeout(() => ee.emit('user.login', { name: 'Alice' }), 100);
+const evt2 = await oncePromise(ee, /^user\./);
+console.log(evt2.type); // 'user.login' (not the regex)
+
+// Error handling: rejects on error (unless waiting for 'error')
+try {
+  await oncePromise(ee, 'data');
+} catch (err) {
+  console.error('Error occurred:', err);
+}
+
+// Waiting for 'error' event resolves normally
+ee.emit('error', new Error('expected'));
+await oncePromise(ee, 'error'); // resolves, not rejects
+
+// Use AbortSignal for timeout cancellation
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 5000);
+try {
+  const evt = await oncePromise(ee, 'response', { signal: controller.signal });
+} catch (err) {
+  if (err.name === 'AbortError') {
+    console.log('timed out or cancelled');
+  }
+}
+```
 
 #### setEmitterOptions(options)
 
-Configures instance-wide defaults for `asyncMode`, `resultMode`, and `maxListeners`.
+Configures instance-wide defaults for `asyncMode`, `resultMode`, `maxListeners`, and `raiseError`.
 
 [event-emitter]: https://github.com/medikoo/event-emitter
 [Ability]: https://github.com/snowyu/custom-ability.js

package/coverage/all-off.js.html

@@ -0,0 +1,133 @@
+
+<!doctype html>
+<html lang="en">
+
+<head>
+    <title>Code coverage report for all-off.js</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="prettify.css" />
+    <link rel="stylesheet" href="base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+    
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="index.html">All files</a> all-off.js</h1>
+        <div class='clearfix'>
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>2/2</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/0</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>1/1</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>2/2</span>
+            </div>
+        
+            
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">21x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import eventable from './eventable'
+&nbsp;
+const removeAllListeners = eventable().methods.removeAllListeners;
+&nbsp;
+/**
+ * Removes all listeners for a specific event or all events from an event emitter.
+ *
+ * @param {import('./event-emitter').EventEmitter} emitter - The event emitter to remove listeners from.
+ * @param {string} [type] - The event to remove listeners for. If not provided, all listeners for all events will be removed.
+ * @returns {import('./event-emitter').EventEmitter} - The event emitter with all listeners removed.
+ */
+export function allOff(emitter, type) {
+  return removeAllListeners.call(emitter, type);
+};
+&nbsp;
+export default allOff;
+&nbsp;</pre></td></tr></table></pre>
+
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-07-07T07:31:06.609Z
+            </div>
+        <script src="prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="sorter.js"></script>
+        <script src="block-navigation.js"></script>
+    </body>
+</html>
+