Bun 의 내장 API 에 대한 TypeScript 정의를 설치하려면 @types/bun 을 설치하세요.

bun add -d @types/bun # 개발 의존성

이 시점에서 편집기에서 오류 없이 TypeScript 파일에서 Bun 전역을 참조할 수 있어야 합니다.

console.log(Bun.version);

권장 compilerOptions

Bun 은 TypeScript 가 기본적으로 허용하지 않는 최상위 await, JSX, .ts 확장자 import 와 같은 기능을 지원합니다. 아래는 Bun 프로젝트에 권장되는 compilerOptions 세트로, TypeScript 의 컴파일러 경고 없이 이러한 기능을 사용할 수 있습니다.

{
  "compilerOptions": {
    // 환경 설정 및 최신 기능
    "lib": ["ESNext"],
    "target": "ESNext",
    "module": "Preserve",
    "moduleDetection": "force",
    "jsx": "react-jsx",
    "allowJs": true,

    // 번들러 모드
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "verbatimModuleSyntax": true,
    "noEmit": true,

    // 모범 사례
    "strict": true,
    "skipLibCheck": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,

    // 일부 더 엄격한 플래그 (기본적으로 비활성화됨)
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noPropertyAccessFromIndexSignature": false,
  },
}

새 디렉터리에서 bun init 을 실행하면 이 tsconfig.json 이 생성됩니다. (더 엄격한 플래그는 기본적으로 비활성화되어 있습니다.)

bun init