npmpackage.info

Gathering detailed insights and metrics for axax

Other packages similar to axax

axaxaxssss

1.0.0

axaxaman

66.0.0

Security holding package

axaxaman-sh

66.0.0

Security holding package

axaxatest

66.0.0

Security holding package

Gathering detailed insights and metrics for axax

axax - 0.2.2 | npmpackage.info

axax

Async Iterator Extensions for JavaScript e.g. map, reduce, filter, flatMap, etc.

0.2.2

508

MIT

TypeScript

6.09 kB

1,358,123 2.9

Installations

npm install axax

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

10.9.0

NPM Version

6.9.0 Score

95.8

Supply Chain

99.2

Quality

75.6

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

3

Total

48

Closed

10

Merged

35

Issues

Open

7

Total

32

Closed

25

Releases

Unable to fetch releases

Languages

TypeScript

JavaScript

TypeScript (99.15%)

JavaScript (0.85%)

Developer

jamiemccrindle

Download Statistics

Total Downloads

1,358,123

Last Day

2,741

Last Week

17,894

Last Month

71,803

Last Year

684,075

GitHub Statistics

MIT License

508 Stars

236 Commits

22 Forks

7 Watchers

2 Branches

10 Contributors

Updated on Mar 15, 2025

Bundle Size

74.62 kB

Minified

6.09 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 10 Contributors

Package Meta Information

Latest Version

0.2.2

Package Id

axax@0.2.2

Size

41.00 kB

NPM Version

6.9.0

Node Version

10.9.0

Published on

Sep 29, 2019

Total Downloads

Cumulative downloads

Total Downloads

1,358,123

Dev Dependencies

@types/jest @types/node jest prettier rimraf ts-jest ts-node tslint typescript

Async Iterator Extensions

A library of async iterator extensions for JavaScript including map, reduce, filter, flatMap, pipe and more.

Installation

1npm install axax # or yarn add axax

Why Axax?

Async iterators are a useful way to handle asynchronous streams. This library adds a number of utility methods similar to those found in lodash, underscore, Ramda or RxJs.

es5 vs esnext

Axax contains both transpiled es5 code as well as esnext code, the difference being that esnext uses the native for await syntax. In nodejs 10.x that gives approximately a 40% speedup.

1// use es5 if you want to support more browsers
2import { map } from "axax/es5/map"; 
3
4// use esnext if you're only using node 10.x or supporting very new browsers
5import { map } from "axax/esnext/map";

Reference Documentation

API Reference

Examples

fromEvent

fromEvent turns DOM events into an iterable.

1import { fromEvent } from "axax/es5/fromEvent";
2
3const clicks = fromEvent(document, 'click');
4
5for await (const click of clicks) {
6    console.log('a button was clicked');
7}

pipe, map, filter, fromLineReader

fromLineReader turns a NodeJS LineReader into an async iterable. The example below prints the lines from a file in upper case after filtering out the empty ones.

1// create the line reading async iterable
2const lines = fromLineReader(
3    require("readline").createInterface({
4        input: require("fs").createReadStream("./data/example.txt")
5    })
6);
7
8// create a filter that removes empty lines
9const notEmpty = filter(line => line.length > 0);
10
11// convert to uppercase
12const toUpperCase = map(line => line.toUpperCase());
13
14// go through each of the non empty lines
15for await (const line of pipe(notEmpty, toUpperCase)(lines)) {
16    console.log(line);
17}

Subject

Subject makes it easy to turn stream of events into an iterable. The code below is essentially how fromEvent was implemented.

1import { Subject } from "axax/es5/subject";
2
3const subject = new Subject();
4
5// set up a callback that calls value on the subject
6const callback = value => subject.onNext(value);
7
8// attach the callback to the click event
9document.addEventListener('click', callback);
10
11// remove the callback when / if the iterable stops
12subject.finally(() => document.removeEventListener('click', callback));
13
14// go through all the click events
15for await (const click of subject.iterator) {
16    console.log('a button was clicked');
17}

Avoiding leaks

It's possible to have an async iterator leak if it never returns a value e.g.:

1const subject1 = new Subject();
2const subject2 = new Subject();
3
4async function* neverEnds() {
5  try {
6    for await(const i of subject2.iterator) {
7      yield i;
8    }
9  } finally {
10    console.log("never called")
11  }
12}
13
14async function* run() {
15  for await(const i of merge(subject1.iterator,neverEnds())) {
16    break;
17  }
18}
19
20run()
21subject1.onNext(1)

If you need to be able to cancel async iterators that may never return values, consider Rx or regular Observables for now.

(Thanks to @awto for the example)

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

7

SAST

Determines if the project uses static code analysis.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Maintained

Determines if the project is "actively maintained".

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.9

/10

Last Scanned on 2025-05-05

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to axax

Other packages similar to axax

axax

Installations

Developer Guide

Yes

CommonJS

10.9.0

6.9.0

Score

Pull Requests

3

48

10

35

Issues

7

32

25

Releases

Unable to fetch releases

Languages

Developer

jamiemccrindle

Download Statistics

GitHub Statistics

Bundle Size

74.62 kB

6.09 kB

Maintainers

Package Meta Information

Total Downloads

1,358,123

Dev Dependencies

Async Iterator Extensions

Installation

Why Axax?

es5 vs esnext

Reference Documentation

Examples

fromEvent

pipe, map, filter, fromLineReader

Subject

Avoiding leaks

10

10

10

7

0

0

0

0

0

0

0

0

0

2.9

/10

Weekly Downloads

Monthly Downloads

Yearly Downloads