AiQ_GUI/Soak/Selenium.cs

using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using OpenQA.Selenium.Support.UI;

namespace AiQ_GUI
{
    internal class Selenium
    {
        // Directs to url using chrome drive and waits for the page to fully load
        public static void GoToUrl(string url, ChromeDriver driver)
        {
            try
            {
                driver.Navigate().GoToUrl(url);

                // Wait until the document is fully loaded
                WebDriverWait wait = new(driver, TimeSpan.FromSeconds(10));
                wait.Until(d => ((IJavaScriptExecutor)d).ExecuteScript("return document.readyState").Equals("complete"));
            }
            catch (WebDriverTimeoutException)
            {
                MainForm.Instance.AddToActionsList("Could not load web page " + url + "1. Check camera has no password set. " + Environment.NewLine + "2. If unable to fix speak to supervisor.");
            }
        }

        // Retrieves lates element ID for Shutter,iris, gain and IR 
        public static ElementID GetElementIds(ChromeDriver driver)
        {
            ElementID elementID = new()
            {
                modeId = GetLatestElementIdContaining("Mode_", driver),
                shutterId = GetLatestElementIdContaining("FixShutter_", driver),
                irisId = GetLatestElementIdContaining("FixIris_", driver),
                gainId = GetLatestElementIdContaining("FixGain_", driver),
                irLevelId = GetLatestElementIdContaining("CameraControls_", driver),
                CamAct = GetLatestElementIdContaining("CameraActivity_", driver)
            };

            return elementID;
        }

        // Clicks the element with the specified ID using Chromedriver
        public static void ClickElementByID(string elementID, ChromeDriver driver)
        {
            ClickElementByID(elementID, true, driver);
        }

        // Attempts to click the web element with the specified ID; refreshes the page and retries once if the initial attempt fails
        public static void ClickElementByID(string elementID, bool tryagain, ChromeDriver driver)
        {
            try
            {
                WebDriverWait wait = new(driver, TimeSpan.FromSeconds(10));
                IWebElement element = wait.Until(driver => driver.FindElement(By.Id(elementID)));
                element.Click();
            }
            catch
            {
                if (tryagain)
                {
                    driver.Navigate().Refresh();
                    WebDriverWait wait = new(driver, TimeSpan.FromSeconds(10));
                    wait.Until(d => ((IJavaScriptExecutor)d).ExecuteScript("return document.readyState").Equals("complete"));
                    ClickElementByID(elementID, false, driver);
                }

                MainForm.Instance.AddToActionsList("Could not click " + elementID);
            }
        }

        // Initialises and opens a ChromeDriver with specific options
        public static ChromeDriver OpenDriver()
        {
            ChromeDriverService chromeDriverService = ChromeDriverService.CreateDefaultService();
            chromeDriverService.HideCommandPromptWindow = true;
            ChromeOptions options = new();
            options.AddArguments("--app=data:,", "--window-size=960,1040", "--window-position=0,0");
            options.AddExcludedArgument("enable-automation");
            options.AddAdditionalChromeOption("useAutomationExtension", false);

            ChromeDriver driver = new(chromeDriverService, options);
            driver.Manage().Timeouts().PageLoad = TimeSpan.FromSeconds(5);
            return driver;
        }

        // Changes the value of a dropdown element by ID, logs the action, and verifies the result using flashline feedback
        public static async Task Dropdown_Change(string fullId, string value, ChromeDriver driver, string SoakLogFile, string CamAct)
        {
            WebDriverWait wait = new(driver, TimeSpan.FromSeconds(10));
            IWebElement element = wait.Until(driver => driver.FindElement(By.Id(fullId)));

            await Logging.LogMessage($"Changing dropdown {fullId} to value: {value}", SoakLogFile);
            await Task.Delay(fullId.Contains("Mode_") ? 4000 : 200);

            if (value == element.GetAttribute("value"))
                return; // No change needed setting is already correct

            SelectElement select = new(element);

            select.SelectByValue(value);
            await Task.Delay(500); // Wait for the change to take effect

            if (!await Checkflashline(driver, CamAct))
            {
                Logging.LogWarningMessage("Bad flashline after changing: " + fullId, SoakLogFile);
                MainForm.Instance.AddToActionsList("Bad flashline after changing: " + fullId);
            }
        }

        // Monitors the flashline element's color to determine success (green) or failure (red) of a camera 
        public static async Task<bool> Checkflashline(ChromeDriver driver, string CamAct)
        {
            IWebElement flashline = driver.FindElement(By.Id(CamAct));
            string flashlinecolor = flashline.GetCssValue("color");

            Task FlashWait = Task.Delay(8000);

            while (!FlashWait.IsCompleted)
            {
                if (flashlinecolor.Contains("0, 255, 127"))
                    return true;
                else if (flashlinecolor.Contains("255, 69, 0"))
                    return false;

                await Task.Delay(500);
                flashlinecolor = flashline.GetCssValue("color");
            }

            return false;
        }

        // Retrieves the ID of the last <select> element whose ID starts with the specified partial ID
        public static string GetLatestElementIdContaining(string partialId, ChromeDriver driver)
        {
            System.Collections.ObjectModel.ReadOnlyCollection<IWebElement> elements = driver.FindElements(By.XPath($"//*[@id][starts-with(@id, '{partialId}')]"));

            List<string?> matchingIds = elements
                .Select(el => el.GetAttribute("id"))
                .Where(id => !string.IsNullOrEmpty(id))
                .ToList();

            return matchingIds.LastOrDefault();
        }
    }
}