DotnetLighthouse 1.0.1

DotnetLighthouse

DotnetLighthouse is a .NET library to run Lighthouse audits and process the results.

Prerequisites

• Make sure you have latest version of Node install (recommend to use LTS version) https://nodejs.org/en/download/prebuilt-installer
• Install Lighthouse cli globally, by running following command by opening up your terminal/command prompt

npm install -g lighthouse 

• You already have your dotnet test project using .net8.0 or higher or use following to create a xunit project

dotnet new xunit -o DotnetLighthouse.Tests

Installation

Now navigate to your project directory (e.g. DotnetLighthouse.Tests) You can install the DotnetLighthouse package by running following command in terminal:

dotnet add package DotnetLighthouse

Sample Code

• Create a new test file "LighthouseAudit.cs"
• Add following code into the class

using System;
using Xunit;
using DotnetLighthouse;

public class LighthouseAudit
{
[Fact]
        public void ValidateJsonAudit()
        {
            // Define the URL to be audited
            var url = "https://www.google.com";
            
            // Create an instance of LighthouseHelper with the specified URL
            var lighthouseHelper = new LighthouseHelper(url);
            
            // Run the Lighthouse audit for the specified URL
            lighthouseHelper.RunLighthouseAudit();
            
            // Retrieve the performance score from the Lighthouse audit results
            var performanceScore = lighthouseHelper.PerformanceScore;
            
            // Retrieve the accessibility score from the Lighthouse audit results
            var accessibilityScore = lighthouseHelper.AccessibilityScore;
            
            // Retrieve the best practices score from the Lighthouse audit results
            var bestPracticesScore = lighthouseHelper.BestPracticesScore;
            
            // Retrieve the SEO score from the Lighthouse audit results
            var seoScore = lighthouseHelper.SeoScore;
            
            // Retrieve the PWA score from the Lighthouse audit results
            var pwaScore = lighthouseHelper.PwaScore;
            
            // Assert that the performance score is greater than 90
            Assert.True(performanceScore > 90);
        }
}

More Configurations

• By Default DotnetLighthouse generate Lghthouse Audit report with name "lighthouse-report.json" in bin folder. In case you want a different name you can update by overriding property "OutputPath"

Dependencies

This project has the following dependencies:

• HtmlAgilityPack
• Newtonsoft.Json

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

Authors

Raj Uppadhyay