Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: change eventName type annotations #17666

Closed
wants to merge 2 commits into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions doc/api/events.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ added and `'removeListener'` when existing listeners are removed.
added: v0.1.26
-->

* `eventName` {any} The name of the event being listened for
* `eventName` {string|symbol} The name of the event being listened for
* `listener` {Function} The event handler function

The `EventEmitter` instance will emit its own `'newListener'` event *before*
Expand Down Expand Up @@ -219,7 +219,7 @@ changes:
now yields the original listener function.
-->

* `eventName` {any} The event name
* `eventName` {string|symbol} The event name
* `listener` {Function} The event handler function

The `'removeListener'` event is emitted *after* the `listener` is removed.
Expand Down Expand Up @@ -287,7 +287,7 @@ Its `name` property is set to `'MaxListenersExceededWarning'`.
<!-- YAML
added: v0.1.26
-->
- `eventName` {any}
- `eventName` {string|symbol}
- `listener` {Function}

Alias for `emitter.on(eventName, listener)`.
Expand All @@ -296,7 +296,7 @@ Alias for `emitter.on(eventName, listener)`.
<!-- YAML
added: v0.1.26
-->
- `eventName` {any}
- `eventName` {string|symbol}
- `...args` {any}

Synchronously calls each of the listeners registered for the event named
Expand Down Expand Up @@ -340,7 +340,7 @@ set by [`emitter.setMaxListeners(n)`][] or defaults to
added: v3.2.0
-->

* `eventName` {any} The name of the event being listened for
* `eventName` {string|symbol} The name of the event being listened for

Returns the number of listeners listening to the event named `eventName`.

Expand All @@ -353,7 +353,7 @@ changes:
description: For listeners attached using `.once()` this returns the
original listeners instead of wrapper functions now.
-->
- `eventName` {any}
- `eventName` {string|symbol}

Returns a copy of the array of listeners for the event named `eventName`.

Expand All @@ -370,7 +370,7 @@ console.log(util.inspect(server.listeners('connection')));
added: v0.1.101
-->

* `eventName` {any} The name of the event.
* `eventName` {string|symbol} The name of the event.
* `listener` {Function} The callback function

Adds the `listener` function to the end of the listeners array for the
Expand Down Expand Up @@ -406,7 +406,7 @@ myEE.emit('foo');
added: v0.3.0
-->

* `eventName` {any} The name of the event.
* `eventName` {string|symbol} The name of the event.
* `listener` {Function} The callback function

Adds a **one-time** `listener` function for the event named `eventName`. The
Expand Down Expand Up @@ -439,7 +439,7 @@ myEE.emit('foo');
added: v6.0.0
-->

* `eventName` {any} The name of the event.
* `eventName` {string|symbol} The name of the event.
* `listener` {Function} The callback function

Adds the `listener` function to the *beginning* of the listeners array for the
Expand All @@ -461,7 +461,7 @@ Returns a reference to the `EventEmitter`, so that calls can be chained.
added: v6.0.0
-->

* `eventName` {any} The name of the event.
* `eventName` {string|symbol} The name of the event.
* `listener` {Function} The callback function

Adds a **one-time** `listener` function for the event named `eventName` to the
Expand All @@ -480,7 +480,7 @@ Returns a reference to the `EventEmitter`, so that calls can be chained.
<!-- YAML
added: v0.1.26
-->
- `eventName` {any}
- `eventName` {string|symbol}

Removes all listeners, or those of the specified `eventName`.

Expand All @@ -494,7 +494,7 @@ Returns a reference to the `EventEmitter`, so that calls can be chained.
<!-- YAML
added: v0.1.26
-->
- `eventName` {any}
- `eventName` {string|symbol}
- `listener` {Function}

Removes the specified `listener` from the listener array for the event named
Expand Down Expand Up @@ -578,7 +578,7 @@ Returns a reference to the `EventEmitter`, so that calls can be chained.
<!-- YAML
added: REPLACEME
-->
- `eventName` {any}
- `eventName` {string|symbol}

Returns a copy of the array of listeners for the event named `eventName`,
including any wrappers (such as those created by `.once`).
Expand Down