Skip to content

State containers

State containers are Redux-store-like objects meant to help you manage state in your services or apps.

  • State containers are strongly typed, you will get TypeScript autocompletion suggestions from your editor when accessing state, executing transitions and using React helpers.
  • State containers can be easily hooked up with your React components.
  • State containers can be used without React, too.
  • State containers provide you central place where to store state, instead of spreading state around multiple RxJs observables, which you need to coordinate. With state container you can always access the latest state snapshot synchronously.
  • Unlike Redux, state containers are less verbose, see example below.

Example

import { createStateContainer } from 'src/plugins/opensearch_dashboards_utils';

const container = createStateContainer(
  { count: 0 },
  {
    increment: (state: { count: number }) => (by: number) => ({ count: state.count + by }),
    double: (state: { count: number }) => () => ({ count: state.count * 2 }),
  },
  {
    count: (state: { count: number }) => () => state.count,
  }
);

container.transitions.increment(5);
container.transitions.double();

console.log(container.selectors.count()); // 10

Demos

See demos here.

You can run them with

npx -q ts-node src/plugins/opensearch_dashboards_utils/demos/state_containers/counter.ts
npx -q ts-node src/plugins/opensearch_dashboards_utils/demos/state_containers/todomvc.ts

Reference