rustfs-console/tests

Config Helpers Test Suite

This is a comprehensive test suite for the config-helpers.ts module, including unit tests, integration tests, performance tests, and edge case tests.

Test Structure

tests/
├── setup.ts                                    # Test environment setup
├── utils/
│   ├── config-helpers.test.ts                 # Main unit tests
│   ├── config-helpers.integration.test.ts     # Integration tests and edge cases
│   ├── config-helpers.performance.test.ts     # Performance and stress tests
│   └── test-helpers.ts                        # Test utilities and Mock functions
└── README.md                                   # This file

Installing Test Dependencies

# Install test dependencies
npm install --save-dev vitest jsdom @vitest/ui c8

# Or using yarn
yarn add --dev vitest jsdom @vitest/ui c8

Running Tests

Basic Test Commands

# Run all tests
npm run test

# Run tests and generate coverage report
npm run test:coverage

# Run test UI interface
npm run test:ui

# Run tests once (CI mode)
npm run test:run

Targeted Tests

# Run only config-helpers related tests
npm run test:config-helpers

# Run only performance tests
npm run test:performance

# Run only integration tests
npm run test:integration

# Run specific test file
npx vitest tests/utils/config-helpers.test.ts

# Run specific test case
npx vitest -t "getCurrentBrowserConfig"

Test Coverage

1. Unit Tests (config-helpers.test.ts)

• ✅ createDefaultConfig: Default configuration creation
• ✅ getCurrentBrowserConfig: Browser configuration retrieval
• ✅ getStoredHostConfig: localStorage configuration retrieval
• ✅ fetchConfigFromServer: Server configuration retrieval and merging
• ✅ getConfig: Smart configuration strategy
• ✅ saveHostConfig: Configuration saving
• ✅ clearStoredHostConfig: Configuration clearing
• ✅ validateConfig: Configuration validation
• ✅ getConfigSources: Debug information retrieval
• ✅ Legacy Functions: Backward compatibility functions

2. Integration Tests (config-helpers.integration.test.ts)

• ✅ Complete Configuration Flow: Save → Retrieve → Validate → Clear
• ✅ Configuration Priority: server > localStorage > browser > default
• ✅ Edge Cases: Extreme URLs, special characters, error handling
• ✅ Concurrent Operations: Race conditions, concurrent read/write
• ✅ Cross-browser Compatibility: Behavior in different environments
• ✅ Error Recovery: Network errors, JSON parsing errors, storage exceptions

3. Performance Tests (config-helpers.performance.test.ts)

• ✅ Single Function Performance: Execution time benchmarks
• ✅ Batch Operations: Large data processing capability
• ✅ Concurrent Performance: Stability under high concurrency
• ✅ Memory Management: Memory leak detection
• ✅ Network Performance: Slow network, timeout handling
• ✅ Stress Tests: Performance under extreme load

Test Utilities (test-helpers.ts)

Mock Utilities

• BrowserMock: Mock browser environment and window.location
• LocalStorageMock: Mock localStorage behavior and exceptions
• FetchMock: Mock various network response scenarios

Data Generators

• createTestConfig: Generate test configuration objects
• createTestServerResponse: Generate server response data
• generateUrlTestCases: Generate URL test cases
• generateConfigTestCases: Generate configuration test cases

Performance Utilities

• measureExecutionTime: Measure function execution time
• runBatchTest: Execute tests in batch
• TestCleaner: Test environment cleanup

Assertion Helpers

• expectValidConfig: Validate configuration object structure
• expectValidConfigResult: Validate ConfigResult structure
• expectErrorResult: Validate error results

Test Scenarios

Normal Flow Tests

1. Configuration Creation: Verify correctness of default configuration generation
2. Configuration Retrieval: Test retrieval logic for various configuration sources
3. Configuration Merging: Verify merging of server configuration with default configuration
4. Configuration Saving: Test configuration persistence functionality
5. Configuration Validation: Verify configuration completeness checks

Exception Handling Tests

1. Network Exceptions: Timeouts, connection failures, invalid responses
2. Storage Exceptions: localStorage unavailable, quota exceeded
3. Data Exceptions: Invalid URLs, corrupted JSON, missing fields
4. Environment Exceptions: Non-browser environment, missing APIs

Edge Case Tests

1. Extreme Data: Ultra-long URLs, large configuration objects, special characters
2. Concurrent Operations: Simultaneous read/write, race conditions, resource contention
3. Performance Limits: Large amounts of data, high-frequency operations, memory pressure

Performance Benchmarks

Execution Time Requirements

• getCurrentBrowserConfig: < 1ms
• saveHostConfig: < 5ms
• validateConfig: < 1ms
• fetchConfigFromServer: < 100ms (mock environment)

Batch Operation Requirements

• 1000 configuration retrievals: < 1 second
• 100 configuration saves: average < 10ms per operation
• 1000 configuration validations: average < 0.5ms per operation

Concurrent Performance Requirements

• 50 concurrent requests: < 1 second completion
• 200 extreme concurrent operations: all succeed

CI/CD Integration

GitHub Actions Example

name: Test Config Helpers
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'
      - run: npm ci
      - run: npm run test:run
      - run: npm run test:coverage

Coverage Requirements

• Statement Coverage: > 95%
• Branch Coverage: > 90%
• Function Coverage: 100%
• Line Coverage: > 95%

Debugging Tips

Running Single Tests

# Using describe or it names
npx vitest -t "getCurrentBrowserConfig should create config based on current browser location"

# Using file path and line number
npx vitest tests/utils/config-helpers.test.ts:45

Viewing Detailed Output

# Show detailed test output
npx vitest --reporter=verbose

# Show coverage details
npx vitest --coverage --reporter=verbose

Debug Mode

# Run in Node.js debug mode
npx vitest --inspect-brk

# Using VS Code debugger
# Add configuration in .vscode/launch.json

Best Practices

1. Test Isolation: Each test should be independent and not depend on other tests' state
2. Mock Management: Reset mocks in beforeEach, clean up in afterEach
3. Clear Assertions: Use specific assertions, avoid overly broad checks
4. Error Testing: Test both success and failure paths
5. Performance Monitoring: Regularly run performance tests, monitor for performance regressions

Troubleshooting

Common Issues

1. localStorage Unavailable: Ensure localStorage is properly mocked in test setup
2. fetch Undefined: Ensure fetch is mocked in setup.ts
3. window Object Missing: Use jsdom environment or properly mock window
4. Async Test Timeout: Increase timeout or optimize async logic

Debugging Steps

1. Check test setup file (setup.ts)
2. Verify mock configuration is correct
3. Review test output and error messages
4. Use console.log or debugger to check state
5. Run single test to isolate issues

Contributing Guidelines

Adding New Tests

1. Determine test type (unit/integration/performance)
2. Choose appropriate test file
3. Use existing test utilities and mocks
4. Follow naming conventions and structure
5. Add necessary documentation comments

Test Naming Conventions

• Use descriptive English test descriptions
• Format: should + expected behavior
• Example: should fallback to browser config when server config fails

Code Coverage

• New features must have corresponding tests
• Maintain high coverage (> 95%)
• Focus on testing edge conditions and error paths