updates

Author: s_roe

src/csharp/Gravity.Core/Gravity.Core/Extensions/WebDriverExtensions.cs

@@ -4,9 +4,11 @@
  * on-line resources
  */
 using Newtonsoft.Json;
+
 using OpenQA.Selenium.Common;
 using OpenQA.Selenium.Remote;
 using OpenQA.Selenium.Support.UI;
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -15,6 +17,7 @@
 using System.Net.Http;
 using System.Reflection;
 using System.Text;
+using System.Text.RegularExpressions;
 using System.Threading;
 using System.Threading.Tasks;
 
@@ -934,6 +937,30 @@ private static IWebDriver DoSwitchToFrame(IWebDriver driver, By by, TimeSpan tim
         }
         #endregion
 
+        #region *** Switch to Window  ***
+        /// <summary>
+        /// Switches the focus of future commands for this driver to the window with the given name.
+        /// </summary>
+        /// <param name="driver">This <see cref="IWebDriver"/> instance.</param>
+        /// <param name="windowName">The handle of the window to select.</param>
+        /// <returns>Self <see cref="IWebDriver"/> reference.</returns>
+        public static IWebDriver SwitchTo(this IWebDriver driver, string windowName)
+        {
+            // commands
+            var command = GetCommandApi(driver, "/window");
+
+            // switch window parameters
+            var body = @"{""handle"":""" + windowName + @"""}";
+            var content = new StringContent(body, Encoding.UTF8, mediaType: "application/json");
+
+            // executes
+            client.PostAsync(command, content).GetAwaiter().GetResult();
+
+            // results
+            return driver;
+        }
+        #endregion
+
         /// <summary>
         /// Switches the focus of future commands for this driver to the window with the given index.
         /// </summary>
@@ -965,6 +992,33 @@ public static Uri GetEndpoint(this IWebDriver driver)
             return DoGetEndpoint(driver);
         }
 
+        /// <summary>
+        /// Returns an indication if this IWebDriver" implementation is an AppiumDriver implementation.
+        /// </summary>
+        /// <param name="d">The IWebDriver to evaluate.</param>
+        /// <returns>True if AppiumDriver or False if not.</returns>
+        public static bool IsAppiumDriver(this IWebDriver d)
+        {
+            // initialize conditions
+            var isName = false;
+            var isAppium = false;
+
+            // setup name condition            
+            var type = d.GetType();
+            while (!isName && type != null && type.Name != "RemoteWebDriver" && type.Name != "Object")
+            {
+                isName = Regex.IsMatch(type.Name, "AppiumDriver`1");
+                if (isName)
+                {
+                    isAppium = typeof(IWebElement).IsAssignableFrom(type?.GenericTypeArguments?.First());
+                }
+                type = type.BaseType;
+            }
+
+            // assertion
+            return isAppium;
+        }
+
         #region *** Send Command      ***
         /// <summary>
         /// Sends POST command directly to this <see cref="IWebDriver"/> instance.
@@ -1031,17 +1085,20 @@ public static string SendDeleteCommand(this IWebDriver driver, string route)
             // results
             return response.Content.ReadAsStringAsync().GetAwaiter().GetResult();
         }
+        #endregion
 
+        #region *** Utilities         ***
         private static string GetCommandApi(IWebDriver driver, string route)
         {
+            // setup
             var endpoint = DoGetEndpoint(driver).AbsoluteUri;
             var session = DoGetSession(driver);
             route = route.StartsWith("/") ? route : $"/{route}";
+
+            // get
             return $"{endpoint}session/{session}{route}";
         }
-        #endregion
 
-        #region *** Utilities         ***
         [SuppressMessage("Major Code Smell", "S3011:Reflection should not be used to increase accessibility of classes, methods, or fields", Justification = "Designed to increase accessibility.")]
         private static Uri DoGetEndpoint(IWebDriver driver)
         {

src/csharp/Gravity.Core/Gravity.Core/Extensions/WebElementExtensions.cs

@@ -4,10 +4,12 @@
  * on-line resources
  */
 using Newtonsoft.Json;
+
 using OpenQA.Selenium.Interactions;
 using OpenQA.Selenium.Internal;
 using OpenQA.Selenium.Remote;
 using OpenQA.Selenium.Support.UI;
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -265,6 +267,44 @@ public static IWebElement MoveToElement(this IWebElement toElement)
             // keep the fluent
             return toElement;
         }
+
+        /// <summary>
+        /// Scrolls the specified element into the visible area of the browser window.
+        /// </summary>
+        /// <param name="onElement"><see cref="IWebElement"/> to scroll into view.</param>
+        /// <returns>An <see cref="IWebElement"/> interface through which the user controls elements on the page.</returns>
+        public static IWebElement TryScrollIntoView(this IWebElement onElement)
+        {
+            // exit conditions
+            if (!(onElement is IWrapsDriver))
+            {
+                return onElement;
+            }
+
+            // extract driver
+            var driver = ((IWrapsDriver)onElement).WrappedDriver;
+
+            // try scroll into view
+            try
+            {
+                // check for irrelevant drivers
+                if (driver.IsAppiumDriver())
+                {
+                    new Actions(driver).MoveToElement(onElement).Build().Perform();
+                    return onElement;
+                }
+                else
+                {
+                    ((IJavaScriptExecutor)driver)
+                        .ExecuteScript("arguments[0].scrollIntoView(false);", onElement);
+                }
+            }
+            catch (Exception e) when (e != null)
+            {
+                // ignore exceptions
+            }
+            return onElement;
+        }
         #endregion
 
         #region *** Delayed Send Keys ***