0Pricing
TypeScript Academy · Lekcja

Tworzenie programu TypeScript za pomocą API

Zainicjalizuj program kompilatora i uzyskaj dostęp do modułu sprawdzania typów.

Tworzenie programu TypeScript za pomocą API to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 1 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.

Czym jest Compiler API?

TypeScript udostępnia wewnętrzne mechanizmy kompilatora za pośrednictwem pakietu npm typescript. Można programowo tworzyć programy, analizować checker typów i badać pliki źródłowe.

import ts from "typescript";
// Use ts.createProgram to start

Instalowanie pakietu typescript

Podczas korzystania z Compiler API w narzędziach należy instalować TypeScript jako zwykłą zależność, a nie tylko jako devDependency.

npm install typescript
# Also install types if needed
npm install --save-dev @types/node

Tworzenie programu

ts.createProgram przyjmuje tablicę ścieżek plików wejściowych oraz opcje kompilatora i zwraca obiekt Program.

import ts from "typescript";
const program = ts.createProgram(["src/index.ts"], {
  target: ts.ScriptTarget.ES2020,
  module: ts.ModuleKind.CommonJS,
  strict: true,
});

Uzyskiwanie dostępu do plików źródłowych

Użyj program.getSourceFiles(), aby pobrać wszystkie pliki biorące udział w kompilacji, lub getSourceFile, aby pobrać plik o określonej ścieżce.

const sourceFiles = program.getSourceFiles();
sourceFiles.forEach(sf => {
  if (!sf.isDeclarationFile) {
    console.log(sf.fileName);
  }
});

Uzyskiwanie type checkera

Type checker jest podstawowym elementem analizy TypeScript. Uzyskaj go za pomocą program.getTypeChecker().

const checker = program.getTypeChecker();
// Now use checker to resolve types, symbols, etc.

Odczytywanie diagnostyki

Pobieraj diagnostykę kompilatora — błędy i ostrzeżenia — aby tworzyć własne narzędzia do walidacji.

const diagnostics = ts.getPreEmitDiagnostics(program);
diagnostics.forEach(d => {
  const msg = ts.flattenDiagnosticMessageText(d.messageText, "
");
  console.log(msg);
});

Odczytywanie tsconfig.json

Użyj ts.readConfigFile i ts.parseJsonConfigFileContent, aby wczytać opcje kompilatora z pliku tsconfig.

const cfgFile = ts.readConfigFile("tsconfig.json", ts.sys.readFile);
const parsed = ts.parseJsonConfigFileContent(
  cfgFile.config,
  ts.sys,
  process.cwd()
);
const program2 = ts.createProgram(parsed.fileNames, parsed.options);

Rozwiązywanie symboli

Type checker może rozwiązywać symbole — nazwy odnoszące się do deklaracji — aby ustalić, na co wskazuje dany identyfikator.

const sf = program.getSourceFile("src/index.ts")!;
ts.forEachChild(sf, node => {
  if (ts.isVariableStatement(node)) {
    const symbol = checker.getSymbolAtLocation(
      node.declarationList.declarations[0].name
    );
    console.log(symbol?.getName());
  }
});

Generowanie wyników

Wywołaj program.emit(), aby wygenerować pliki JavaScript i pliki deklaracji, tak jak podczas uruchamiania tsc.

const emitResult = program.emit();
const exitCode = emitResult.emitSkipped ? 1 : 0;
process.exit(exitCode);

Programy przyrostowe

Użyj ts.createIncrementalProgram, aby przyspieszyć powtarzaną analizę przez ponowne wykorzystanie stanu poprzedniej kompilacji.

// Incremental compilation tracks which files changed
// to avoid reprocessing unchanged files

Podsumowanie: podstawy Compiler API

Compiler API TypeScript pozwala tworzyć programy, analizować pliki źródłowe, odpytywać o typy za pomocą type checkera i generować kod JavaScript — wszystko z poziomu kodu Node.js.

Szybkie sprawdzenie

Jaka metoda zwraca type checker TypeScriptu z programu?

Czego się nauczyłeś

Praca z Compiler API TypeScript rozpoczyna się od ts.createProgram. Z programu można uzyskać dostęp do plików źródłowych, type checkera i diagnostyki oraz generować wyniki — to podstawa tworzenia linterów, generatorów kodu i narzędzi analitycznych.

Często zadawane pytania

Czy lekcja „Tworzenie programu TypeScript za pomocą API” jest bezpłatna?

Tak — pełny tekst „Tworzenie programu TypeScript za pomocą API” 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 „Tworzenie programu TypeScript za pomocą API”?

Zainicjalizuj program kompilatora i uzyskaj dostęp do modułu sprawdzania typów. Ć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 1 z 4.

Ile czasu zajmuje lekcja „Tworzenie programu TypeScript za pomocą API”?

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. Tworzenie programu TypeScript za pomocą API
  2. Przechodzenie po AST za pomocą odwiedzających
  3. Niestandardowe transformatory i generowanie kodu
  4. Budowanie prostego narzędzia do lintowania
← Powrót do TypeScript Academy