worker_map
v0.0.8
Published
Tread-safe map structure for worker_threads.
Downloads
12
Maintainers
Readme
worker_map
A simple abstraction for Node.js worker_threads
, allowing you to create and share a Map (hash table)
between worker threads and the main process. This simplifies the process of managing shared data and communication between worker threads.
Under the hood, the library uses SharedArrayBuffer
to create shared memory, enabling seamless data sharing between threads. Additionally, it uses Atomics
mechanism to implement a mutex, ensuring thread safety and preventing race conditions during data access and manipulation.
Installation
npm i worker_map
Basic Example
First, let's create a simple hash map structure in main process, then create a worker thread and share the hash.
// main.js
const { Worker } = require("worker_threads");
const { WorkerMap } = require("worker_map");
const map = new WorkerMap();
map.set("balance", 100); // sync operation
new Worker("./worker.js", {
workerData: {
mapBuffer: map.toSharedBuffer(),
},
});
setTimeout(() => {
console.log(map.get("balance")); // 200
}, 50);
Now, let's access the shared hash map structure in the worker thread.
// worker.js
const { WorkerMap } = require("worker_map");
const { workerData } = require("worker_threads");
const map = new WorkerMap(workerData.mapBuffer);
console.log(map.get("balance")); // 100
// The change will be reflected in the main process as well
map.set("balance", 200);
Instance methods
Worker_map is much like JavaScript's regular Map.
map.set(key, value)
map.set('name', 'John'); // true
map.get(key):
const name = map.get('name'); // 'John'
map.delete(key):
map.delete('name'); // true
map.delete('something'); // false because it doesn't exist
map.clear():
map.clear();
map.size(); // 0
map.has(key)
map.has('name'); // true
map.has('country'); // false
map.size()
map.has('size'); // 1
map.keys()
map.keys(); // [ 'name' ]
map.entries()
for (const [ key, value ] of map.entries()) {
console.log(`${key}: ${value}`); // name: 'John'
}
map.forEach()
map.forEach(function(key, value, map) {
console.log(`${key}: ${value}`); // name: 'John'
});
map.toSharedBuffer()
const buffer = map.toSharedBuffer();
const sameMap = new WorkerMap(buffer);
map.toObject()
const mapObject = map.toObject(); // { ... }
mapObject.name; // 'John'
Contributing
See the contributing guide for detailed instructions on how to get started with our project.
TODO
- Currently, when performing an action on the map, it temporarily locks the entire map, loads the necessary data, and then unlocks the map, allowing other threads to access it. However, this approach is suboptimal. It would be more efficient if we could lock only the specific portion of memory required for the particular operation.
Limitations
Please be aware of the following limitations when using our library:
- Functions: Function types are not supported.
- NaN Values: NaN values are not supported.