80 lines
1.5 KiB
Markdown
80 lines
1.5 KiB
Markdown
|
# `@socket.io/component-emitter`
|
||
|
|
|
||
|
|
Event emitter component.
|
||
|
|
|
||
|
|
This project is a fork of the [`component-emitter`](https://github.com/sindresorhus/component-emitter) project, with [Socket.IO](https://socket.io/)-specific TypeScript typings.
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
```
|
||
|
|
$ npm i @socket.io/component-emitter
|
||
|
|
```
|
||
|
|
|
||
|
|
## API
|
||
|
|
|
||
|
|
### Emitter(obj)
|
||
|
|
|
||
|
|
The `Emitter` may also be used as a mixin. For example
|
||
|
|
a "plain" object may become an emitter, or you may
|
||
|
|
extend an existing prototype.
|
||
|
|
|
||
|
|
As an `Emitter` instance:
|
||
|
|
|
||
|
|
```js
|
||
|
|
import { Emitter } from '@socket.io/component-emitter';
|
||
|
|
|
||
|
|
var emitter = new Emitter;
|
||
|
|
emitter.emit('something');
|
||
|
|
```
|
||
|
|
|
||
|
|
As a mixin:
|
||
|
|
|
||
|
|
```js
|
||
|
|
import { Emitter } from '@socket.io/component-emitter';
|
||
|
|
|
||
|
|
var user = { name: 'tobi' };
|
||
|
|
Emitter(user);
|
||
|
|
|
||
|
|
user.emit('im a user');
|
||
|
|
```
|
||
|
|
|
||
|
|
As a prototype mixin:
|
||
|
|
|
||
|
|
```js
|
||
|
|
import { Emitter } from '@socket.io/component-emitter';
|
||
|
|
|
||
|
|
Emitter(User.prototype);
|
||
|
|
```
|
||
|
|
|
||
|
|
### Emitter#on(event, fn)
|
||
|
|
|
||
|
|
Register an `event` handler `fn`.
|
||
|
|
|
||
|
|
### Emitter#once(event, fn)
|
||
|
|
|
||
|
|
Register a single-shot `event` handler `fn`,
|
||
|
|
removed immediately after it is invoked the
|
||
|
|
first time.
|
||
|
|
|
||
|
|
### Emitter#off(event, fn)
|
||
|
|
|
||
|
|
* Pass `event` and `fn` to remove a listener.
|
||
|
|
* Pass `event` to remove all listeners on that event.
|
||
|
|
* Pass nothing to remove all listeners on all events.
|
||
|
|
|
||
|
|
### Emitter#emit(event, ...)
|
||
|
|
|
||
|
|
Emit an `event` with variable option args.
|
||
|
|
|
||
|
|
### Emitter#listeners(event)
|
||
|
|
|
||
|
|
Return an array of callbacks, or an empty array.
|
||
|
|
|
||
|
|
### Emitter#hasListeners(event)
|
||
|
|
|
||
|
|
Check if this emitter has `event` handlers.
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT
|