percy-selenium-dotnet

Percy visual testing for .NET Selenium.

Installation

npm install @percy/cli (requires Node 14+):

$ npm install --save-dev @percy/cli

Install the PercyIO.Selenium package (for example, with .NET CLI):

$ dotnet add package PercyIO.Selenium

Usage

This is an example test using the Percy.Snapshot method.

using PercyIO.Selenium; // ... other test code FirefoxOptions options = new FirefoxOptions(); FirefoxDriver driver = new FirefoxDriver(options); driver.Navigate().GoToUrl("http://example.com"); ​ // take a snapshot Percy.Snapshot(driver, ".NET example"); // snapshot options using an anonymous object Percy.Snapshot(driver, ".NET anonymous options", new { widths = new [] { 600, 1200 } }); // snapshot options using a dictionary-like object Percy.Options snapshotOptions = new Percy.Options(); snapshotOptions.Add("minHeight", 1280); Percy.Snapshot(driver, ".NET typed options", snapshotOptions);

Running the above normally will result in the following log:

[percy] Percy is not running, disabling snapshots

When running with percy exec, and your project's PERCY_TOKEN, a new Percy build will be created and snapshots will be uploaded to your project.

$ export PERCY_TOKEN=[your-project-token] $ percy exec -- [your test command] [percy] Percy has started! [percy] Created build #1: https://percy.io/[your-project] [percy] Snapshot taken ".NET example" [percy] Snapshot taken ".NET anonymous options" [percy] Snapshot taken ".NET typed options" [percy] Stopping percy... [percy] Finalized build #1: https://percy.io/[your-project] [percy] Done!