Merge pull request #276 from Lombiq/issue/SPAL-21

SPAL-21: Added point to Troubleshooting

Lombiq.Tests.UI/Docs/Troubleshooting.md

@@ -20,6 +20,7 @@
     3. Run `dotnet dev-certs https --trust` and accept the security warning that pops up. (This is why we can't automate all of this.)
     4. Now `dotnet dev-certs https --check --verbose` should display "A valid certificate was found."
 - If you have retries configured for the tests and they've been running for a long time without any visible progress then most possibly all of them are failing. This can happen e.g. if the setup or initialization steps are failing. However, by default the `OrchardCoreUITestExecutorConfiguration.FastFailSetup` configuration will quickly fail all affected tests if a common setup operation is failing, without retrying it for all tests.
+- If tests fail at the start with the exception screen saying ``InvalidOperationException: Unable to resolve service for type 'Microsoft.AspNetCore.Identity.ILookupNormalizer' while attempting to activate 'Microsoft.AspNetCore.Identity.RoleManager`1[OrchardCore.Security.IRole]'.``, add the `Lombiq.Tests.UI.Shortcuts` dependency to your web project.
 
 ## Issues with driving browsers
 

Lombiq.Tests.UI/Extensions/NavigationUITestContextExtensions.cs

@@ -291,6 +291,22 @@ public static void DismissAlert(this UITestContext context)
         context.Driver.SwitchTo().DefaultContent();
     }
 
+    /// <summary>
+    /// Clicks on the first matching element, switches control to the JS alert/prompt box that's expected to appear,
+    /// enters <paramref name="inputText"/> as keystrokes if it's not <see langword="null"/>, accepts the alert/prompt
+    /// box, and switches control back to main document or first frame.
+    /// </summary>
+    public static void ClickAndAcceptPrompt(this UITestContext context, By by, string inputText = null)
+    {
+        // Using FindElement() here because ClickReliablyOnAsync() would throw an "Unexpected Alert Open" exception.
+        context.Driver.FindElement(by).Click();
+
+        var alert = context.Driver.SwitchTo().Alert();
+        if (inputText != null) alert.SendKeys(inputText);
+        alert.Accept();
+        context.Driver.SwitchTo().DefaultContent();
+    }
+
     /// <summary>
     /// Refreshes (reloads) the current page.
     /// </summary>