# tests\adapters\javascript/
@children-hash: 3bb98d24770f3262
@generated: 2026-02-15T09:01:33Z
## Purpose and Responsibility
The `tests/adapters/javascript` directory serves as the integration testing suite for JavaScript/TypeScript debugging adapter functionality within the debugger system. It provides comprehensive validation of the JavaScript adapter's integration with the broader debugger architecture, ensuring reliable debugging support for JavaScript and TypeScript applications across different platforms and runtime configurations.
## Key Components and Integration
### Primary Test Suite
- **Integration smoke tests** that validate end-to-end adapter functionality
- **Session management testing** for JavaScript/TypeScript debugging sessions
- **Launch configuration validation** with runtime-specific overrides (tsx, Node.js)
- **Cross-platform compatibility verification** for Windows and Unix environments
### Component Relationships
The integration tests orchestrate interactions between:
- **Adapter Registry System**: Validates proper registration and lifecycle management of JavaScript adapters
- **JavaScript Adapter Factory**: Tests TypeScript-specific configuration handling and session creation
- **js-debug Runtime**: Ensures correct command generation and communication with the underlying VS Code js-debug adapter
- **Configuration Pipeline**: Validates transformation of launch configurations with runtime overrides
## Public API Surface
### Main Entry Points
- **JavaScript Adapter Integration Validation**: End-to-end testing of adapter registration, configuration, and command generation
- **TypeScript Runtime Support Testing**: Validation of tsx runtime integration and parameter handling
- **Cross-Platform Command Building**: Verification of adapter commands across different operating systems
### Test Interfaces
- Integration testing framework for adapter factory registration
- Launch configuration testing with TypeScript/JavaScript runtime support
- Command validation for js-debug adapter integration
- Environment isolation and mock management utilities
## Internal Organization and Data Flow
1. **Test Environment Setup**: Preserves system environment, initializes adapter registry, configures mocks
2. **Adapter Factory Registration**: Registers JavaScript adapter factory with test-specific configurations
3. **Session Configuration Testing**: Validates launch config transformation and runtime overrides
4. **Command Generation Validation**: Tests end-to-end adapter command building with correct paths and ports
5. **Integration Verification**: Ensures proper communication between adapter components
6. **Environment Cleanup**: Restores system state and resets mocks for test isolation
## Important Patterns and Conventions
- **Smoke Testing Strategy**: Focuses on critical integration points and real-world usage scenarios
- **Environment Isolation**: Comprehensive environment preservation and restoration for clean test execution
- **Cross-Platform Design**: Handles platform-specific path normalization and environment differences
- **Type Safety with Flexibility**: Uses strategic type assertions for adapter interface compatibility
- **Standardized Configuration**: Consistent port/host setup (localhost:56789) and session identification patterns
- **Runtime Flexibility**: Supports multiple JavaScript/TypeScript runtimes (Node.js, tsx) with proper configuration handling
This directory ensures that JavaScript and TypeScript debugging capabilities integrate seamlessly with the debugger system, providing confidence in the adapter's ability to handle diverse development environments and runtime configurations.
