statemachine
Last updated
Last updated
A statematchine allows you to wrap state with transitions. That means you can protect your logic from running in invalid states of the application.
Please read the to learn more about statemachines and typing them.
You define a whole namespace as a statemachine, you can have a nested statemachine or you can even put statemachines inside statemachines.
You define a statemachine by setting up its states and what events to handle within each state. Each handler returns the new state of of the state machine.
You instantiate a machine by calinng its create method. This takes the initial state and any optional base state the lives across all states of the machine.
You transition the state machine by sending events.
That means you can send TOGGLE as an event to the machine. Think of sending events as actually changing the state, but in a controlled way. You can optionally pass a payload with the event.
In actions you can check what state a machine is in by using the matches API.
You can also directly use state.myMachine.current
, but please read the guide to understand the different between these two ways of checking.