se-cross-browser-runner

Selenium Cross-Browser Runner

You wire tests to run across multiple browsers via TestNG parameters/factory and a browser matrix. The setup is a draft the engineer must actually run on each browser — you cannot confirm every browser is installed or behaves identically.

When to use

• The same suite must execute on Chrome, Firefox, and/or Edge.
• Someone wants the browser selectable from testng.xml or a system property.
• A CI browser matrix (browser × maybe version/OS) needs defining.

Workflow

1. Parameterize the browser: a @Parameters("browser") value from testng.xml, or a @Factory that instantiates the test class once per browser.
2. Route to a driver factory that maps the parameter to ChromeDriver/ FirefoxDriver/EdgeDriver with per-browser options (reuse se-driver-manager).
3. Define suite blocks in testng.xml — one <test> per browser, or a single test parameterized and run under parallel="tests" for concurrency.
4. Keep tests browser-agnostic: no browser-specific locators or waits; differences go in options only.
5. Add a matrix note for CI (e.g. GitHub Actions strategy matrix) so the same suite fans out across browsers.
6. Emit testng.xml + factory glue and list browsers you could not verify installed.

Output shape

<!-- testng.xml — one <test> per browser, run in parallel -->
<suite name="cross-browser" parallel="tests" thread-count="3">
  <test name="chrome">  <parameter name="browser" value="chrome"/>  <classes><class name="com.qa.tests.LoginTest"/></classes></test>
  <test name="firefox"> <parameter name="browser" value="firefox"/> <classes><class name="com.qa.tests.LoginTest"/></classes></test>
  <test name="edge">    <parameter name="browser" value="edge"/>    <classes><class name="com.qa.tests.LoginTest"/></classes></test>
</suite>

public class BaseTest {
    protected WebDriver driver;

    @Parameters("browser")
    @BeforeMethod
    public void setUp(@Optional("chrome") String browser) {
        driver = DriverFactory.create(browser);   // maps param -> Chrome/Firefox/Edge (+ options)
    }

    @AfterMethod
    public void tearDown() { if (driver != null) driver.quit(); }
}

Guardrails

• This is a draft the engineer must run on each browser — passing on Chrome does not prove Firefox/Edge pass.
• Never assume a locator exists, and never write browser-specific locators; a matrix only works if tests are browser-agnostic.
• Don't fabricate that a browser is installed; if you can't confirm Edge/Firefox availability, say the engineer must verify.
• Keep browser differences confined to driver options — not to test logic or waits.
• Size thread-count to real machine capacity; over-parallelizing browsers causes flakiness.
• Always quit() each browser session to avoid leaking processes across the matrix.