A simple state management for JS applications without dependencies.
< 500 Bytes ποΈ and Typescript friendly.
<script src="https://unpkg.com/simte@0.0.1/dist/index.iife.js"></script>
const { createState } = simte
yarn add simte
# OR
npm i simteimport { createState } from 'simte'
// initialize the state const state = createState({ counter: 0 }) // subscribe to updates state.subscribe(state => console.log(`The state has changed: ${state}`)) // update the state state.setState({ counter: 1 }) // will log `The state has changed: { counter: 1 }`
Initialize the given state and return 4 methods:
- getState
- setState
- subscribe
- unsubscribe
Return the current state
Update the current state with given parameter. This update will trigger listeners.
Setup a listener with given parameter. The listener should be a function who receive the new state. The subscribe method will return an id (used for unsubscribe).
Unsubscribe a listener with his identifier.
You can use your Type with Typescript. The return of the getState function, the parameter of the setState function, and the parameter of each listener will use this type.
type MyState = { counter: number } const state = createState<MyState>({ counter: 0 }) state.getState() // { counter: 0 } as MyState state.setState({ counter: 1, newProperty: 'hello' }) // will throw "Argument of type '{ counter: number; newProperty: string; }' is not assignable to parameter of type 'MyState'."