Super sessionStorage

Implementation of improved window.sessionStorage for server, Type-Safe, and TTL cache system.

it works without the need for a window. Furthermore, super sessionstorage maintains the original types, avoiding the need to make conversions. (type-safe storage).

Install

1npm install super-sessionstorage

Methods

• setItem(key: string, value: T, customTTL?: number): void

• getItem(key: string): T | undefined

• key(index: number): string | undefined

• has(key: string): boolean

• includes(value: T): boolean

• clear(): void

• get length(): number

• removeItem(key: string): void

Options

• stdTTL default is infinity (seconds)

• checkperiod default is 60 (seconds)

Strict Type

1const storage = new SuperSessionStorage<CustomItemType>({ /* options */ })

Example

config.js:

1import { SuperSessionStorage } from 'super-sessionstorage'
2
3export const storage = new SuperSessionStorage({ stdTTL: 3600 })

setItem:

1import { storage } from './config.js'
2
3const myObject = {
4  test1: 123,
5  test2: [1, 2, '123'],
6}
7
8storage.setItem('example', myObject)

getItem:

1import { storage } from './config.js'
2
3const example = storage.getItem('example')
4
5console.log(example)
6console.log(typeof example)

output:

1{ test1: 123, test2: [1, 2, "123"] }
2object

Strict Type:

1import { SuperSessionStorage } from 'super-sessionstorage'
2
3type Item = { id: number;  productName: string }
4
5const storage = new SuperSessionStorage<Item>()
6
7storage.setItem('example1', { id: '100', productName: 'test' })
8// Error: Id should be number