Pour installer les définitions TypeScript pour les API intégrées de Bun, installez @types/bun.

bun add -d @types/bun # dépendance de développement

À ce stade, vous devriez pouvoir référencer le global Bun dans vos fichiers TypeScript sans voir d'erreurs dans votre éditeur.

console.log(Bun.version);

compilerOptions suggérés

Bun prend en charge des fonctionnalités telles que l'await de haut niveau, JSX et les imports .ts avec extension, que TypeScript n'autorise pas par défaut. Ci-dessous se trouve un ensemble de compilerOptions recommandés pour un projet Bun, afin que vous puissiez utiliser ces fonctionnalités sans voir d'avertissements du compilateur TypeScript.

{
  "compilerOptions": {
    // Configuration de l'environnement et dernières fonctionnalités
    "lib": ["ESNext"],
    "target": "ESNext",
    "module": "Preserve",
    "moduleDetection": "force",
    "jsx": "react-jsx",
    "allowJs": true,

    // Mode Bundler
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "verbatimModuleSyntax": true,
    "noEmit": true,

    // Bonnes pratiques
    "strict": true,
    "skipLibCheck": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,

    // Certains drapeaux plus stricts (désactivés par défaut)
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noPropertyAccessFromIndexSignature": false,
  },
}

Si vous exécutez bun init dans un nouveau répertoire, ce fichier tsconfig.json sera généré pour vous. (Les drapeaux plus stricts sont désactivés par défaut.)

bun init