Konwersja JSON na TypeScript: Przewodnik po typach i interfejsach

# Konwersja JSON na TypeScript: Przewodnik po typach i interfejsach

Używanie typów TypeScript podczas pracy z danymi JSON znacząco poprawia bezpieczeństwo kodu. Dzięki nim Twoje IDE (np. VS Code) może podpowiadać nazwy pól i ostrzegać o błędach jeszcze przed uruchomieniem aplikacji.

Szybki przykład

Dane JSON:

{
  "id": 1,
  "imie": "Alicja",
  "aktywny": true
}

Interfejs TypeScript:

interface Uzytkownik {
  id: number;
  imie: string;
  aktywny: boolean;
}

---

Polecane narzędzia

Ręczne przepisywanie dużych plików JSON na interfejsy jest żmudne. Skorzystaj z:

quicktype.io: Najpopularniejsze narzędzie webowe. Wklejasz JSON, wybierasz język TypeScript i otrzymujesz gotowy kod.

Transform (rozszerzenie VS Code): Pozwala na szybką konwersję bezpośrednio w edytorze.

---

Walidacja w czasie rzeczywistym (Zod)

Typy TypeScript znikają po skompilowaniu kodu do JavaScript. Aby mieć pewność, że dane z API są poprawne podczas działania programu, warto użyć biblioteki Zod.

import { z } from 'zod';

const SchematUzytkownika = z.object({
  id: z.number(),
  imie: z.string(),
  aktywny: z.boolean()
});

// Automatyczne wyprowadzenie typu TypeScript
type Uzytkownik = z.infer<typeof SchematUzytkownika>;

// Walidacja danych przychodzących
const wynik = SchematUzytkownika.safeParse(daneZApi);

---

Kiedy używać Interface, a kiedy Type?

• Interface: Idealny dla opisania kształtu obiektów, które mogą być rozszerzane.
• Type: Lepszy dla typów złożonych, unii (np. "aktywny" | "nieaktywny") oraz prostych aliasów.

Podsumowanie

Konwersja JSON na TypeScript to standard w nowoczesnym programowaniu. Używaj narzędzi do automatycznego generowania typów, ale nie zapominaj o walidacji runtime, aby Twoja aplikacja była w pełni odporna na błędy w danych zewnętrznych.