testing-patterns

Testing Patterns for Bun Test

🔍 Code Searchability Patterns

Find Testing Issues with ast-grep

# Find incorrect test imports (should use bun:test)
ast-grep --pattern 'import { describe, test, expect } from "vitest"' tests/
ast-grep --pattern 'import { describe, test, expect } from "@jest/globals"' tests/
sg -p 'from "vitest"' tests/
sg -p 'from "@jest/globals"' tests/

# Find missing process cleanup
ast-grep --pattern 'Bun.spawn($$$)' tests/
sg -p 'Bun.spawn' tests/

# Find missing afterEach cleanup
ast-grep --pattern 'afterEach($$$)' tests/
sg -p 'afterEach' tests/

# Find test files without proper structure
ast-grep --pattern 'describe($$$)' tests/
sg -p 'describe' tests/

# Find timeout issues
ast-grep --pattern 'timeout: $NUM' tests/
sg -p 'timeout:' tests/

Testing Discovery Commands

# Find all test files
find tests/ -name "*.test.ts" -o -name "*.spec.ts"

# Find test patterns
sg search 'describe(' tests/
sg search 'test(' tests/
sg search 'expect(' tests/

# Find test utilities
sg search 'processManager' tests/
sg search 'createMockEnv' tests/

Test Structure

Use Proper Imports

// ✅ CORRECT - Bun test imports
import { describe, test, expect, beforeEach, afterEach, beforeAll, afterAll } from 'bun:test';

// ❌ WRONG - Don't use Vitest/Jest
import { describe, test, expect } from 'vitest';
import { describe, test, expect } from '@jest/globals';

Process Cleanup in Tests

ALWAYS cleanup spawned processes:

import processManager from '../utils/process-cleanup';

describe('My Test Suite', () => {
  // Cleanup after EACH test
  afterEach(async () => {
    await processManager.killAll(3000);
  });
  
  // Or cleanup after ALL tests
  afterAll(async () => {
    await processManager.killAll(3000);
  });
});

Test Timeouts

Global Timeout (bunfig.toml)

[test]
timeout = 10000  # 10 seconds default

Per-Test Timeout

test('long running test', async () => {
  // Test code
}, { timeout: 30000 }); // 30 seconds