error-scenario-testing

# Error Scenario Testing ## Overview Test error handling by forcing error conditions. Don't commit error handling code without testing error paths. ## Forcing Error Conditions **Methods**: - Add test mode flags to enable error injection - Create test seam commands to trigger errors - Temporarily modify code to force failures (revert after testing) - Use environment variables to enable error testing See `references/error-injection.md` for detailed error injection patterns. ## Maze Generation Error Testing For maze generation failures: - Add `forceMazeFailure()` test seam command - Modify maze generation to fail after N attempts - Test fallback maze creation - Verify console warnings appear See `references/maze-generation-errors.md` for specific patterns. ## Error Testing Checklist - [ ] Error condition can be triggered - [ ] Error handling code executes - [ ] Fallback behavior works correctly - [ ] User experience is acceptable - [ ] Console warnings/logs appear - [ ] Game doesn't crash ## Test Mode Pattern See `references/error-injection.md` for test mode implementation pattern. ## Test Seam Error Injection **Add test seam commands to trigger errors:** ```typescript // Force error conditions via test seam window.__TEST__.commands.forceMazeFailure = () => { // Force maze generation to fail this.mazeGenerator.forceFailure = true; }; window.__TEST__.commands.restoreMazeGeneration = () => { // Restore normal maze generation this.mazeGenerator.forceFailure = false; }; ``` **Error scenario test commands:** ```typescript window.__TEST__.commands = { forceMazeFailure: () => { this.mazeGenerator.forceFailure = true; }, restoreMazeGeneration: () => { this.mazeGenerator.forceFailure = false; }, triggerAssetLoadError: () => { // Simulate asset load failure this.assetLoader.simulateError = true; }, restoreAssetLoading: () => { this.assetLoader.simulateError = false; } }; ``` **Test error handling paths:** ```bash # Test error scenario agent-browser eval "window.__TEST__.commands.forceMazeFailure()" agent-browser eval "window.__TEST__.commands.generateMaze()" # Verify fallback behavior agent-browser eval "window.__TEST__.commands.restoreMazeGeneration()" ``` ## Error Recovery Patterns **Retry logic with configurable attempts:** ```typescript async function generateWithRetry( generator: () => Promise<Result>, maxAttempts: number = 3 ): Promise<Result> { for (let attempt = 1; attempt <= maxAttempts; attempt++) { try { return await generator(); } catch (error) { console.warn(`Attempt ${attempt} failed:`, error); if (attempt === maxAttempts) { throw new Error(`Failed after ${maxAttempts} attempts`); } // Wait before retry await sleep(1000 * attempt); // Exponential backoff } } throw new Error('Max attempts reached'); } ``` **Fallback mechanisms for critical operations:** ```typescript async function loadAssetWithFallback( assetKey: string, primaryUrl: string, fallbackUrl: string ): Promise<void> { try { this.load.image(assetKey, primaryUrl); } catch (error) { console.warn(`Failed to load ${assetKey} from primary URL, using fallback`); this.load.image(assetKey, fallbackUrl); } } ``` **Console warning patterns:** ```typescript if (!this.textures.exists('asset-key')) { console.warn('Asset not found:', 'asset-key'); console.warn('Using fallback placeholder'); // Use fallback } ``` **Graceful degradation strategies:** ```typescript create() { try { // Try primary implementation this.initPrimaryFeature(); } catch (error) { console.warn('Primary feature failed, using fallback:', error); // Graceful degradation this.initFallbackFeature(); } } ``` ## Verification Checklists **Verify error handling works:** ```markdown ## Error Handling Verification - [ ] Error condition can be triggered - [ ] Error handling code executes - [ ] Fallback behavior works correctly - [ ] User experience is acceptable - [ ] Console warnings/logs appear - [ ] Game doesn't crash ``` **Test fallback mechanisms:** ```bash # Test fallback by forcing error agent-browser eval "window.__TEST__.commands.forceMazeFailure()" agent-browser eval "window.__TEST__.commands.generateMaze()" # Verify fallback maze is created agent-browser eval "window.__TEST__.gameState().maze" ``` **Check console warnings:** ```bash # Check for console warnings agent-browser console | grep -i "warn\|error" # Verify warnings appear for error scenarios agent-browser eval "window.__TEST__.commands.forceMazeFailure()" agent-browser console ``` **Validate recovery behavior:** ```bash # Test recovery after error agent-browser eval "window.__TEST__.commands.forceMazeFailure()" agent-browser eval "window.__TEST__.commands.generateMaze()" agent-browser eval "window.__TEST__.commands.restoreMazeGeneration()" agent-browser eval "window.__TEST__.commands.generateMaze()" # Verify normal generation works after recovery ``` ## Resources - `references/error-injection.md` - Test mode flags, test seam commands, environment variables - `references/maze-generation-errors.md` - Specific patterns for maze generation failures