1.0.0 • Published 10 months ago
@esfx/async-readerwriterlock v1.0.0
@esfx/async-readerwriterlock
The @esfx/async-readerwriterlock
package provides the AsyncReaderWriterLock
class, an async coordination primitive.
Overview
Installation
npm i @esfx/async-readerwriterlock
Usage
import { AsyncReaderWriterLock } from "@esfx/async-readerwriterlock";
// 'rwlock' protects access to 'userCache' and data stored on disk
const rwlock = new AsyncReaderWriterLock();
const userCache = new Map();
async function getUser(id) {
// get read access
const lk = await rwlock.read();
try {
let user = userCache.get(id);
if (!user) {
user = await readUserFromDisk(id);
userCache.set(id, user);
}
return user;
}
finally {
// release read access
lk.unlock();
}
}
async function addUser(user) {
// get write access
const lk = await rwlock.write();
try {
userCache.set(user.id, user);
await writeUserToDisk(user.id, user);
}
finally {
// release write access
lk.unlock();
}
}
async function updateUser(id, oldData, newData) {
// get upgradeable read access
const lk = await rwlock.upgradeableRead();
try {
// verify that we are ok to make changes...
let user = userCache.get(id);
if (!user || user.name === oldData.name && user.email === oldData.email) {
// looks safe, so upgrade to a write lock
const updlk = await lk.upgrade();
try {
if (!user) {
user = { id };
userCache.set(id, user);
}
user.name = newData.name;
user.email = newData.email;
await writeUserToDisk(user.id, user);
}
finally {
updlk.unlock(); // release the write lock
}
}
}
finally {
lk.unlock(); // release the read lock
}
}
API
You can read more about the API here.
1.1.0-alpha.202307260322
10 months ago
1.1.0-alpha.202302091715
1 year ago
1.1.0-alpha.202306061406
11 months ago
1.1.0-alpha.202306061316
11 months ago
1.1.0-alpha.202306051228
11 months ago
1.1.0-alpha.202306080253
11 months ago
1.1.0-alpha.202302071935
1 year ago
1.1.0-alpha.202305082104
1 year ago
1.1.0-alpha.202211221509
1 year ago
1.1.0-alpha.202210252139
2 years ago
1.0.0
2 years ago
1.0.0-dev.7
2 years ago
1.0.0-pre.42
2 years ago
1.0.0-dev.8
2 years ago
1.0.0-pre.41
2 years ago
1.0.0-dev.5
2 years ago
1.0.0-pre.44
2 years ago
1.0.0-dev.6
2 years ago
1.0.0-pre.43
2 years ago
1.0.0-dev.4
2 years ago
1.0.0-prenative.0
2 years ago
1.0.0-prenative.1
2 years ago
1.0.0-dev.0
2 years ago
1.0.0-pre.40
2 years ago
1.0.0-pre.31
2 years ago
1.0.0-pre.33
2 years ago
1.0.0-pre.35
2 years ago
1.0.0-pre.34
2 years ago
1.0.0-pre.37
2 years ago
1.0.0-pre.36
2 years ago
1.0.0-pre.39
2 years ago
1.0.0-pre.38
2 years ago
1.1.0-alpha.202211291446
1 year ago
1.0.0-pre.30
3 years ago
1.0.0-pre.26
3 years ago
1.0.0-pre.25
3 years ago
1.0.0-pre.28
3 years ago
1.0.0-pre.29
3 years ago
1.0.0-pre.24
3 years ago
1.0.0-pre.23
3 years ago
1.0.0-pre.19
3 years ago
1.0.0-pre.17
3 years ago
1.0.0-pre.16
3 years ago
1.0.0-pre.13
5 years ago
1.0.0-pre.12
5 years ago
1.0.0-pre.11
5 years ago
1.0.0-pre.10
5 years ago
1.0.0-pre.9
5 years ago
1.0.0-pre.8
5 years ago
1.0.0-pre.7
5 years ago
1.0.0-pre.6
5 years ago
1.0.0-pre.5
5 years ago