Kompilowanie TypeScriptu do JavaScriptu

Witamy

Instalowanie kompilatora TypeScript

npm install --save-dev typescript
npx tsc --version

Pierwsza kompilacja za pomocą tsc

// hello.ts
function greet(name: string): string {
  return 'Hello, ' + name;
}
console.log(greet('World'));

// Compile: npx tsc hello.ts
// Output: hello.js (no types)

tsconfig.json: konfiguracja projektu

npx tsc --init
// Creates tsconfig.json with defaults and comments

Najważniejsze opcje tsconfig

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "strict": true
  }
}

Tryb obserwowania za pomocą tsc --watch

npx tsc --watch
// Watches for changes and recompiles on save

noEmit: sprawdzanie typów bez tworzenia plików

// tsconfig.json
{ "compilerOptions": { "noEmit": true } }

// Then run:
npx tsc --noEmit

Szybsze alternatywy: ts-node i tsx

# Run TS directly with ts-node
npx ts-node src/index.ts

# Or faster with tsx
npx tsx src/index.ts

Mapy źródeł na potrzeby debugowania

{ "compilerOptions": { "sourceMap": true } }

Pliki deklaracji (.d.ts)

{ "compilerOptions": { "declaration": true } }
// Outputs: dist/index.js AND dist/index.d.ts

Błędy kompilatora domyślnie nie blokują generowania plików

{ "compilerOptions": { "noEmitOnError": true } }

Szybkie sprawdzenie

Podsumowanie