Skip to content

BuGlessRB/mutexlight

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

mutexlight

mutexlight is a zero-dependencies minimal mutex library. Mutexes are used to obtain exclusive locks to certain resources which are accessed asynchronously.

Requirements

It runs inside any webbrowser or node environment that supports promises.

Basic usage

The following sample code should speak for itself:

const mutexlight = require("mutexlight");

const mutex = new mutexlight();

async function runme() {
  const release = await mutex.acquire();        // Acquire mutex lock
  // Do some stuff
  release();                                    // Release mutex lock
}

runme();

Reference documentation

API

Exposed API-list:

  • new mutexlight()
    Creates a new mutex.
  • this.acquire(tryonly)
    Returns a promise that resolves once the mutex lock has been acquired. The promise resolves to a release function which needs to be called as soon as the mutex lock needs to be released (acquired locks that are not explicitly released will stay stuck in locked state indefinitely). If trylock is true, the promise will resolve to zero immediately if the mutex lock has already been acquired.

References

Card-carrying member of the zerodeps movement.

About

minimal mutex lirbary.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published