sharedhashmap

SharedHashMap

HashMap using SharedArrayBuffer

Installation

Run npm install sharedhashmap in your project

Require using

const SharedHashMap = require('sharedhashmap')

Usage

Example

const map = new SharedHashMap()

await map.set('test', 'testvalue')
let x = await map.get('test') // x = 'testvalue'

let keys = await map.keys // keys = ['test']

let map2
// export hashmap
let exportedMap = map.export((syncData) => {
    map2.sync(syncData)
})

//send that exportedMap to another thread/worker and re-create map object
map2 = new SharedHashMap(exportedMap, (syncData) => {
    map.sync(syncData)
})
let y = await map2.get('test') // y = 'testvalue'

The sync functions are needed because the buffers are created dynamically. This is more memory efficient but requires you to implement the sync functions. You need to pass them when exporting the map and when creating the second map object. No actual data is sent over this, just the SharedArrayBuffers which acts like a pointer. When using workers you will want to send this using postMessage.