0Pricing
TypeScript Academy · 강의

API로 TypeScript 프로그램 만들기

컴파일러 프로그램을 초기화하고 형식 검사기에 접근합니다.

API로 TypeScript 프로그램 만들기은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

컴파일러 인터페이스란 무엇인가요

TypeScript는 typescript npm 패키지를 통해 컴파일러 내부 기능을 제공합니다. 프로그래밍 방식으로 프로그램을 만들고, 타입 검사기를 검사하며, 소스 파일을 분석할 수 있습니다.

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

typescript 패키지 설치

도구에서 컴파일러 인터페이스를 사용할 때는 TypeScript를 개발 시에만 필요한 의존성이 아니라 일반 의존성으로 설치하세요.

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

프로그램 만들기

ts.createProgram은 진입점 파일 경로 배열과 컴파일러 옵션을 받아 Program 객체를 반환합니다.

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

소스 파일에 접근하기

program.getSourceFiles()를 사용하면 컴파일에 포함된 모든 파일을 가져올 수 있고, 특정 경로의 파일은 getSourceFile로 가져올 수 있습니다.

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

타입 검사기 가져오기

타입 검사기는 TypeScript 분석의 핵심입니다. program.getTypeChecker()로 가져오세요.

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

진단 정보 읽기

사용자 지정 검증 도구를 만들려면 컴파일러 진단 정보인 오류와 경고를 가져오세요.

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

tsconfig.json 읽기

ts.readConfigFile과 ts.parseJsonConfigFileContent를 사용하여 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);

심벌 확인

타입 검사기는 선언을 가리키는 이름인 심벌을 확인하여 특정 식별자가 무엇을 가리키는지 검사할 수 있습니다.

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

출력 생성하기

program.emit()을 호출하면 tsc를 실행하는 것처럼 JavaScript와 선언 파일을 생성할 수 있습니다.

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

증분 프로그램

ts.createIncrementalProgram을 사용하면 이전 빌드 상태를 재사용하여 반복 분석을 더 빠르게 수행할 수 있습니다.

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

복습: 컴파일러 인터페이스 기초

TypeScript 컴파일러 인터페이스를 사용하면 Node.js 코드만으로 프로그램을 만들고, 소스 파일을 검사하고, 타입 검사기를 통해 타입을 조회하고, JavaScript를 생성할 수 있습니다.

빠른 확인

프로그램에서 TypeScript 타입 검사기를 반환하는 메서드는 무엇인가요?

배운 내용

TypeScript 컴파일러 인터페이스는 ts.createProgram에서 시작합니다. 프로그램에서 소스 파일, 타입 검사기, 진단 정보에 접근하고 출력을 생성할 수 있으며, 이는 린터, 코드 생성기, 분석 도구를 만드는 기반이 됩니다.

자주 묻는 질문

“API로 TypeScript 프로그램 만들기” 강의는 무료인가요?

네 — “API로 TypeScript 프로그램 만들기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“API로 TypeScript 프로그램 만들기”에서 뭘 배우나요?

컴파일러 프로그램을 초기화하고 형식 검사기에 접근합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“API로 TypeScript 프로그램 만들기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. API로 TypeScript 프로그램 만들기
  2. 방문자로 AST 순회하기
  3. 사용자 정의 변환기 및 코드 생성
  4. 간단한 린팅 도구 만들기
← TypeScript Academy(으)로 돌아가기