TypeScript Academy · Lekcja

XState: typowane maszyny stanów

Modeluj maszyny stanów za pomocą TypeScript w XState.

Lekcja 3 z 413 kroki

XState: typowane maszyny stanów to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Dlaczego warto używać XState z TypeScript

XState modeluje stan aplikacji jako jawne maszyny stanów. Dzięki TypeScript stany, zdarzenia i kontekst są w pełni typowane, co zapobiega nieprawidłowym przejściom między stanami już na etapie kompilacji.

import { createMachine, assign } from "xstate";

Definiowanie typów maszyny

XState v5 używa parametrów typów dla kontekstu, zdarzeń i stanów. Zdefiniuj je przed utworzeniem maszyny.

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

Tworzenie typowanej maszyny

Przekaż typy kontekstu i zdarzeń do createMachine, aby w pełni sprawdzać typy stanów i przejść.

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" } },
  },
});

Typowany kontekst z assign

Użyj assign do aktualizowania kontekstu — TypeScript sprawdzi, czy zwracany częściowy kontekst odpowiada zdefiniowanemu typowi.

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

Używanie maszyny w React

Hook useMachine z @xstate/react zwraca typowany stan i funkcję send.

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>;
}

Typowane guardy

Funkcje guardów otrzymują typowany kontekst i zdarzenie, dzięki czemu warunki są sprawdzane względem właściwych typów.

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

Typowane akcje

Named actions można typować, deklarując je w konfiguracji maszyny i implementując za pomocą setup.

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

Stany równoległe

XState obsługuje równoległe (ortogonalne) regiony. TypeScript śledzi wartości stanów równoległych jako obiekty.

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

Dopasowywanie stanów

Użyj state.matches(), aby sprawdzić bieżący stan — XState typuje tę metodę dla znanych nazw stanów.

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

XState Inspector

Połącz XState Inspector, aby wizualnie debugować maszyny stanów podczas pracy nad aplikacją, bez utraty bezpieczeństwa typów w kodzie produkcyjnym.

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

Podsumowanie: typowanie XState

Typowane maszyny XState definiują typy kontekstu i zdarzeń, używają assign do typowanych aktualizacji kontekstu i integrują się z React za pomocą useMachine, zapewniając w pełni typowany stan i wysyłanie zdarzeń.

Szybkie sprawdzenie

Do czego służy właściwość types w konfiguracji maszyny XState v5?

Czego się Państwo nauczyli

XState z TypeScript zapewnia w pełni typowane maszyny stanów: należy definiować typy kontekstu i zdarzeń, używać assign do typowanych aktualizacji oraz typować warunki i akcje. Hook useMachine udostępnia typowany stan i wysyłanie zdarzeń w komponentach React.

Bezpłatny start

Ucz się TypeScript dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy
101
Lekcje
352

Często zadawane pytania

Czy lekcja „XState: typowane maszyny stanów” jest bezpłatna?

Tak — pełny tekst „XState: typowane maszyny stanów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „XState: typowane maszyny stanów”?

Modeluj maszyny stanów za pomocą TypeScript w XState. Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „XState: typowane maszyny stanów”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Typowanie slice’ów i thunków Redux Toolkit
  2. Wzorce typowania store’ów Zustand
  3. XState: typowane maszyny stanów
  4. Stan pochodny i selektory z typami
← Powrót do TypeScript Academy