https://github.com/ide/await-lock

Mutex locks for async functions
https://github.com/ide/await-lock

async-await concurrency mutex-lock

Last synced: 7 days ago
JSON representation

Mutex locks for async functions

• Host: GitHub
• URL: https://github.com/ide/await-lock
• Owner: ide
• License: mit
• Created: 2015-02-06T05:16:06.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2024-09-01T05:36:24.000Z (2 months ago)
• Last Synced: 2024-09-19T15:10:12.656Z (about 2 months ago)
• Topics: async-await, concurrency, mutex-lock
• Language: TypeScript
• Homepage:
• Size: 949 KB
• Stars: 88
• Watchers: 4
• Forks: 12
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# AwaitLock ![tests](https://github.com/ide/await-lock/workflows/Tests/badge.svg) [![codecov](https://codecov.io/gh/ide/await-lock/branch/master/graph/badge.svg)](https://codecov.io/gh/ide/await-lock)

Mutex locks for async functions

# API

[API documentation](https://github.com/ide/await-lock/wiki/API-documentation)

# Usage

```javascript

import AwaitLock from 'await-lock';

let lock = new AwaitLock();

async function runSerialTaskAsync() {

  await lock.acquireAsync();

  try {

    // IMPORTANT: Do not return a promise from here because the finally clause

    // may run before the promise settles, and the catch clause will not run if

    // the promise is rejected

  } finally {

    lock.release();

  }

}

```

You can also use AwaitLock with [co](https://github.com/tj/co) and generator functions.

```javascript

import AwaitLock from 'await-lock';

let runSerialTaskAsync = co.wrap(function*() {

  yield lock.acquireAsync();

  try {

    // Run async code in the critical section

  } finally {

    lock.release();

  }

});

```