fsmx v1.0.2

FSMX

Simple Finite State Machine based on async/await events and actions

Documentation

Setup

import fsmx from 'fsmx'

const fsm = new fsmx({
    initial: 'initial',
    actions: {
        waitForCmd: {from: ['initial', 'end', 'error'], to: 'wait'},
        listenForCmd: {from: 'wait', to: 'listen'},
        collectData: {from: 'listen', to: 'calculate'},
        giveAnswer: {from: 'calculate', to: 'speak'},
        endCmd: {from: 'speak', to: 'end'},
        wrongWay: {from: 'calculate', to: 'error'}
    },
    events: {
        async onLeaveState (from, to) {
            // do something asynchronous
        },
        async onEnterState (from, to) {
            // do something asynchronous
        }
    }
})

Initial parameters

Methods

fsm.is('initial') - check the current state

fsm.can('wait') - check possibility to transition to some state from the current state

fsm.reset() - reset the current state to initial

// Call actions to transition between states
(async () => {
    await fsm.waitForCmd()
    await fsm.listenForCmd()
    // ...
})()

Scripts

yarn start - development

yarn test - tests

yarn test:watch - tests with watch flag

yarn build - build

yarn coverage - get coverage report