AGENT SKILL

se-report-integrator

Integrates reporting (Allure or ExtentReports) into a Selenium + TestNG suite with listeners, screenshot-on-failure, and step logging. Use when an SDET says "add Allure to my tests", "set up ExtentReports", "capture a screenshot on failure", "add a TestNG listener for reporting", or wants readable run reports. Produces listener and config code the engineer must run to generate a report.

License 许可
MIT
最近更新
2026-07-15
Stars
★ 4
Forks
8

01 前言 Front Matter

name
se-report-integrator
license
MIT
metadata
{ "pack": "selenium", "author": "TheTestingAcademy", "version": "1.0.0" }
description
Integrates reporting (Allure or ExtentReports) into a Selenium + TestNG suite with listeners, screenshot-on-failure, and step logging. Use when an SDET says "add Allure to my tests", "set up ExtentReports", "capture a screenshot on failure", "add a TestNG listener for reporting", or wants readable run reports. Produces listener and config code the engineer must run to generate a report.

03 SKILL.md 正文

Selenium Report Integrator

You wire reporting into a TestNG + Selenium suite — Allure or ExtentReports, with failure screenshots and step logs. The integration is a draft the engineer must run; only an actual test run proves the report generates.

When to use

  • A suite produces only console/TestNG default output and needs a readable report.
  • Someone wants a screenshot attached automatically when a test fails.
  • Step-level logging is needed for triage across a run.

Workflow

  1. Pick the reporter: Allure (CI-friendly, allure serve HTML, annotations) or ExtentReports (self-contained HTML, rich in-code logging). Match what CI expects.
  2. Add dependencies + config: allure-testng (+ AspectJ weaver) or extentreports; for Allure set the results dir, for Extent build an ExtentReports singleton with a SparkReporter.
  3. Hook TestNG lifecycle via an ITestListener: create a test node on start, log pass/skip, and on failure capture + attach a screenshot.
  4. Capture screenshots with ((TakesScreenshot) driver).getScreenshotAs(...) inside onTestFailure; attach as Allure attachment or Extent addScreenCaptureFromPath.
  5. Log steps — Allure @Step/Allure.step(...) or Extent test.log(...) from page actions — so the report reads as a narrative.
  6. Register the listener in testng.xml and emit config, noting versions to confirm.

Output shape

public class ScreenshotListener implements ITestListener {
    @Override
    public void onTestFailure(ITestResult result) {
        WebDriver driver = DriverFactory.getDriver();   // driver from the running test's factory
        byte[] png = ((TakesScreenshot) driver).getScreenshotAs(OutputType.BYTES);
        // Allure:
        Allure.addAttachment(result.getName() + "-failure", "image/png", new ByteArrayInputStream(png), "png");
        // ExtentReports alternative:
        // ExtentTestManager.getTest().fail("Failed", MediaEntityBuilder.createScreenCaptureFromPath(path).build());
    }

    @Override public void onTestSuccess(ITestResult r) { Allure.step("PASS: " + r.getName()); }
}
<!-- testng.xml — register the listener -->
<suite name="suite"><listeners><listener class-name="com.qa.listeners.ScreenshotListener"/></listeners> ... </suite>

Guardrails

  • This integration is a draft the engineer must run — the report only exists after an actual test execution (e.g. allure serve target/allure-results).
  • Never assume a locator exists; the listener touches the driver, not page selectors — keep test locators separate and real.
  • Don't fabricate dependency versions; tell the engineer to confirm the current allure-testng/extentreports and the AspectJ weaver arg for Allure @Step.
  • Guard screenshot capture: a null/quit driver in onTestFailure must not throw and mask the real failure.
  • Attach screenshots as bytes/paths through the reporter API — don't leave orphan files or hardcode absolute paths.
  • Keep secrets out of logs/screenshots; don't log credentials into the report.

04 同仓库更多 Skills

PramodDutta
PramodDutta/skillmasterclass

se-wait-fixer

Scans Selenium Java code for Thread.sleep and for implicit+explicit wait mixing, then replaces them with WebDriverWait/ExpectedConditions or FluentWait to fix synchronization. Use when an SDET says "remove Thread.sleep from my tests", "fix the flaky waits", "my implicit and explicit waits conflict", or pastes code full of hard sleeps. Produces refactors the engineer must run and confirm.

★ 4
PramodDutta
PramodDutta/skillmasterclass

se-test-generator

Generates a runnable Selenium 4 + TestNG test in Java from a plain-language scenario, using explicit waits and stable locators. Use when an SDET says "write a Selenium test for login", "generate a TestNG test for the checkout flow", "automate this scenario in Selenium", or pastes Gherkin/steps and wants Java WebDriver code. Produces a draft test the engineer must review and run.

★ 4
PramodDutta
PramodDutta/skillmasterclass

se-page-object-builder

Builds a Page Object Model class in Java (PageFactory @FindBy or explicit locators) with action methods and a WebDriverWait for a given page. Use when an SDET says "create a page object for the login page", "build a POM class", "refactor these locators into a page object", or pastes a page's fields and wants a reusable POM. Produces a draft class the engineer must review and run.

★ 4
PramodDutta
PramodDutta/skillmasterclass

se-locator-strategist

Recommends and repairs Selenium locator strategy — replaces brittle absolute XPath with By.id, By.cssSelector, or Selenium 4 relative locators, and explains the trade-offs. Use when an SDET says "this XPath keeps breaking", "make this locator more stable", "why is my locator flaky", "convert this XPath to CSS", or pastes selectors to harden. Produces proposals the engineer must verify in the DOM.

★ 4
PramodDutta
PramodDutta/skillmasterclass

se-grid-configurator

Configures Selenium Grid 4 (hub-and-node or standalone, including Docker) and wires RemoteWebDriver for parallel and distributed runs. Use when an SDET says "set up Selenium Grid", "run my tests on a remote grid", "dockerize Selenium Grid 4", "point my tests at RemoteWebDriver", or wants parallel execution across nodes. Produces config and code the engineer must run and validate in their environment.

★ 4
PramodDutta
PramodDutta/skillmasterclass

se-framework-scaffolder

Scaffolds a Maven Selenium framework — TestNG suite, base test, Page Object package, config loader, logging, and reporting hooks. Use when an SDET says "scaffold a Selenium framework", "set up a new Maven Selenium project", "give me a POM/TestNG project structure", or is starting automation from zero. Produces a starter layout and files the engineer must build, run, and adapt.

★ 4