@async-af/wrapper
v7.0.39
Published
standalone AsyncAF package: AsyncAfWrapper (https://async-af.js.org/AsyncAfWrapper)
Downloads
132
Maintainers
Readme
@async-af/wrapper
This is the standalone AsyncAF
package for AsyncAfWrapper
.
AsyncAfWrapper
is one option for cherry-picking only the AsyncAF
methods you'd like to use in your code, rather than pulling in the entire AsyncAF library (A.K.A. async-af
).
For more information:
- check out the docs for
AsyncAfWrapper
; - for more general setup, take a look at
- the AsyncAF docs
- the main AsyncAF README
- or just continue reading for an example of how to use
AsyncAfWrapper
Usage
Say you only want to use mapAF
, filterAF
, forEachAF
, and logAF
instead of pulling in the entire AsyncAF library.
First, install the separate packages (e.g., for npm):
$ npm install--save @async-af/{wrapper,map,filter,foreach,log}
Then import the packages:
import AsyncAF from '@async-af/wrapper'; // aliasing 'AsyncAfWrapper' as 'AsyncAF'
import mapAF from '@async-af/map';
import filterAF from '@async-af/filter';
import forEachAF from '@async-af/foreach';
import logAF from '@async-af/log';
If you'd like to save some vertical screen real estate and cut the imports down to one line, see Wrapper/Use: Too Many 🤬 Imports!?
Now call use
, including all prototype methods you'd like to add to AsyncAfWrapper's prototype in the first argument, prototypeMethods
and all static methods you'd like to add to AsyncAfWrapper in the second optional argument, staticMethods
AsyncAF.use({ // prototype methods go in the first argument
mapAF,
filterAF,
forEachAF
}, { // static methods go in the second argument
logAF
});
Ready to go!
const promises = [1, 2, 3].map(n => Promise.resolve(n));
AsyncAF(promises).mapAF(n => n * 2).filterAF(n => n !== 4).forEachAF(n => console.log(n));
// logs 2 then 6
AsyncAF.logAF(promises);
// @filename.js:24:9:
// [ 1, 2, 3 ]
// in 0.003 secs
protip: you can use the same technique to add your own custom prototype or static methods to AsyncAfWrapper or even to the main AsyncAF class; see use
for an example.