puppeteer-ruby 0.45.6 → 0.50.0.alpha5

data/docs/api_coverage.md

@@ -1,22 +1,14 @@
 # API coverages
-- Puppeteer version: v19.5.0
-- puppeteer-ruby version: 0.45.6
+- Puppeteer version: v24.35.0
+- puppeteer-ruby version: 0.50.0.alpha5
 
 ## Puppeteer
 
-* ~~clearCustomQueryHandlers~~
 * connect
-* ~~createBrowserFetcher~~
-* ~~customQueryHandlerNames~~
 * defaultArgs => `#default_args`
-* devices
-* ~~errors~~
 * executablePath => `#executable_path`
 * launch
-* networkConditions => `#network_conditions`
 * ~~puppeteer~~
-* registerCustomQueryHandler => `#register_custom_query_handler`
-* ~~unregisterCustomQueryHandler~~
 
 ## ~~Accessibility~~
 
@@ -24,17 +16,28 @@
 
 ## Browser
 
+* ~~addScreen~~
 * browserContexts => `#browser_contexts`
 * close
-* createIncognitoBrowserContext => `#create_incognito_browser_context`
+* ~~cookies~~
+* createBrowserContext => `#create_browser_context`
 * defaultBrowserContext => `#default_browser_context`
+* ~~deleteCookie~~
+* ~~deleteMatchingCookies~~
 * disconnect
+* ~~getWindowBounds~~
+* ~~installExtension~~
 * isConnected => `#connected?`
 * newPage => `#new_page`
 * pages
 * process
+* ~~removeScreen~~
+* ~~screens~~
+* ~~setCookie~~
+* ~~setWindowBounds~~
 * target
 * targets
+* ~~uninstallExtension~~
 * userAgent => `#user_agent`
 * version
 * waitForTarget => `#wait_for_target`
@@ -45,23 +48,21 @@
 * browser
 * clearPermissionOverrides => `#clear_permission_overrides`
 * close
-* isIncognito => `#incognito?`
+* cookies
+* deleteCookie => `#delete_cookie`
+* deleteMatchingCookies => `#delete_matching_cookies`
 * newPage => `#new_page`
 * overridePermissions => `#override_permissions`
 * pages
+* setCookie => `#set_cookie`
 * targets
 * waitForTarget => `#wait_for_target`
 
-## ~~BrowserFetcher~~
+## ~~BrowserLauncher~~
 
-* ~~canDownload~~
-* ~~download~~
-* ~~host~~
-* ~~localRevisions~~
-* ~~platform~~
-* ~~product~~
-* ~~remove~~
-* ~~revisionInfo~~
+* ~~defaultArgs~~
+* ~~executablePath~~
+* ~~launch~~
 
 ## CDPSession
 
@@ -79,6 +80,9 @@
 * session
 * url
 
+## ~~ConnectionClosedError~~
+
+
 ## ConsoleMessage
 
 * args
@@ -99,8 +103,11 @@
 * start
 * stop
 
-## ~~CustomError~~
+## ~~DeviceRequestPrompt~~
 
+* ~~cancel~~
+* ~~select~~
+* ~~waitForDevice~~
 
 ## Dialog
 
@@ -116,8 +123,9 @@
 * $$ => `#query_selector_all`
 * $$eval => `#eval_on_selector_all`
 * $eval => `#eval_on_selector`
-* $x => `#Sx`
-* asElement => `#as_element`
+* ~~asLocator~~
+* ~~autofill~~
+* ~~backendNodeId~~
 * boundingBox => `#bounding_box`
 * boxModel => `#box_model`
 * click
@@ -130,27 +138,36 @@
 * drop
 * focus
 * hover
+* isHidden => `#hidden?`
 * isIntersectingViewport => `#intersecting_viewport?`
+* isVisible => `#visible?`
 * press
 * screenshot
+* ~~scrollIntoView~~
 * select
 * tap
 * toElement => `#to_element`
+* touchEnd => `#touch_end`
+* touchMove => `#touch_move`
+* touchStart => `#touch_start`
 * type => `#type_text`
 * uploadFile => `#upload_file`
 * waitForSelector => `#wait_for_selector`
-* waitForXPath => `#wait_for_xpath`
 
 ## ~~EventEmitter~~
 
-* ~~addListener~~
 * ~~emit~~
 * ~~listenerCount~~
 * ~~off~~
 * ~~on~~
 * ~~once~~
 * ~~removeAllListeners~~
-* ~~removeListener~~
+
+## ~~ExtensionTransport~~
+
+* ~~close~~
+* ~~connectTab~~
+* ~~send~~
 
 ## FileChooser
 
@@ -164,20 +181,19 @@
 * $$ => `#query_selector_all`
 * $$eval => `#eval_on_selector_all`
 * $eval => `#eval_on_selector`
-* $x => `#Sx`
 * addScriptTag => `#add_script_tag`
 * addStyleTag => `#add_style_tag`
-* addStyleTag => `#add_style_tag`
 * childFrames => `#child_frames`
 * click
 * content
 * evaluate
 * evaluateHandle => `#evaluate_handle`
 * focus
+* frameElement => `#frame_element`
 * goto
 * hover
 * isDetached => `#detached?`
-* isOOPFrame => `#oop_frame?`
+* ~~locator~~
 * name
 * page
 * parentFrame => `#parent_frame`
@@ -190,8 +206,6 @@
 * waitForFunction => `#wait_for_function`
 * waitForNavigation => `#wait_for_navigation`
 * waitForSelector => `#wait_for_selector`
-* waitForTimeout => `#wait_for_timeout`
-* waitForXPath => `#wait_for_xpath`
 
 ## HTTPRequest
 
@@ -201,8 +215,10 @@
 * continueRequestOverrides => `#continue_request_overrides`
 * enqueueInterceptAction => `#enqueue_intercept_action`
 * failure
+* fetchPostData => `#fetch_post_data`
 * finalizeInterceptions => `#finalize_interceptions`
 * frame
+* ~~hasPostData~~
 * headers
 * initiator
 * interceptResolutionState => `#intercept_resolution_state`
@@ -220,6 +236,7 @@
 ## HTTPResponse
 
 * buffer
+* ~~content~~
 * frame
 * ~~fromCache~~
 * ~~fromServiceWorker~~
@@ -232,7 +249,7 @@
 * status
 * statusText => `#status_text`
 * text
-* ~~timing~~
+* timing
 * url
 
 ## JSCoverage
@@ -248,10 +265,9 @@
 * evaluateHandle => `#evaluate_handle`
 * getProperties => `#properties`
 * getProperty => `#[]`
-* getProperty => `#[]`
 * jsonValue => `#json_value`
 * remoteObject => `#remote_object`
-* ~~toString~~
+* toString => `#to_s`
 
 ## Keyboard
 
@@ -261,6 +277,24 @@
 * type => `#type_text`
 * up
 
+## ~~Locator~~
+
+* ~~click~~
+* ~~clone~~
+* ~~fill~~
+* ~~filter~~
+* ~~hover~~
+* ~~map~~
+* ~~race~~
+* ~~scroll~~
+* ~~setEnsureElementIsInTheViewport~~
+* ~~setTimeout~~
+* ~~setVisibility~~
+* ~~setWaitForEnabled~~
+* ~~setWaitForStableBoundingBox~~
+* ~~wait~~
+* ~~waitHandle~~
+
 ## Mouse
 
 * click
@@ -271,6 +305,7 @@
 * dragOver => `#drag_over`
 * drop
 * move
+* reset
 * up
 * wheel
 
@@ -280,11 +315,8 @@
 * $$ => `#query_selector_all`
 * $$eval => `#eval_on_selector_all`
 * $eval => `#eval_on_selector`
-* $x => `#Sx`
 * addScriptTag => `#add_script_tag`
 * addStyleTag => `#add_style_tag`
-* addStyleTag => `#add_style_tag`
-* addStyleTag => `#add_style_tag`
 * authenticate
 * bringToFront => `#bring_to_front`
 * browser
@@ -293,10 +325,12 @@
 * close
 * content
 * cookies
+* ~~createCDPSession~~
 * createPDFStream => `#create_pdf_stream`
 * deleteCookie => `#delete_cookie`
 * emulate
 * emulateCPUThrottling => `#emulate_cpu_throttling`
+* ~~emulateFocusedPage~~
 * emulateIdleState => `#emulate_idle_state`
 * emulateMediaFeatures => `#emulate_media_features`
 * emulateMediaType => `#emulate_media_type`
@@ -309,6 +343,7 @@
 * exposeFunction => `#expose_function`
 * focus
 * frames
+* ~~getDefaultNavigationTimeout~~
 * ~~getDefaultTimeout~~
 * goBack => `#go_back`
 * goForward => `#go_forward`
@@ -317,17 +352,22 @@
 * isClosed => `#closed?`
 * isDragInterceptionEnabled => `#drag_interception_enabled?`
 * isJavaScriptEnabled => `#javascript_enabled?`
+* isServiceWorkerBypassed => `#service_worker_bypassed?`
+* ~~locator~~
 * mainFrame => `#main_frame`
 * metrics
-* ~~off~~
-* on
-* once
+* ~~openDevTools~~
 * pdf
 * queryObjects => `#query_objects`
 * reload
+* removeExposedFunction => `#remove_exposed_function`
+* removeScriptToEvaluateOnNewDocument => `#remove_script_to_evaluate_on_new_document`
+* ~~resize~~
+* ~~screencast~~
 * screenshot
 * select
 * setBypassCSP => `#bypass_csp=`
+* ~~setBypassServiceWorker~~
 * setCacheEnabled => `#cache_enabled=`
 * setContent => `#content=`
 * setCookie => `#set_cookie`
@@ -347,26 +387,24 @@
 * type => `#type_text`
 * url
 * viewport
+* ~~waitForDevicePrompt~~
 * waitForFileChooser => `#wait_for_file_chooser`
 * waitForFrame => `#wait_for_frame`
 * waitForFunction => `#wait_for_function`
 * waitForNavigation => `#wait_for_navigation`
-* ~~waitForNetworkIdle~~
+* waitForNetworkIdle => `#wait_for_network_idle`
 * waitForRequest => `#wait_for_request`
 * waitForResponse => `#wait_for_response`
 * waitForSelector => `#wait_for_selector`
-* waitForTimeout => `#wait_for_timeout`
-* waitForXPath => `#wait_for_xpath`
+* ~~windowId~~
 * workers
 
-## ~~ProductLauncher~~
+## ~~ProtocolError~~
 
-* ~~defaultArgs~~
-* ~~executablePath~~
-* ~~launch~~
 
-## ~~ProtocolError~~
+## ~~ScreenRecorder~~
 
+* ~~stop~~
 
 ## ~~SecurityDetails~~
 
@@ -379,6 +417,7 @@
 
 ## Target
 
+* ~~asPage~~
 * browser
 * browserContext => `#browser_context`
 * createCDPSession => `#create_cdp_session`
@@ -386,22 +425,32 @@
 * page
 * type
 * url
-* ~~worker~~
+* worker
 
 ## TimeoutError
 
 
-## ~~Touchscreen~~
+## TouchError
 
-* ~~tap~~
+
+## Touchscreen
+
+* tap
+* touchEnd => `#touch_end`
+* touchMove => `#touch_move`
+* touchStart => `#touch_start`
 
 ## Tracing
 
 * start
 * stop
 
-## ~~WebWorker~~
+## ~~UnsupportedOperation~~
+
 
-* ~~evaluate~~
-* ~~evaluateHandle~~
-* ~~url~~
+## WebWorker
+
+* close
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* url

data/lib/puppeteer/aria_query_handler.rb

@@ -48,7 +48,7 @@ class Puppeteer::AriaQueryHandler
     end
   end
 
-  def wait_for(element_or_frame, selector, visible: nil, hidden: nil, timeout: nil)
+  def wait_for(element_or_frame, selector, visible: nil, hidden: nil, timeout: nil, polling: nil)
     case element_or_frame
     when Puppeteer::Frame
       frame = element_or_frame
@@ -80,6 +80,7 @@ class Puppeteer::AriaQueryHandler
       visible: visible,
       hidden: hidden,
       timeout: timeout,
+      polling: polling,
       binding_function: binding_function,
     )
 
@@ -103,7 +104,7 @@ class Puppeteer::AriaQueryHandler
       promises = res.map do |ax_node|
         world.send(:async_adopt_backend_node, ax_node['backendDOMNodeId'])
       end
-      await_all(*promises)
+      Puppeteer::AsyncUtils.await_promise_all(*promises)
     end
   end
 

data/lib/puppeteer/async_utils.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+require "async"
+require "async/barrier"
+require "async/promise"
+
+module Puppeteer
+  # Async helpers for Promise-style coordination using socketry/async.
+  module AsyncUtils
+    extend self
+
+    def await(task)
+      if task.is_a?(Proc)
+        task.call
+      elsif task.is_a?(Async::Promise)
+        current_task = Async::Task.current?
+        if current_task
+          until task.resolved?
+            current_task.sleep(0.001)
+          end
+        end
+        task.wait
+      elsif task.respond_to?(:wait)
+        task.wait
+      else
+        task
+      end
+    end
+
+    # Execute a task with a timeout using Async::Task#with_timeout.
+    # @param timeout_ms [Numeric] Timeout duration in milliseconds (0 means no timeout)
+    # @param task [Proc, Async::Promise, nil] Task to execute; falls back to block
+    # @yield [async_task] Execute a task within the timeout, optionally receiving Async::Task
+    # @return [Async::Task] Async task that resolves/rejects once the operation completes
+    def async_timeout(timeout_ms, task = nil, &block)
+      if task
+        runner = lambda do |async_task|
+          if timeout_ms == 0
+            if task.is_a?(Proc)
+              args = task.arity.positive? ? [async_task] : []
+              task.call(*args)
+            else
+              await(task)
+            end
+          else
+            timeout_seconds = timeout_ms / 1000.0
+            async_task.with_timeout(timeout_seconds) do
+              if task.is_a?(Proc)
+                args = task.arity.positive? ? [async_task] : []
+                task.call(*args)
+              else
+                await(task)
+              end
+            end
+          end
+        end
+      elsif block
+        runner = lambda do |async_task|
+          if timeout_ms == 0
+            args = block.arity.positive? ? [async_task] : []
+            await(block.call(*args))
+          else
+            timeout_seconds = timeout_ms / 1000.0
+            async_task.with_timeout(timeout_seconds) do
+              args = block.arity.positive? ? [async_task] : []
+              await(block.call(*args))
+            end
+          end
+        end
+      else
+        raise ArgumentError.new("AsyncUtils.async_timeout requires a task or block")
+      end
+
+      current_task = Async::Task.current?
+      if current_task
+        return current_task.async do |async_task|
+          runner.call(async_task)
+        end
+      end
+
+      result = nil
+      error = nil
+      Async do |async_task|
+        result = runner.call(async_task)
+      rescue => err
+        error = err
+      end.wait
+
+      ImmediateTask.new(result, error)
+    end
+
+    # Wait for all async tasks to complete and return results.
+    def await_promise_all(*tasks)
+      Sync { zip(*tasks) }
+    end
+
+    # Race multiple async tasks and return the result of the first one to complete.
+    def await_promise_race(*tasks)
+      Sync { first(*tasks) }
+    end
+
+    def future_with_logging(&block)
+      proc do |*block_args|
+        block.call(*block_args)
+      rescue ::Puppeteer::TimeoutError
+        raise
+      rescue => err
+        warn("#{err.message} (#{err.class})")
+        raise err
+      end
+    end
+
+    def sleep_seconds(duration)
+      task = Async::Task.current
+      if task
+        task.sleep(duration)
+      else
+        Kernel.sleep(duration)
+      end
+    rescue RuntimeError, NoMethodError
+      Kernel.sleep(duration)
+    end
+
+    class ImmediateTask
+      def initialize(result, error)
+        @result = result
+        @error = error
+      end
+
+      def wait
+        raise @error if @error
+
+        @result
+      end
+    end
+
+    private def zip(*tasks)
+      barrier = Async::Barrier.new
+      results = Array.new(tasks.size)
+
+      begin
+        tasks.each_with_index do |task, index|
+          barrier.async do
+            results[index] = await(task)
+          end
+        end
+
+        barrier.wait
+        results
+      rescue Exception
+        drain_barrier_tasks(barrier)
+        raise
+      end
+    end
+
+    private def first(*tasks)
+      barrier = Async::Barrier.new
+      result = nil
+
+      begin
+        tasks.each do |task|
+          barrier.async(finished: false) do
+            await(task)
+          end
+        end
+
+        barrier.wait do |completed_task|
+          result = completed_task.wait
+          break
+        end
+
+        result
+      ensure
+        drain_barrier_tasks(barrier)
+      end
+    end
+
+    private def drain_barrier_tasks(barrier)
+      pending = barrier.tasks.to_a
+      return if pending.empty?
+
+      barrier.stop
+      pending.each do |waiting|
+        task = waiting.task
+        next unless task.completed? || task.failed? || task.stopped?
+
+        begin
+          task.wait
+        rescue StandardError
+          # The race winner is already decided; ignore losers' errors.
+        end
+      end
+    end
+  end
+end
+
+module AsyncPromiseWaitRetry
+  def wait(...)
+    loop do
+      begin
+        return super
+      rescue ThreadError => e
+        raise unless e.message == 'Attempt to unlock a mutex which is not locked'
+        next unless resolved?
+
+        value = self.value
+        raise value if value.is_a?(Exception)
+        return value
+      end
+    end
+  end
+end
+
+Async::Promise.prepend(AsyncPromiseWaitRetry)