Rename W3CWebDriver test project to WebDriverAPI to cover all supported API endpoints

Consolidate Appium specific API endpoint tests to the WebDriverAPI project
Create a new README page for WebDriverAPI project
Update Utility.CreateNewSession to support creating a session with launching argument
Launch Edge browser in private mode to reduce load time and preserve machine state

Author: timotiusmargo

Tests/Appium/Appium.csproj

@@ -18,7 +18,7 @@
 using OpenQA.Selenium.Appium.Windows;
 using OpenQA.Selenium.Remote;
 
-namespace W3CWebDriver
+namespace WebDriverAPI
 {
     public class AlarmClockBase
     {

Tests/Appium/Appium.sln

@@ -20,7 +20,7 @@
 using System;
 using System.Threading;
 
-namespace W3CWebDriver
+namespace WebDriverAPI
 {
     public class CalculatorBase
     {

Tests/Appium/CommonTestSettings.cs

@@ -14,7 +14,7 @@
 //
 //******************************************************************************
 
-namespace W3CWebDriver
+namespace WebDriverAPI
 {
     public class CommonTestSettings
     {

Tests/Appium/Properties/AssemblyInfo.cs

@@ -20,7 +20,7 @@
 using System;
 using System.Threading;
 
-namespace W3CWebDriver
+namespace WebDriverAPI
 {
     public class EdgeBase
     {
@@ -38,8 +38,8 @@ public static void Setup(TestContext context)
                 TearDown();
 
                 // Launch the Edge browser app
-                session = Utility.CreateNewSession(CommonTestSettings.EdgeAppId);
-                session.Manage().Timeouts().ImplicitlyWait(TimeSpan.FromSeconds(5));
+                session = Utility.CreateNewSession(CommonTestSettings.EdgeAppId, "-private");
+                session.Manage().Timeouts().ImplicitlyWait(TimeSpan.FromSeconds(3));
                 Assert.IsNotNull(session);
                 Assert.IsNotNull(session.SessionId);
 

Tests/W3CWebDriver/packages.config

@@ -18,7 +18,7 @@
 using OpenQA.Selenium.Remote;
 using System;
 
-namespace W3CWebDriver
+namespace WebDriverAPI
 {
     public class Utility
     {
@@ -31,10 +31,16 @@ public class Utility
             CleanupOrphanedSession();
         }
 
-        public static WindowsDriver<WindowsElement> CreateNewSession(string appId)
+        public static WindowsDriver<WindowsElement> CreateNewSession(string appId, string argument = null)
         {
             DesiredCapabilities appCapabilities = new DesiredCapabilities();
             appCapabilities.SetCapability("app", appId);
+
+            if (argument != null)
+            {
+                appCapabilities.SetCapability("appArguments", argument);
+            }
+
             return new WindowsDriver<WindowsElement>(new Uri(CommonTestSettings.WindowsApplicationDriverUrl), appCapabilities);
         }
 

Tests/W3CWebDriver/AppSessionBase/AlarmClockBase.cs renamed to Tests/WebDriverAPI/AppSessionBase/AlarmClockBase.cs

@@ -14,62 +14,57 @@
 //
 //******************************************************************************
 
-using System;
 using Microsoft.VisualStudio.TestTools.UnitTesting;
 using OpenQA.Selenium.Appium.Windows;
-using OpenQA.Selenium.Remote;
+using System;
+using System.Threading;
 
-namespace W3CWebDriver
+namespace WebDriverAPI
 {
     [TestClass]
     public class AppiumAppClose
     {
         private void CloseApplication(string applicationId)
         {
-            DesiredCapabilities appCapabilities = new DesiredCapabilities();
-            appCapabilities.SetCapability("app", applicationId);
-            WindowsDriver<WindowsElement> session = new WindowsDriver<WindowsElement>(new Uri(CommonTestSettings.WindowsApplicationDriverUrl), appCapabilities);
-
-            Assert.IsNotNull(session);
+            WindowsDriver<WindowsElement> session = Utility.CreateNewSession(applicationId);
             Assert.IsNotNull(session.SessionId);
-            Assert.AreNotEqual(String.Empty, session.Title);
-            Assert.AreNotEqual(String.Empty, session.CurrentWindowHandle);
-            var originalWindowHandlesCount = session.WindowHandles.Count;
+            Assert.AreNotEqual(string.Empty, session.Title);
+            Assert.AreNotEqual(string.Empty, session.CurrentWindowHandle);
+            Assert.IsTrue(session.WindowHandles.Count > 0);
 
             session.CloseApp();
 
-            System.Threading.Thread.Sleep(3000); // Sleep for 3 second
-            Assert.IsNotNull(session);
+            Thread.Sleep(TimeSpan.FromSeconds(3));
             Assert.IsNotNull(session.SessionId);
-            Assert.AreEqual(originalWindowHandlesCount - 1, session.WindowHandles.Count);
+            Assert.AreEqual(0, session.WindowHandles.Count);
 
             try
             {
                 session.CloseApp(); // Attempt to close already closed app
                 Assert.Fail("Exception should have been thrown");
             }
-            catch (System.InvalidOperationException exception)
+            catch (InvalidOperationException exception)
             {
-                Assert.AreEqual("Currently selected window has been closed", exception.Message);
+                Assert.AreEqual(ErrorStrings.NoSuchWindow, exception.Message);
             }
 
             session.Quit();
         }
 
         [TestMethod]
-        public void CloseClassicApp()
+        public void Close_ClassicApp()
         {
             CloseApplication(CommonTestSettings.NotepadAppId);
         }
 
         [TestMethod]
-        public void CloseModernApp()
+        public void Close_ModernApp()
         {
             CloseApplication(CommonTestSettings.CalculatorAppId);
         }
 
         [TestMethod]
-        public void CloseSystemApp()
+        public void Close_SystemApp()
         {
             CloseApplication(CommonTestSettings.ExplorerAppId);
         }