[rust] Improve SM error messages when browser/driver version not found (#17584)

[rust] Improve SM error messages when browser/driver version is not found

Add per-browser links to canonical version lists in error messages so
users know where to find valid versions when a lookup fails.

Author: AutomatedTester

rust/src/chrome.rs

@@ -194,11 +194,15 @@ impl ChromeManager {
             .filter(|r| r.version.starts_with(version_for_filtering.as_str()))
             .collect();
         if filtered_versions.is_empty() {
-            return Err(anyhow!(format_three_args(
-                UNAVAILABLE_DOWNLOAD_WITH_MIN_VERSION_ERR_MSG,
-                self.get_driver_name(),
-                version_for_filtering.as_str(),
-                &MIN_CHROMEDRIVER_VERSION_CFT.to_string(),
+            return Err(anyhow!(format!(
+                "{}. Check available versions at {}",
+                format_three_args(
+                    UNAVAILABLE_DOWNLOAD_WITH_MIN_VERSION_ERR_MSG,
+                    self.get_driver_name(),
+                    version_for_filtering.as_str(),
+                    &MIN_CHROMEDRIVER_VERSION_CFT.to_string(),
+                ),
+                CFT_URL
             )));
         }
 
@@ -582,6 +586,10 @@ impl SeleniumManager for ChromeManager {
         Ok(None)
     }
 
+    fn get_browser_versions_url(&self) -> &str {
+        CFT_URL
+    }
+
     fn is_download_browser(&self) -> bool {
         self.download_browser
     }

rust/src/edge.rs

@@ -49,6 +49,7 @@ const DRIVER_URL: &str = "https://msedgedriver.microsoft.com/";
 const LATEST_STABLE: &str = "LATEST_STABLE";
 const LATEST_RELEASE: &str = "LATEST_RELEASE";
 const BROWSER_URL: &str = "https://edgeupdates.microsoft.com/api/products/";
+const EDGE_VERSIONS_URL: &str = "https://developer.microsoft.com/microsoft-edge/webdriver/";
 const MIN_EDGE_VERSION_DOWNLOAD: i32 = 113;
 const EDGE_WINDOWS_AND_LINUX_APP_NAME: &str = "msedge";
 const EDGE_MACOS_APP_NAME: &str = "Microsoft Edge.app/Contents/MacOS/Microsoft Edge";
@@ -540,6 +541,10 @@ impl SeleniumManager for EdgeManager {
         Ok(Some(browser_label))
     }
 
+    fn get_browser_versions_url(&self) -> &str {
+        EDGE_VERSIONS_URL
+    }
+
     fn is_download_browser(&self) -> bool {
         self.download_browser
     }

rust/src/firefox.rs

@@ -65,6 +65,7 @@ const MIN_DOWNLOADABLE_FIREFOX_VERSION_MAC: i32 = 4;
 const MIN_DOWNLOADABLE_FIREFOX_VERSION_LINUX: i32 = 4;
 const UNAVAILABLE_DOWNLOAD_ERROR_MESSAGE: &str =
     "{} {} not available for downloading (minimum version: {})";
+const FIREFOX_RELEASES_URL: &str = "https://www.mozilla.org/en-US/firefox/releases/";
 const FIREFOX_SNAP_LINK: &str = "/snap/bin/firefox";
 const FIREFOX_SNAP_BINARY: &str = "/snap/firefox/current/usr/lib/firefox/firefox";
 
@@ -254,8 +255,11 @@ impl SeleniumManager for FirefoxManager {
                         ));
                         if filtered_versions.is_empty() {
                             return Err(anyhow!(format!(
-                                "Not valid {} version found for {} {}",
-                                &self.driver_name, &self.browser_name, major_browser_version_int
+                                "Not valid {} version found for {} {}. Check available versions at {}",
+                                &self.driver_name,
+                                &self.browser_name,
+                                major_browser_version_int,
+                                DRIVER_URL
                             )));
                         } else {
                             filtered_versions.first().unwrap().to_string()
@@ -466,11 +470,15 @@ impl SeleniumManager for FirefoxManager {
 
             let min_downloadable_version = self.get_min_browser_version_for_download()?;
             if major_browser_version < min_downloadable_version {
-                return Err(anyhow!(format_three_args(
-                    UNAVAILABLE_DOWNLOAD_ERROR_MESSAGE,
-                    browser_name,
-                    browser_version,
-                    &min_downloadable_version.to_string(),
+                return Err(anyhow!(format!(
+                    "{}. Check available versions at {}",
+                    format_three_args(
+                        UNAVAILABLE_DOWNLOAD_ERROR_MESSAGE,
+                        browser_name,
+                        browser_version,
+                        &min_downloadable_version.to_string(),
+                    ),
+                    FIREFOX_RELEASES_URL
                 )));
             }
 
@@ -619,6 +627,10 @@ impl SeleniumManager for FirefoxManager {
         Ok(Some(browser_label))
     }
 
+    fn get_browser_versions_url(&self) -> &str {
+        FIREFOX_RELEASES_URL
+    }
+
     fn is_download_browser(&self) -> bool {
         self.download_browser
     }

rust/src/iexplorer.rs

@@ -183,8 +183,9 @@ impl SeleniumManager for IExplorerManager {
                     Ok(driver_version)
                 } else {
                     Err(anyhow!(format!(
-                        "{} release not available",
-                        self.get_driver_name()
+                        "{} release not available. Check available versions at {}",
+                        self.get_driver_name(),
+                        DRIVER_URL
                     )))
                 }
             }

rust/src/lib.rs

@@ -184,6 +184,10 @@ pub trait SeleniumManager {
     // Shared functions
     // ----------------------------------------------------------
 
+    fn get_browser_versions_url(&self) -> &str {
+        ""
+    }
+
     fn download_driver(&mut self) -> Result<(), Error> {
         let driver_path_in_cache = self.get_driver_path_in_cache()?;
         let driver_name_with_extension = self.get_driver_name_with_extension();
@@ -246,12 +250,17 @@ pub trait SeleniumManager {
             && !self.is_browser_version_empty()
             && major_browser_version_int < min_browser_version_for_download
         {
-            return Err(anyhow!(format_three_args(
+            let mut message = format_three_args(
                 UNAVAILABLE_DOWNLOAD_WITH_MIN_VERSION_ERR_MSG,
                 self.get_browser_name(),
                 &major_browser_version,
                 &min_browser_version_for_download.to_string(),
-            )));
+            );
+            let versions_url = self.get_browser_versions_url();
+            if !versions_url.is_empty() {
+                message = format!("{}. Check available versions at {}", message, versions_url);
+            }
+            return Err(anyhow!(message));
         }
 
         if self.is_version_specific(original_browser_version) {
@@ -1285,11 +1294,16 @@ pub trait SeleniumManager {
         } else {
             format!(" {}", browser_version)
         };
-        Err(anyhow!(format_two_args(
+        let mut message = format_two_args(
             error_message,
             self.get_browser_name(),
             &browser_version_label,
-        )))
+        );
+        let versions_url = self.get_browser_versions_url();
+        if !versions_url.is_empty() {
+            message = format!("{}. Check available versions at {}", message, versions_url);
+        }
+        Err(anyhow!(message))
     }
 
     // ----------------------------------------------------------