Accessibility

Accessibility is vital, ensuring websites are usable by everyone. To address and test accessibility, Neodymium has integrated Google Lighthouse.

Installation

Install Lighthouse globally using npm:

npm install -g lighthouse

Usage

You can generate a Lighthouse report for the currently loaded page at any point during a test:

LighthouseUtils.createLightHouseReport("<reportName>");

This works as long as a webpage is loaded, even for pages relying on session-specific data.

Exception: Pages that redirect immediately upon refresh (like some checkout pages) may be difficult to test because Lighthouse re-opens the page in a separate tab.

Example

We can modify our FirstTest to generate valid Lighthouse reports after each page navigation:

public class FirstTest
{
    @NeodymiumTest
    public void firstTest()
    {
        // open the test website
        Selenide.open("https://posters.xceptance.io:8443/");

        // interacting with elements and assert states
        HomePage homePage = new HomePage().assertExpectedPage();
        LighthouseUtils.createLightHouseReport("HomePage");

        // navigate to the category page
        ProductListingPage productListingPage = homePage.openCategoryAtPosition(1);
        LighthouseUtils.createLightHouseReport("ProductListingPage");

        ...
    }
}

The generated Lighthouse reports are stored in the project’s target directory and attached to the Allure report:

The Lighthouse report inside the Allure report.

Validations

Neodymium allows you to validate the scores for the four Lighthouse categories:

1. Performance
2. Accessibility
3. Best Practices
4. Search Engine Optimisation (SEO)

To establish target scores (0 to 1), configure neodymium.properties:

neodymium.lighthouse.assert.thresholdScore.performance=0.5
neodymium.lighthouse.assert.thresholdScore.accessibility=0.5
neodymium.lighthouse.assert.thresholdScore.bestPractices=0.5
neodymium.lighthouse.assert.thresholdScore.seo=0.5

You can also validate specific audits by listing them:

neodymium.lighthouse.assert.audits=link-text uses-http2 robots-txt