0Pricing
TypeScript Academy · Lektion

XState: typisierte Zustandsautomaten

Modellieren Sie Zustandsautomaten mit TypeScript in XState.

XState: typisierte Zustandsautomaten ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Warum XState mit TypeScript?

XState modelliert den Anwendungs-State als explizite Zustandsautomaten. Mit TypeScript sind Zustände, Events und Kontext vollständig typisiert, sodass ungültige Zustandsübergänge bereits zur Compile-Zeit verhindert werden.

import { createMachine, assign } from "xstate";

Maschinentypen definieren

XState v5 verwendet Typparameter für Kontext, Events und Zustände. Definieren Sie diese, bevor Sie die Maschine erstellen.

type TrafficContext = { count: number };
type TrafficEvent =
  | { type: "TURN_GREEN" }
  | { type: "TURN_YELLOW" }
  | { type: "TURN_RED" };

Eine typisierte Maschine erstellen

Übergeben Sie Ihre Kontext- und Event-Typen an createMachine, um Zustände und Übergänge vollständig prüfen zu lassen.

const trafficMachine = createMachine({
  types: {} as { context: TrafficContext; events: TrafficEvent },
  id: "traffic",
  initial: "red",
  context: { count: 0 },
  states: {
    red:    { on: { TURN_GREEN: "green" } },
    green:  { on: { TURN_YELLOW: "yellow" } },
    yellow: { on: { TURN_RED: "red" } },
  },
});

Typisierter Kontext mit assign

Verwenden Sie assign, um den Kontext zu aktualisieren – TypeScript stellt sicher, dass der zurückgegebene partielle Kontext dem definierten Typ entspricht.

const machine = createMachine({
  types: {} as { context: TrafficContext; events: TrafficEvent },
  // ...
  entry: assign({ count: 0 }),
  on: {
    TURN_GREEN: {
      actions: assign(({ context }) => ({ count: context.count + 1 })),
    },
  },
});

Die Maschine in React verwenden

Der useMachine-Hook aus @xstate/react gibt einen typisierten State und eine typisierte send-Funktion zurück.

import { useMachine } from "@xstate/react";

function TrafficLight() {
  const [state, send] = useMachine(trafficMachine);
  // state.value: "red" | "green" | "yellow"
  // send: (event: TrafficEvent) => void
  return <button onClick={() => send({ type: "TURN_GREEN" })}>Go</button>;
}

Typisierte Guards

Guard-Funktionen erhalten typisierten Kontext und typisierte Events, sodass Bedingungen anhand der korrekten Typen geprüft werden.

const machine = createMachine({
  types: {} as { context: TrafficContext; events: TrafficEvent },
  states: {
    red: {
      on: {
        TURN_GREEN: {
          guard: ({ context }) => context.count < 10, // context: TrafficContext
          target: "green",
        },
      },
    },
  },
});

Typisierte Aktionen

Benannte Aktionen können typisiert werden, indem Sie sie in der Maschinenkonfiguration deklarieren und über setup implementieren.

import { setup } from "xstate";
const machine = setup({
  types: {} as { context: TrafficContext; events: TrafficEvent },
  actions: {
    logTransition: ({ context, event }) => {
      console.log(context.count, event.type);
    },
  },
}).createMachine({ /* ... */ });

Parallele Zustände

XState unterstützt parallele (orthogonale) Bereiche. TypeScript verfolgt die Zustandswerte paralleler Zustände als Objekte.

states: {
  ui: {
    type: "parallel",
    states: {
      modal: { initial: "closed", states: { closed: {}, open: {} } },
      tooltip: { initial: "hidden", states: { hidden: {}, visible: {} } },
    },
  },
}

Zustandsabgleich

Verwenden Sie state.matches(), um den aktuellen Zustand zu prüfen – XState typisiert diesen Aufruf für bekannte Zustandsnamen.

const [state] = useMachine(trafficMachine);
if (state.matches("green")) {
  // TypeScript knows we're in the green state
}

XState Inspector

Verbinden Sie den XState Inspector für visuelles Debugging von Zustandsautomaten während der Entwicklung, ohne die Typsicherheit im Produktionscode zu verlieren.

import { inspect } from "@xstate/inspect";
inspect({ iframe: false }); // opens state machine inspector

Zusammenfassung: XState-Typisierung

Typisierte XState-Maschinen definieren Kontext- und Event-Typen, verwenden assign für typisierte Kontextaktualisierungen und werden über useMachine für vollständig typisierten State und Event-Versand in React integriert.

Kurzer Check

Welche Funktion hat die Eigenschaft types in der XState-v5-Maschinenkonfiguration?

Das haben Sie gelernt

XState mit TypeScript bietet vollständig typisierte Zustandsautomaten: Definieren Sie Kontext- und Event-Typen, verwenden Sie assign für typisierte Aktualisierungen, Guards und Aktionen. Der useMachine-Hook stellt in React-Komponenten typisierten State und typisierten Event-Versand bereit.

Häufig gestellte Fragen

Ist die Lektion „XState: typisierte Zustandsautomaten“ kostenlos?

Ja — der vollständige Text von „XState: typisierte Zustandsautomaten“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „XState: typisierte Zustandsautomaten“?

Modellieren Sie Zustandsautomaten mit TypeScript in XState. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um TypeScript Academy zu starten?

Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.

Wie lange dauert die Lektion „XState: typisierte Zustandsautomaten“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?

Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Redux-Toolkit-Slices und Thunks typisieren
  2. Muster zur Typisierung von Zustand-Stores
  3. XState: typisierte Zustandsautomaten
  4. Abgeleiteter State und Selektoren mit Typen
← Zurück zu TypeScript Academy