Executable state machine for Node and Web development.
If you like state.js, please star it.
Update: state.js v6 is nearing completion - it will be moving to the new state repo and will use npm organistaions.
Getting started
The state.js API is split into:
- Classes that represent a state machine model (State, PseudoState, Transition, etc.)
- An interface and implementation of active state configuration (current state); this allows multiple concurrent instances of a single state machine model
- A set of functions that provide the state machine runtime
The API is bound to a global object of your choosing.
state.js is developed in TypeScript and transpiled to JavaScript; you can use it in either language.
Node
1. Install state.js in your project:
$ npm install state.js
2. Import state.js and build your state machine:
var state = ; // send log messages, warnings and errors to the consolestate; // create the state machine model elementsvar model = "model";var initial = "initial" model statePseudoStateKindInitial;var stateA = "stateA" model;var stateB = "stateB" model; // create the state machine model transitionsinitial;stateA; // create a state machine instancevar instance = "instance"; // initialise the model and instancestate; // send the machine instance a message for evaluation, this will trigger the transition from stateA to stateBstate;
Web
1. Add state.js to your project:
$ bower install --save state
Alternatively, download direct from lib/web/state.js or lib/web/state.min.js.
2. Include state.js as a script in your page:
Note: the target attribute within the script element defines the name of the global object that the state.js API will be bound to. If not specified, state.js will be bound to window.fsm.
3. Create your state machine in another script:
Versioning
The versions are in the form {major}.{minor}.{build}
- Major changes introduce significant new behavior and will update the public API.
- Minor changes introduce features, bug fixes, etc, but note that they also may break the public API.
- Build changes can introduce features, though usually are fixes and performance enhancements; these will never break the public API.
Documentation
Documentation for the public API can be found here.
Licence
state.js is dual-licenecd under the MIT and GPL v3 licences.