Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robojones/once
Create promises for events in Node.js
https://github.com/robojones/once
await events nodejs promise
Last synced: 23 days ago
JSON representation
Create promises for events in Node.js
- Host: GitHub
- URL: https://github.com/robojones/once
- Owner: robojones
- License: mit
- Created: 2017-11-24T18:44:32.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-10-04T20:55:08.000Z (about 6 years ago)
- Last Synced: 2024-01-24T19:08:50.072Z (10 months ago)
- Topics: await, events, nodejs, promise
- Language: TypeScript
- Homepage: https://npmjs.com/package/once-promise
- Size: 65.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# once-promise
Create promises for events.
[](https://circleci.com/gh/robojones/once)
[](https://codeclimate.com/github/robojones/once/test_coverage)
[](https://codeclimate.com/github/robojones/once/maintainability)
## Contents
1. [Breaking changes](#breaking-changes)
2. [Usage examples](#usage-examples)
3. [JavaScript example](#javascript-example)
4. [TypeScript example](#typescript-example)
5. [Docs](#docs)
## Breaking changes
There are some incompatibilities between version 1.x and 2.x
- The `once()` method is no longer the default export. See the examples for more information.
- When providing multiple event names the array may no longer contain promises.
## Usage examples
### Await a single event
```javascript
await once(process, 'exit')
```
This will await the `"exit"` event of the nodejs process.
### Await multiple events
```javascript
await once(readable, ['error', 'end'])
```
In this example we are awaiting the `"error"` or `"end"` event of a readable stream.
If the stream emits the `"end"` event, the promise will get **resolved**. If an `"error"` gets emitted first, the promise gets **rejected** with the error.
## JavaScript example
```javascript
const { once } = require('once-promise').default
const { EventEmitter } = require('events')
async function example () {
const emitter = new EventEmitter()
setTimeout(() => {
emitter.emit('continue')
}, 5000)
console.log('start')
// Create and await a promise for the "continue" event.
// It should take 5s until the promise gets resolved.
await once(emitter, 'continue')
console.log('end :D')
}
example()
```
## TypeScript example
```typescript
import EventEmitter from 'events'
import { once } from 'once-promise'
async function example () {
const emitter = new EventEmitter()
setTimeout(() => {
emitter.emit('continue')
}, 5000)
console.log('start')
// Create and await a promise for the "continue" event.
// It should take 5s until the promise gets resolved.
await once(emitter, 'continue')
console.log('end :D')
}
example()
```
## Docs
### once(emitter, event, arrayMode)
1. emitter `` - This can be any EventEmitter (e.g. the `process` object, a stream,...)
2. event `` - Either one eventname or an array containing the names of multiple events. If an array is passed, the returned promise will resolve to the first promise/event that gets resolved.
3. arrayMode? `` - If you pass true as last parameter, the promise will resolve to an array containing all arguments provided by the (fastest) event. This can be useful if an event emits multiple values.
__Note:__ When you are listening for an `"error"` event and the event gets emittet, the promise gets rejected instead of resolved.