Konfiguracja z tsconfig.json

Plik tsconfig.json definiuje katalog główny projektu TypeScript i określa opcje kompilacji wymagane do skompilowania projektu.

Po uruchomieniu polecenia tsc w katalogu projektu kompilator wyszukuje ten plik, aby określić swoje zachowanie.

Struktura pliku tsconfig.json

Typowy plik konfiguracji wygląda następująco:

{
  "compilerOptions": {
    "target": "es2022",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "outDir": "./dist"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "**/*.spec.ts"]
}

Główne klucze to:

• compilerOptions: Ustawienia kompilatora.
• include: Pliki lub katalogi, które powinny zostać skompilowane.
• exclude: Pliki lub katalogi do zignorowania podczas kompilacji.

Kluczowe opcje kompilatora

Oto najważniejsze opcje, które warto znać:

1. target: Określa wersję JavaScript generowaną na wyjściu (np. es5, es6/es2015, es2020, esnext).
2. module: Określa system modułów, który ma być używany w plikach wyjściowych (np. commonjs, esnext, node16).
3. strict: Włącza szeroką gamę rygorystycznych kontroli typów. Zdecydowanie zaleca się ustawienie tej opcji na true w celu maksymalizacji bezpieczeństwa kodu. Włącza ona opcje takie jak:
   • noImplicitAny: Generuje błąd, jeśli brakuje adnotacji typu dla parametrów, które w przeciwnym razie zostałyby wydedukowane jako any.
   • strictNullChecks: Zapobiega przypisywaniu wartości null lub undefined do typów, które nie przewidują ich jawnie w swojej unii.

Spróbuj sam

Ćwiczenie 1: Obsługa strictNullChecks

Ćwiczenie 2: Rygorystyczne typowanie bez Implicit Any