Jackett/src/Jackett.IntegrationTests/WebDriverFactory.cs

62 lines
3.9 KiB
C#

// Copyright (c) Microsoft. All rights reserved.
// Licensed under the MIT license. See LICENSE file in the project root for full license information.
using System;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
namespace Jackett.IntegrationTests
{
// This factory class is just one example of how you might initialize Selenium. If your project already has its own means
// of initializing Selenium, you can keep using that as-is and ignore this sample file; skip ahead to SamplePageTests.cs.
public static class WebDriverFactory
{
public static IWebDriver CreateFromEnvironmentVariableSettings()
{
// This environment variable gets set by our Azure Pipelines build definition in ./azure-pipelines.yml.
// That file uses a matrix strategy to run multiple different build jobs for different combinations of OS/browser.
// Each job sets this environment variable accordingly, and we use it to decide which browser the tests will use.
const string BROWSER_ENVIRONMENT_VARIABLE = "SELENIUM_BROWSER";
var browserEnvVar = Environment.GetEnvironmentVariable(BROWSER_ENVIRONMENT_VARIABLE);
// It's convenient to have a default to make it easier for a developer to run a plain "dotnet test" command.
// In our CI builds in Azure Pipelines, we'll always specify the browser explicitly instead of using this.
const string DEFAULT_BROWSER = "chrome";
// Headless browsers generally use small window sizes by default. Some of the axe checks require
// elements to be present in the viewport to be assessable, so using a viewport size based on your
// most common usage is a good idea to prevent axe from having to do extra work to scroll items into
// view and avoid issues with elements not fitting into the viewport.
const int windowWidth = 1920;
const int windowHeight = 1080;
switch (browserEnvVar ?? DEFAULT_BROWSER)
{
case "chrome":
// The ChromeWebDriver environment variable comes pre-set in the Azure Pipelines VM Image we
// specify in azure-pipelines.yml. ChromeDriver requires that you use *matching* versions of Chrome and
// the Chrome WebDriver; in the build agent VMs, using this environment variable will make sure that we use
// the pre-installed version of ChromeDriver that matches the pre-installed version of Chrome.
//
// See https://docs.microsoft.com/en-us/azure/devops/pipelines/test/continuous-test-selenium
//
// Environment.CurrentDirectory is where the Selenium.Webdriver.ChromeDriver NuGet package will place the
// version of the Chrome WebDriver that it comes with. We fall back to this so that if a developer working on
// the project hasn't separately installed ChromeDriver, the test will still be able to run on their machine.
var chromeDriverDirectory = Environment.GetEnvironmentVariable("CHROMEWEBDRIVER") ?? Environment.CurrentDirectory;
// The tests will work fine in non-headless mode; we recommend using --headless for performance and
// because it makes it easier to run the tests in non-graphical environments (eg, most Docker containers)
var chromeOptions = new ChromeOptions();
chromeOptions.AddArgument("--headless");
chromeOptions.AddArgument($"--window-size={windowWidth},{windowHeight}");
return new ChromeDriver(chromeDriverDirectory, chromeOptions);
default:
throw new ArgumentException($"Unknown browser type '{browserEnvVar}' specified in '{BROWSER_ENVIRONMENT_VARIABLE}' environment variable");
}
}
}
}