npmpackage.info

ts-async-semaphore

A counting semaphore based on Java's Concurrent Semaphore.

4.0.1

MIT

TypeScript

21.91 kB

29,057 3.2

Installations

npm install ts-async-semaphore

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM

Min. Node Version

>=14.5.0

Node Version

20.9.0

NPM Version

10.1.0 Score

72.4

Supply Chain

99.4

Quality

77.5

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

5

Total

432

Closed

81

Merged

346

Issues

Open

1

Total

4

Closed

3

Releases

v4.0.1

Published on 20 Feb 2024

v3.0.4

Published on 17 Jan 2022

v3.0.3

Published on 17 Jan 2022

v3.0.1

Published on 17 Jan 2022

v3.0.0

Published on 26 Feb 2021

v2.0.0

Published on 27 Nov 2019

View all 8 releases

Contributors

Unable to fetch Contributors

View all 4 contributors

Languages

TypeScript

JavaScript

Shell

TypeScript (85.05%)

JavaScript (13.18%)

Shell (1.77%)

Developer

skrtheboss

Download Statistics

Total Downloads

29,057

Last Day

Last Week

Last Month

969

Last Year

10,444

GitHub Statistics

4 Stars

360 Commits

2 Watching

13 Branches

4 Contributors

Maintainers

Package Meta Information

Latest Version

4.0.1

Package Id

ts-async-semaphore@4.0.1

Unpacked Size

21.91 kB

Size

4.80 kB

File Count

NPM Version

10.1.0

Node Version

20.9.0

Publised On

20 Feb 2024

Total Downloads

Cumulative downloads

Total Downloads

29,057

Last day

-76.9%

Compared to previous day

Last week

-88.1%

Compared to previous week

Last month

23.3%

969

Compared to previous month

Last year

-11.9%

10,444

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Versions

TS Async Semaphore Banner

Async Semaphore

A counting semaphore based on Java's Concurrent Semaphore.

Install

Install the module via npm:

npm install ts-async-semaphore

Quick Example

1// fairness false
2
3import { Semaphore } from 'ts-async-semaphore';
4const semaphore = new Semaphore(0);
5
6semaphore.acquire(2).then(() => {
7    console.log('Hello');
8});
9
10semaphore.acquire().then(() => {
11    console.log('World');
12
13    semaphore.release(2);
14});
15
16setTimeout(function () {
17    semaphore.release();
18}, 2000);

1// fairness true
2
3import { Semaphore } from 'ts-async-semaphore';
4const semaphore = new Semaphore(0, true);
5
6semaphore.acquire(2).then(() => {
7    console.log('Hello');
8});
9
10semaphore.acquire().then(() => {
11    console.log('World');
12});
13
14semaphore.release(1);
15
16setTimeout(function () {
17    semaphore.release(2);
18}, 2000);

1import { Semaphore } from 'ts-async-semaphore';
2const semaphore = new Semaphore(0, true);
3
4semaphore.tryAcquire(1, 50).then((val) => {
5    console.log(`Acquire ${val ? 'success' : 'fail'}`);
6});

Documentation

Constructor: Semaphore([`permits`], [`fairness`])

permits: Integer Initial available permits of semaphore. Default: 0.

fairness: Boolean Fairness of semaphore. If set to true, a FIFO rules applied, else, look on each acquirers permit value.

#availablePermits()

Returns the current number of permits available in this semaphore.

Returns: number

#acquire([`permits`])

Acquires the given number of permits from this semaphore.

permits: number The number of permits to acquire. Default: 0.

Returns: `Promise<void>`

#getQueuedAcquirers()

Returns an estimate of the number of acquirers waiting to acquire.

Returns: Function[]

#getQueueLength()

Returns an estimate of the number of acquirers waiting to acquire.

Returns: number

#release([`permits`])

Releases the given number of permits, returning them to the semaphore.

permits: number The number of permits to release. Default: 0.

#drainPermits()

Acquires and returns all permits that are immediately available.

Returns: number

#reducePermits(`permits`)

Shrinks the number of available permits by the indicated reduction.

permits: number The number of permits to remove.

#tryAcquire([`permits`], [`timeoutMs`])

Acquires the given number of permits from this semaphore.

permits: number The number of permits to acquire. Default: 0. timeoutMs: number The timeout after which the acquire will fail

Returns: Boolean Promise true if success, false false if fail

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

Maintained

Determines if the project is "actively maintained".

0

Code-Review

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

0

CII-Best-Practices

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

0

Token-Permissions

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

0

Pinned-Dependencies

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

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.2

/10

Last Scanned on 2024-12-30

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 ts-async-semaphore

zero-backpressure-semaphore-typescript

3.0.9

A modern Promise-semaphore for Node.js projects, enabling users to limit the number of concurrently executing promises. Offering backpressure control for enhanced efficiency, utilizing a communicative API that signals availability, promoting a just-in-tim

zero-backpressure-weighted-promise-semaphore

1.0.13

A modern weighted promise semaphore for Node.js projects, ideal for managing workloads with varying processing requirements. It allows limiting the total weight of concurrently executing jobs, ensuring efficient resource utilization. Offering backpressure

@alumis/ts-async

1.0.0

A TypeScript async utility library that includes a C#-style CancellationToken, OperationCancelledError and Semaphore, as well as various other utility async functions.

websemaphore

0.9.52

Handle concurrency in the cloud with ease with serverless semaphores. This is the TS/JS client for https://www.websemaphore.com

ts-async-semaphore

Installations

Developer Guide

Yes

CommonJS, ESM

>=14.5.0

20.9.0

10.1.0

Score

Pull Requests

5

432

81

346

Issues

1

4

3

Releases

Contributors

Unable to fetch Contributors

Languages

Developer

skrtheboss

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

29,057

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Async Semaphore

Install

Quick Example

Documentation

Constructor: Semaphore([permits], [fairness])

#availablePermits()

#acquire([permits])

Returns: Promise<void>

#getQueuedAcquirers()

#getQueueLength()

#release([permits])

#drainPermits()

#reducePermits(permits)

#tryAcquire([permits], [timeoutMs])

10

10

10

7

0

0

0

0

0

0

0

0

3.2

/10

Other packages similar to ts-async-semaphore

Constructor: Semaphore([`permits`], [`fairness`])

#acquire([`permits`])

Returns: `Promise<void>`

#release([`permits`])

#reducePermits(`permits`)

#tryAcquire([`permits`], [`timeoutMs`])