Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thlorenz/async-await-box
https://github.com/thlorenz/async-await-box
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/thlorenz/async-await-box
- Owner: thlorenz
- Created: 2018-02-16T16:31:29.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-05-07T16:29:29.000Z (over 6 years ago)
- Last Synced: 2024-10-18T02:17:08.994Z (3 months ago)
- Language: JavaScript
- Homepage: https://github.com/thlorenz/async-await-box
- Size: 9.77 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# async-wait-box
Examples to show techniques to archieve particular tasks via `async/await`.
Ordered by level of complexity.
## Quick `async/await` Overview
`async` marks a function as asynchronous, the function will always return a Promise, resolving
with the return value. `await` handles Promises inside the async function, making the
function’s inner logic synchronous.
`async/await` only blocks execution of that function, however other functions can still execute
while it is waiting. Thus developers still can leverage Node.js concurrency.
## Getting Started
To ensure all dependencies are installed run the below after cloning the repo.
```
npm install
```
## Usage
Run each example directly i.e. `node 01-basics.js` and edit to your delight and observe what
changed.
### Debugging
To see how promises get executed/resolved/rejected under the hood run with the `DEBUG=task` env
var, i.e.:
```
DEBUG=task node 01-basics.js
```
To run an example in your browser run it with the included [budo](https://github.com/mattdesl/budo),
i.e.:
```
npm run budo -- 01-basics.js
```
This allows you to add breakpoints, observe stack traces, etc. to understand how things work
under the hood and also to convince yourself that `async/await` code is easily debuggable.
# Resources
- [6 reasons why async/await blows promises away](https://hackernoon.com/6-reasons-why-javascripts-async-await-blows-promises-away-tutorial-c7ec10518dd9)
- [modern modules](https://medium.com/@mikeal/modern-modules-d99b6867b8f1) in which @mikeal
also talks about the advantages of async/await over other async flow control patterns
- [comparison of promises/callbacks vs async/await](https://blog.patricktriest.com/what-is-async-await-why-should-you-care/)
- [awesome promises](https://github.com/wbinnssmith/awesome-promises)
- [promise fun](https://github.com/sindresorhus/promise-fun) tons of useful promise libraries
lots of which can be consumed via `async/await` as well
- [node.js core util promisify
implementation](https://github.com/nodejs/node/blob/f25104e1364cf7c56ae4a09a86b64a87de326ec3/lib/internal/util.js#L268)
- [pify](https://github.com/sindresorhus/pify) promisify with more features and _magic_
# LICENSE
MIT