js-simple-cache

A simple caching object data base on ES6 Map() that support auto invalidate cache when reach maximum size. This'll work if all object you wanna cache have a unique key like when you cache user data, all object have a key like userID

Install

1npm i js-simple-cache

Usage

1// v1.0.7
2const Cache = require('js-simple-cache')
3const cache = new Cache('userID', 10000)
4// v1.2.0
5// Node module
6const { Cache } = require('js-simple-cache')
7const cache = new Cache('userID', 10000)
8// ES module
9import { Cache } from 'js-simple-cache'
10const cache = new Cache('userID', 10000)

options

• First aggrument is unique key, when you set new item, it auto set with that key for you and you can access later with get
• Second arrgrument is limit size, it help cache to auto delete least use when cache reach maximum size limit (but you can set undefined to have no limit)
• Note: This only accept cache object has a props that you provide when init

API provide

Getter and Setter

• Getter only: key, size
• Getter and Setter: limit (Integer and greater than current size)

Store an item

• First aggrument is the object that contain key, second aggrument is a timer (miliseconds) that will help you auto remove item after X miliseconds.

1cache.set({userID:1, username: 'HOAI AN'}, 10000) // item will auto remove after 10 seconds

• This is base on ES6 Map so if you put same key it gonna replace old item

Get an item

1const user = cache.get(1)
2console.log(user) // {userID:1, username: 'HOAI AN'}

• If you using typescript and you cache object create by a class, you can casting like by using as like this.

1const order = cache.get(110230) as Order // Order is your class

Remove an item

1cache.remove(1)

Clear cache

1cache.clear()

find a key

1cache.set({ userID: 1, username: 'HOAI AN' })
2cache.set({ userID: 2, username: 'HOAI AN1' })
3cache.set({ userID: 3, username: 'HOAI AN2' })
4cache.set({ userID: 4, username: 'HOAI AN3' })
5cache.set({ userID: 5, username: 'HOAI AN4' })
6cache.set({ userID: 6, username: 'HOAI AN5' })
7const key = cache.findKey(item => item.username === 'HOAI AN3')
8console.log(key) // 4

check that cache have a key

1cache.has(2)

filter

1const key = cache.filter(item => item.username.includes('HOAIAN'))

• You can convert to Object / Array to use other prototype

search

1const options = {
2    searchValue: 'string',
3    searchFields: ['field1', 'field2'], // specified object field to search ( if you have nested object or array, enable deepScan)
4    nocase: true, // optional set true to match whatever 
5    deepScan: true // optional set true to enable nested object scan
6}
7const result = cache.search(options)

Export to Object / Array

1cache.toArray()
2cache.toObject()

• If you export to Object, it gonna use your key values when you create cache as key for Object

Export to JSON (Object / Array)

1cache.toJSONArray()
2cache.toJSONObject()