Debugger

bun --inspect run app.ts

bun --inspect run server.ts

bun --inspect-wait run app.ts

bun --inspect-brk run app.ts

bun --inspect=9229 run app.ts
bun --inspect=0.0.0.0:9229 run app.ts # Listen on all interfaces

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Bun",
      "runtimeExecutable": "bun",
      "runtimeArgs": ["run", "--inspect-wait"],
      "program": "${workspaceFolder}/src/index.ts",
      "console": "integratedTerminal",
      "skipFiles": ["<node_internals>/**"],
      "smartStep": true,
      "sourceMaps": true
    }
  ]
}

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Bun",
      "port": 6499,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "resolveSourceMapLocations": [
        "${workspaceFolder}/**",
        "!**/node_modules/**"
      ]
    }
  ]
}

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Current File",
      "runtimeExecutable": "bun",
      "runtimeArgs": ["run", "--inspect-wait"],
      "program": "${file}",
      "console": "integratedTerminal"
    }
  ]
}

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Tests",
      "runtimeExecutable": "bun",
      "runtimeArgs": ["test", "--inspect-wait"],
      "console": "integratedTerminal",
      "skipFiles": ["<node_internals>/**"]
    }
  ]
}

function calculate(a: number, b: number) {
  const sum = a + b; // Click gutter to set breakpoint
  console.log(`Sum: ${sum}`);
  return sum;
}

for (let i = 0; i < 100; i++) {
  // Right-click gutter > Add Conditional Breakpoint
  // Condition: i === 50
  console.log(i);
}

function process(data: any) {
  // Right-click gutter > Add Logpoint
  // Message: Processing {data.id}
  return transform(data);
}

function debug() {
  // Pause execution when debugger attached
  debugger;
  console.log("After breakpoint");
}

function outer() {
  inner();
}

function inner() {
  debugger; // Pause here - see outer() in call stack
  console.log("Inner");
}

outer();

function example() {
  const user = { id: 1, name: "Alice" };
  const items = [1, 2, 3, 4, 5];
  
  debugger; // Hover over variables to inspect
  
  console.log(user, items);
}

let count = 0;

function increment() {
  count++; // Add watch: count, count * 2
  debugger;
}

for (let i = 0; i < 5; i++) {
  increment();
}

function test() {
  const x = 10;
  const y = 20;
  
  debugger;
  // In console: x + y, Math.max(x, y)
  
  return x + y;
}

interface User {
  id: number;
  name: string;
}

function greet(user: User): string {
  return `Hello, ${user.name}!`;
}

greet({ id: 1, name: "Alice" });

// JavaScript output with inline source map
function greet(user) {
  return `Hello, ${user.name}!`;
}
//# sourceMappingURL=data:application/json;base64,...

bun build app.ts --sourcemap=external

async function fetchUser(id: number) {
  debugger; // Breakpoint before await
  
  const response = await fetch(`/api/users/${id}`);
  
  debugger; // Breakpoint after await
  
  const user = await response.json();
  return user;
}

fetchUser(1);

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug",
      "runtimeExecutable": "bun",
      "runtimeArgs": ["run", "--inspect-wait"],
      "program": "${workspaceFolder}/src/index.ts",
      "stopOnEntry": false,
      "console": "integratedTerminal",
      // Break on all exceptions
      "breakOnException": true
    }
  ]
}

# On remote server
bun --inspect=0.0.0.0:6499 run app.ts

# On local machine
ssh -L 6499:localhost:6499 user@remote-server

bun --inspect=0.0.0.0:6499 run app.ts

set_breakpoint_on_first_line: bool = false,

# Terminal 1
bun --inspect=6499 run server.ts

# Terminal 2  
bun --inspect=6500 run worker.ts

const worker = new Worker("worker.ts");

// worker.ts
console.log("Worker started");
debugger; // Pause in worker context

bun --inspect-brk test math.test.ts

import { serve } from "bun";

serve({
  port: 3000,
  fetch(req) {
    debugger; // Pause on each request
    return new Response("Hello!");
  },
});

bun --inspect-wait run cli.ts --arg1 --arg2

bun --inspect-wait run build.ts

lsof -i :6499  # macOS/Linux
netstat -ano | findstr :6499  # Windows

rm -rf ~/.bun/install/cache

{
  "resolveSourceMapLocations": [
    "${workspaceFolder}/**",
    "!**/node_modules/**"
  ]
}