Test Command

# Run all tests (component and e2e) - default behavior
elizaos test

# Explicitly run all tests
elizaos test --type all

# Run only component tests
elizaos test --type component

# Run only end-to-end tests
elizaos test --type e2e

# Test a specific project or plugin path
elizaos test ./plugins/my-plugin

# Filter component tests by name
elizaos test --type component --name auth

# Filter e2e tests by name  
elizaos test --type e2e --name database

# Filter all tests by name (case sensitive)
elizaos test --name plugin

# Run tests on custom port for e2e
elizaos test --type e2e --port 4000

# Skip building before running tests
elizaos test --skip-build

# Skip type checking for faster test runs
elizaos test --skip-type-check

# Combine options
elizaos test --type e2e --port 3001 --name integration --skip-build

// __tests__/myPlugin.test.ts
import { describe, it, expect } from 'vitest';
import { MyPlugin } from '../src/myPlugin';

describe('MyPlugin', () => {
  it('should initialize correctly', () => {
    const plugin = new MyPlugin();
    expect(plugin.name).toBe('MyPlugin');
  });

  it('should handle actions', async () => {
    const plugin = new MyPlugin();
    const result = await plugin.handleAction('test');
    expect(result).toBeDefined();
  });
});

// e2e/agent-flow.test.ts
import { createTestAgent } from '@elizaos/core/test-utils';

describe('Agent Flow', () => {
  it('should respond to messages', async () => {
    const agent = await createTestAgent({
      character: './test-character.json'
    });

    const response = await agent.sendMessage('Hello');
    expect(response).toContain('Hi');
  });
});

import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    globals: true,
    environment: 'node',
    include: ['__tests__/**/*.test.ts'],
  },
});

# Set test environment
export TEST_ENV=ci
export TEST_PORT=3001

# Run E2E tests
elizaos test --type e2e

# Run tests (coverage generation depends on your test configuration)
elizaos test

# Note: Coverage reporting is handled by your test framework configuration,
# not by the CLI directly. Configure coverage in your vitest.config.ts

name: Tests
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: oven-sh/setup-bun@v1
      
      - name: Install dependencies
        run: bun install
      
      - name: Run tests
        run: elizaos test
      
      - name: Upload coverage
        uses: codecov/codecov-action@v3

import { createMockRuntime } from '@elizaos/core/test-utils';

describe('MyPlugin', () => {
  let runtime;

  beforeEach(() => {
    runtime = createMockRuntime();
  });

  it('should register actions', () => {
    const plugin = new MyPlugin();
    plugin.init(runtime);
    
    expect(runtime.actions).toContain('myAction');
  });
});

describe('MyAction', () => {
  it('should validate input', async () => {
    const action = new MyAction();
    const isValid = await action.validate({
      text: 'test input'
    });
    
    expect(isValid).toBe(true);
  });
});

import { mockCharacter, mockMessage } from '@elizaos/core/test-utils';

describe('Message Handler', () => {
  it('should process messages', async () => {
    const character = mockCharacter({
      name: 'TestBot'
    });
    
    const message = mockMessage({
      text: 'Hello',
      userId: 'user123'
    });
    
    const response = await handler.process(message, character);
    expect(response).toBeDefined();
  });
});

# Run with detailed logging
LOG_LEVEL=debug elizaos test

# Show test execution details
elizaos test --verbose

# Run a single test file (case sensitive)
elizaos test component --name specific-test

# Run tests matching a pattern (case sensitive)
elizaos test --name "auth|user"

# Important: Test name matching is case sensitive
# Use exact casing from your test file names

{
  "type": "node",
  "request": "launch",
  "name": "Debug Tests",
  "runtimeExecutable": "bun",
  "runtimeArgs": ["test"],
  "cwd": "${workspaceFolder}",
  "console": "integratedTerminal"
}

# Check for TypeScript errors first
bun run build

# Run tests with more verbose output
elizaos test --verbose

# Skip type checking if types are causing issues
elizaos test --skip-type-check

# E2E tests failing due to port in use
# Use a different port
elizaos test e2e --port 4001

# Or kill the process using the port
lsof -ti:3000 | xargs kill -9

# If tests fail due to build issues
# Clean and rebuild
rm -rf dist
bun run build
elizaos test

# Or skip build if testing source files
elizaos test --skip-build

# If watch mode isn't detecting changes
# Check that you're modifying files in watched directories
# Restart watch mode
elizaos test --watch

# Or use Vitest directly for component tests
bunx vitest --watch

# If coverage seems incorrect
# Clear coverage data
rm -rf coverage

# Regenerate coverage
elizaos test --coverage

# Check coverage config in vitest.config.ts

# Set test environment variables
export NODE_ENV=test
export TEST_TIMEOUT=30000

# Or create a test .env file
cp .env.example .env.test
elizaos test