bun-runtime

Runtime Bun

Bun est un runtime et toolkit JavaScript tout-en-un rapide : runtime, gestionnaire de paquets, bundler et exécuteur de tests.

Quand l'utiliser

• Préférez Bun pour : les nouveaux projets JS/TS, les scripts où la vitesse d'installation/exécution est importante, les déploiements Vercel avec le runtime Bun, et quand vous voulez un outillage unique (exécution + installation + tests + build).
• Préférez Node pour : une compatibilité maximale avec l'écosystème, des outils legacy qui supposent Node, ou lorsqu'une dépendance présente des problèmes connus avec Bun.

À utiliser lors de : l'adoption de Bun, la migration depuis Node, l'écriture ou le débogage de scripts/tests Bun, ou la configuration de Bun sur Vercel ou d'autres plateformes.

Comment ça fonctionne

• Runtime : Runtime compatible avec Node en remplacement direct (basé sur JavaScriptCore, implémenté en Zig).
• Gestionnaire de paquets : bun install est significativement plus rapide que npm/yarn. Le fichier de verrouillage est bun.lock (texte) par défaut dans Bun actuel ; les versions plus anciennes utilisaient bun.lockb (binaire).
• Bundler : Bundler et transpileur intégrés pour applications et bibliothèques.
• Exécuteur de tests : bun test intégré avec une API similaire à Jest.

Migration depuis Node : Remplacez node script.js par bun run script.js ou bun script.js. Exécutez bun install à la place de npm install ; la plupart des paquets fonctionnent. Utilisez bun run pour les scripts npm ; bun x pour les exécutions ponctuelles de type npx. Les éléments natifs de Node sont pris en charge ; préférez les API Bun quand elles existent pour de meilleures performances.

Vercel : Définissez le runtime sur Bun dans les paramètres du projet. Build : bun run build ou bun build ./src/index.ts --outdir=dist. Installation : bun install --frozen-lockfile pour des déploiements reproductibles.

Exemples

Exécution et installation

# Installer les dépendances (crée/met à jour bun.lock ou bun.lockb)
bun install

# Exécuter un script ou un fichier
bun run dev
bun run src/index.ts
bun src/index.ts

Scripts et env

bun run --env-file=.env dev
FOO=bar bun run script.ts

Tests

bun test
bun test --watch

// test/example.test.ts
import { expect, test } from "bun:test";

test("add", () => {
  expect(1 + 2).toBe(3);
});

API Runtime

const file = Bun.file("package.json");
const json = await file.json();

Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response("Hello");
  },
});

Bonnes pratiques

• Validez le fichier de verrouillage (bun.lock ou bun.lockb) pour des installations reproductibles.
• Privilégiez bun run pour les scripts. Pour TypeScript, Bun exécute les fichiers .ts nativement.
• Maintenez les dépendances à jour ; Bun et son écosystème évoluent rapidement.