xstate-inspection

name	xstate-inspection
description	Covers XState v5 Inspect API and developer tools. Use when debugging actor systems, inspecting state transitions, integrating Stately Inspector, or observing actor lifecycle events and microsteps.

XState v5 Inspection and DevTools

Inspect API

Attach an inspector to observe everything in an actor system:

import { createActor } from 'xstate';

const actor = createActor(machine, {
  inspect: (inspectionEvent) => {
    console.log(inspectionEvent);
  },
});

actor.start();

The inspector receives events for every actor in the system (root + all invoked/spawned children).

Inspection Event Types

@xstate.actor — Actor Created

{
  type: '@xstate.actor',
  actorRef: /* actor reference */,
  rootId: 'x:0',
}

Emitted when any actor in the system is created.

@xstate.event — Event Sent

{
  type: '@xstate.event',
  actorRef: /* target actor */,
  rootId: 'x:0',
  : { : , :  },
  : ,
}