Split page (#2576)

* Split page

* Docs changes

---------

Co-authored-by: GitHub Action <action@github.com>

lib/PuppeteerSharp/Cdp/CdpPageTarget.cs

@@ -37,9 +37,9 @@ public override async Task<IPage> PageAsync()
         {
             if (PageTask == null)
             {
-                var session = Session ?? await SessionFactory(false).ConfigureAwait(false);
+                var session = (CdpCDPSession)(Session ?? await SessionFactory(false).ConfigureAwait(false));
 
-                PageTask = Page.CreateAsync(
+                PageTask = CdpPage.CreateAsync(
                     session,
                     this,
                     _ignoreHTTPSErrors,

lib/PuppeteerSharp/Cdp/CdpTarget.cs

@@ -54,11 +54,11 @@ public override async Task<IPage> AsPageAsync()
     {
         if (Session == null)
         {
-            var session = await CreateCDPSessionAsync().ConfigureAwait(false) as CDPSession;
-            return await Page.CreateAsync(session, this, false, null, ScreenshotTaskQueue).ConfigureAwait(false);
+            var session = (CdpCDPSession)await CreateCDPSessionAsync().ConfigureAwait(false);
+            return await CdpPage.CreateAsync(session, this, false, null, ScreenshotTaskQueue).ConfigureAwait(false);
         }
 
-        return await Page.CreateAsync(Session, this, false, null, ScreenshotTaskQueue).ConfigureAwait(false);
+        return await CdpPage.CreateAsync((CdpCDPSession)Session, this, false, null, ScreenshotTaskQueue).ConfigureAwait(false);
     }
 
     /// <inheritdoc/>

lib/PuppeteerSharp/Frame.cs

@@ -275,6 +275,19 @@ public async Task FocusAsync(string selector)
             await handle.FocusAsync().ConfigureAwait(false);
         }
 
+        /// <inheritdoc/>
+        public async Task TapAsync(string selector)
+        {
+            var handle = await QuerySelectorAsync(selector).ConfigureAwait(false);
+            if (handle == null)
+            {
+                throw new SelectorException($"No node found for selector: {selector}", selector);
+            }
+
+            await handle.TapAsync().ConfigureAwait(false);
+            await handle.DisposeAsync().ConfigureAwait(false);
+        }
+
         /// <inheritdoc/>
         public async Task TypeAsync(string selector, string text, TypeOptions options = null)
         {

lib/PuppeteerSharp/IFrame.cs

@@ -451,5 +451,13 @@ public interface IFrame
         /// <param name="options">Optional waiting parameters.</param>
         /// <returns>A task that resolves after the page gets the prompt.</returns>
         Task<DeviceRequestPrompt> WaitForDevicePromptAsync(WaitForOptions options = null);
+
+        /// <summary>
+        /// Fetches an element with <paramref name="selector"/>, scrolls it into view if needed, and then uses <see cref="Touchscreen"/> to tap in the center of the element.
+        /// </summary>
+        /// <param name="selector">A selector to search for element to tap. If there are multiple elements satisfying the selector, the first will be clicked.</param>
+        /// <exception cref="SelectorException">If there's no element matching <paramref name="selector"/>.</exception>
+        /// <returns>Task which resolves when the element matching <paramref name="selector"/> is successfully tapped.</returns>
+        Task TapAsync(string selector);
     }
 }

lib/PuppeteerSharp/IResponse.cs

@@ -9,7 +9,6 @@ namespace PuppeteerSharp
     /// <summary>
     /// <see cref="IResponse"/> class represents responses which are received by page.
     /// </summary>
-    /// <seealso cref="Page.GoAsync(int, NavigationOptions)"/>
     /// <seealso cref="IPage.GoForwardAsync(NavigationOptions)"/>
     /// <seealso cref="IPage.ReloadAsync(int?, WaitUntilNavigation[])"/>
     /// <seealso cref="IPage.Response"/>