Troubleshooting

Installation Issues

Playwright Browsers Not Installing

Problem: playwright.sh: command not found or browsers fail to install.

Solution:

1. Ensure the project is built first:

2. Use the correct path to the script:

3. For Linux, install system dependencies:

.NET SDK Version Mismatch

Problem: error NETSDK1045: The current .NET SDK does not support targeting .NET 9.0

Solution:

1. Check installed .NET versions:

2. Install .NET SDK 9.0:

3. Verify installation:

Test Execution Issues

Tests Not Found

Problem: No test is available in the given sources

Solution:

1. Verify feature files exist:

2. Ensure SpecFlow is properly configured in .csproj:

<PackageReference Include="SpecFlow" Version="3.9.74" />
<PackageReference Include="SpecFlow.NUnit" Version="3.9.74" />

3. Rebuild the project:

Timeout Errors

Problem: Tests fail with Timeout 5000ms exceeded

Solution:

1. Increase timeout globally:

2. Increase timeout for specific steps:

[When(@"I wait for element")]
public async Task WhenIWaitForElement()
{
    await Page.WaitForSelectorAsync("#element", new PageWaitForSelectorOptions 
    { 
        Timeout = 10000 
    });
}

3. Check for slow network or application:

Element Not Found

Problem: Locator not found or Element not visible

Solution:

1. Verify the element exists in the DOM:

// Add debugging
var element = Page.Locator("#my-element");
var count = await element.CountAsync();
Console.WriteLine($"Element count: {count}");

2. Wait for element to be visible:

await Page.WaitForSelectorAsync("#my-element", new PageWaitForSelectorOptions 
{ 
    State = WaitForSelectorState.Visible 
});

3. Use the Healer to find alternative selectors:

Healing Issues

Registry Not Found

Problem: Registry file not found: agents/selectors.registry.json

Solution:

Run the learn command to create the registry:

Ensure the agents/ directory exists:

No Working Alternatives

Problem: Healer cannot find a working alternative selector

Solution:

1. Update the registry:

2. Check if element was removed:
   • Inspect the application to verify the element still exists
   • If removed, manually update the Page Object or test scenario
3. Verify DOM structure:

// Add debugging in your Page Object
var pageContent = await Page.ContentAsync();
Console.WriteLine(pageContent);

Roslyn Compilation Errors

Problem: Healing produces compilation errors

Solution:

1. Check the modified Page Object:

2. Verify selector syntax:
   • Ensure the selector is valid Playwright syntax
   • Check for missing quotes or brackets
3. Manual fix:
   • Revert the healing changes
   • Manually update the selector
   • Re-run learn to update the registry

Configuration Issues

AppSettings Not Loading

Problem: Configuration values are null or default

Solution:

1. Verify file location:
   • Ensure appsettings.json is in Tests.E2E/Support/
   • Check file is copied to output directory
2. Check JSON syntax:

{
  "BaseUrl": "https://example.com/",
  "DefaultUserEmail": "user@example.com"
}

3. Use environment variables:

Environment-Specific Settings Not Applied

Problem: appsettings.qa.json not loading

Solution:

1. Set environment variable:

2. Verify file naming:
   • Must be appsettings.{ENVIRONMENT}.json
   • Case-sensitive on Linux
3. Check configuration loading:

// In your configuration class
var environment = Environment.GetEnvironmentVariable("ENVIRONMENT") ?? "";
var configBuilder = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .AddJsonFile($"appsettings.{environment}.json", optional: true);

Reporting Issues

Allure Report Empty

Problem: Allure report shows no tests

Solution:

1. Verify JUnit XML exists:

2. Check XML format:

3. Re-run with JUnit logger:

Screenshots Not Appearing

Problem: Screenshots missing in Allure report

Solution:

1. Verify screenshot directory:

2. Check screenshot capture in LifecycleHooks:

[AfterScenario]
public async Task CaptureScreenshotOnFailure()
{
    if (ScenarioContext.ScenarioExecutionStatus == ScenarioExecutionStatus.TestError)
    {
        var screenshot = await Page.ScreenshotAsync();
        var fileName = $"artifacts/screenshots/{ScenarioContext.ScenarioInfo.Title}.png";
        await File.WriteAllBytesAsync(fileName, screenshot);
    }
}

3. Ensure directory exists:

Directory.CreateDirectory("artifacts/screenshots");

Performance Issues

Slow Test Execution

Problem: Tests take too long to run

Solution:

1. Run in parallel:

2. Reduce timeouts:

3. Skip non-critical tests:

4. Use headless mode:

{
  "Headless": true
}

High Memory Usage

Problem: Tests consume too much memory

Solution:

1. Limit parallel workers:

2. Close pages after scenarios:

[AfterScenario]
public async Task Cleanup()
{
    await Page.CloseAsync();
}

3. Disable video recording:
   • Remove or disable video capture in LifecycleHooks

Debugging Tips

Enable Verbose Logging

Add Console Logging

[When(@"I perform action")]
public async Task WhenIPerformAction()
{
    Console.WriteLine("Starting action...");
    await Page.ClickAsync("#button");
    Console.WriteLine("Action completed");
}

Use Playwright Inspector

// Add to LifecycleHooks
[BeforeScenario("@debug")]
public async Task LaunchWithInspector()
{
    await Page.PauseAsync(); // Opens Playwright Inspector
}

Run with debug tag:

Capture Network Logs

Page.Request += (sender, e) => 
{
    Console.WriteLine($"Request: {e.Method} {e.Url}");
};

Page.Response += (sender, e) => 
{
    Console.WriteLine($"Response: {e.Status} {e.Url}");
};

Getting Help

If you encounter issues not covered here:

1. Check logs:
   • Test output: dotnet test --verbosity detailed
   • Application logs: Check artifacts/logs/
2. Review documentation:
   • Getting Started
   • Healing Engine
3. Inspect artifacts:
   • Screenshots: artifacts/screenshots/
   • Videos: artifacts/videos/
   • Page sources: artifacts/pagesource/
4. Verify configuration:
   • appsettings.json syntax
   • Environment variables
   • Selector registry format