puppeteer-ruby 0.51.0 → 0.52.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74f00095ae82e1e4502260b99ff766cc46c758ae5e762050a6e7c46b7249f469
-  data.tar.gz: a197f92fc8b7ccbe2904c088d52e60409af119d94449a6a4e9f518601c4c5788
+  metadata.gz: 70526928098a3ab1bcf1718b6110a6620188a30c77419a04181cb746acf4ed15
+  data.tar.gz: 073e09f7dd759b1b2b2d268ec3021cab96c3e56df93353343fd6ded898556d7b
 SHA512:
-  metadata.gz: df595ba0c4996b100b1d8b22bb35e0e0ce9b6552d368c11fc25b9c8cf60c1a270b651f6f96e6c1b65b64d32550b71c402a059a0fd4d3a1393a394b65de472aef
-  data.tar.gz: f82344aba53b730d5fdb7273ef29fdb07d0b8aadc831d680fd5611d55df980955cb5fd5cbdbe78d0de88c70d689f738952187193b4f006386a2170970f928dd2
+  metadata.gz: a222036f53e7552d12a8340850369aeed45277f44f1914984ff91168131fbc8ad0a93adf0a3ffe07b98e0f5038a14ee2da6239685bdbf297883bb2702d31df86
+  data.tar.gz: 57c5a117800a1b814d77abd3ad41d9b25487b08993e1752327dbac49a3e80474c612a52dd3141fd1025dd4fc96e5758c199a82de470abba73e290a5316db0516

data/docs/api_coverage.md

@@ -1,5 +1,5 @@
 # API coverages
-- Puppeteer version: v24.37.0
+- Puppeteer version: v24.42.0
 - puppeteer-ruby version: 0.51.0
 
 ## Puppeteer
@@ -25,8 +25,9 @@
 * ~~deleteCookie~~
 * ~~deleteMatchingCookies~~
 * disconnect
+* extensions
 * ~~getWindowBounds~~
-* ~~installExtension~~
+* installExtension => `#install_extension`
 * isConnected => `#connected?`
 * newPage => `#new_page`
 * pages
@@ -38,7 +39,7 @@
 * ~~setWindowBounds~~
 * target
 * targets
-* ~~uninstallExtension~~
+* uninstallExtension => `#uninstall_extension`
 * userAgent => `#user_agent`
 * version
 * waitForTarget => `#wait_for_target`
@@ -126,7 +127,7 @@
 * $$eval => `#eval_on_selector_all`
 * $eval => `#eval_on_selector`
 * asLocator => `#as_locator`
-* ~~autofill~~
+* autofill
 * ~~backendNodeId~~
 * boundingBox => `#bounding_box`
 * boxModel => `#box_model`
@@ -165,6 +166,12 @@
 * ~~once~~
 * ~~removeAllListeners~~
 
+## Extension
+
+* pages
+* triggerAction => `#trigger_action`
+* workers
+
 ## ~~ExtensionTransport~~
 
 * ~~close~~
@@ -190,6 +197,7 @@
 * content
 * evaluate
 * evaluateHandle => `#evaluate_handle`
+* extensionRealms => `#extension_realms`
 * focus
 * frameElement => `#frame_element`
 * goto
@@ -344,6 +352,7 @@
 * evaluateHandle => `#evaluate_handle`
 * evaluateOnNewDocument => `#evaluate_on_new_document`
 * exposeFunction => `#expose_function`
+* extensionRealms => `#extension_realms`
 * focus
 * frames
 * ~~getDefaultNavigationTimeout~~
@@ -351,6 +360,7 @@
 * goBack => `#go_back`
 * goForward => `#go_forward`
 * goto
+* ~~hasDevTools~~
 * hover
 * isClosed => `#closed?`
 * isDragInterceptionEnabled => `#drag_interception_enabled?`
@@ -387,6 +397,7 @@
 * tap
 * target
 * title
+* triggerExtensionAction => `#trigger_extension_action`
 * type => `#type_text`
 * url
 * viewport
@@ -405,6 +416,13 @@
 ## ~~ProtocolError~~
 
 
+## ~~Realm~~
+
+* ~~evaluate~~
+* ~~evaluateHandle~~
+* ~~extension~~
+* ~~waitForFunction~~
+
 ## ~~ScreenRecorder~~
 
 * ~~stop~~
@@ -420,7 +438,7 @@
 
 ## Target
 
-* ~~asPage~~
+* asPage => `#as_page`
 * browser
 * browserContext => `#browser_context`
 * createCDPSession => `#create_cdp_session`
@@ -451,6 +469,17 @@
 ## ~~UnsupportedOperation~~
 
 
+## ~~WebMCP~~
+
+* ~~tools~~
+
+## ~~WebMCPTool~~
+
+* ~~execute~~
+
+## ~~WebMCPToolCall~~
+
+
 ## WebWorker
 
 * close

data/lib/puppeteer/browser.rb

@@ -14,6 +14,8 @@ class Puppeteer::Browser
   # @rbs ignore_https_errors: bool -- Ignore HTTPS errors
   # @rbs default_viewport: Puppeteer::Viewport? -- Default viewport
   # @rbs network_enabled: bool -- Whether network events are enabled
+  # @rbs issues_enabled: bool -- Whether issues events are enabled
+  # @rbs block_list: Array[String]? -- URL block list patterns
   # @rbs process: Puppeteer::BrowserRunner::BrowserProcess? -- Browser process handle
   # @rbs close_callback: Proc -- Close callback
   # @rbs target_filter_callback: Proc? -- Target filter callback
@@ -25,6 +27,8 @@ class Puppeteer::Browser
                   ignore_https_errors:,
                   default_viewport:,
                   network_enabled: true,
+                  issues_enabled: true,
+                  block_list: nil,
                   process:,
                   close_callback:,
                   target_filter_callback:,
@@ -36,6 +40,8 @@ class Puppeteer::Browser
       ignore_https_errors: ignore_https_errors,
       default_viewport: default_viewport,
       network_enabled: network_enabled,
+      issues_enabled: issues_enabled,
+      block_list: block_list,
       process: process,
       close_callback: close_callback,
       target_filter_callback: target_filter_callback,
@@ -51,6 +57,8 @@ class Puppeteer::Browser
   # @rbs ignore_https_errors: bool -- Ignore HTTPS errors
   # @rbs default_viewport: Puppeteer::Viewport? -- Default viewport
   # @rbs network_enabled: bool -- Whether network events are enabled
+  # @rbs issues_enabled: bool -- Whether issues events are enabled
+  # @rbs block_list: Array[String]? -- URL block list patterns
   # @rbs process: Puppeteer::BrowserRunner::BrowserProcess? -- Browser process handle
   # @rbs close_callback: Proc -- Close callback
   # @rbs target_filter_callback: Proc? -- Target filter callback
@@ -62,6 +70,8 @@ class Puppeteer::Browser
                  ignore_https_errors:,
                  default_viewport:,
                  network_enabled: true,
+                 issues_enabled: true,
+                 block_list: nil,
                  process:,
                  close_callback:,
                  target_filter_callback:,
@@ -73,6 +83,8 @@ class Puppeteer::Browser
     @ignore_https_errors = ignore_https_errors
     @default_viewport = default_viewport
     @network_enabled = network_enabled
+    @issues_enabled = issues_enabled
+    @block_list = block_list
     @process = process
     @connection = connection
     @close_callback = close_callback
@@ -89,7 +101,9 @@ class Puppeteer::Browser
       connection: connection,
       target_factory: method(:create_target),
       target_filter_callback: @target_filter_callback,
+      block_list: block_list,
     )
+    @extensions = {}
   end
 
   private def default_target_filter_callback(target_info)
@@ -163,6 +177,10 @@ class Puppeteer::Browser
     @target_manager
   end
 
+  private def connection
+    @connection
+  end
+
   # @rbs return: Puppeteer::BrowserContext -- New incognito browser context
   def create_incognito_browser_context
     result = @connection.send_message('Target.createBrowserContext')
@@ -376,6 +394,63 @@ class Puppeteer::Browser
     Version.fetch(@connection).user_agent
   end
 
+  # @rbs page_target_id: String -- Page target id
+  # @rbs return: String? -- DevTools target id for page
+  def _has_devtools_target(page_target_id)
+    result = @connection.send_message('Target.getDevToolsTarget', targetId: page_target_id)
+    result['targetId']
+  end
+
+  # @rbs path: String -- Extension path
+  # @rbs return: String -- Installed extension id
+  def install_extension(path)
+    result = @connection.send_message('Extensions.loadUnpacked', path: path)
+    extension_id = result['id']
+    @extensions.delete(extension_id)
+    extension_id
+  end
+
+  # @rbs extension_id: String -- Extension id
+  # @rbs return: void -- No return value
+  def uninstall_extension(extension_id)
+    @connection.send_message('Extensions.uninstall', id: extension_id)
+    @extensions.delete(extension_id)
+  end
+
+  # @rbs return: Hash[String, Puppeteer::Extension] -- Installed extensions
+  def extensions
+    response = @connection.send_message('Extensions.getExtensions')
+    extension_map = {}
+    response.fetch('extensions', []).each do |payload|
+      extension_id = payload['id']
+      existing_extension = @extensions[extension_id]
+      extension_map[extension_id] =
+        if existing_extension
+          existing_extension
+        else
+          Puppeteer::Extension.new(
+            id: extension_id,
+            version: payload['version'],
+            name: payload['name'],
+            path: payload['path'],
+            enabled: payload['enabled'],
+            browser: self,
+          )
+        end
+    end
+    @extensions = extension_map
+  end
+
+  # @rbs return: bool -- Whether issue events are enabled
+  def issues_enabled?
+    @issues_enabled
+  end
+
+  # @rbs return: Array[String]? -- URL block list patterns
+  def block_list
+    @block_list
+  end
+
   # @rbs return: void -- No return value
   def close
     @close_callback.call

data/lib/puppeteer/browser_connector.rb

@@ -1,4 +1,5 @@
 require_relative './browser'
+require_relative './chrome_user_data_dir'
 require_relative './launcher/browser_options'
 
 class Puppeteer::BrowserConnector
@@ -7,6 +8,7 @@ class Puppeteer::BrowserConnector
     @browser_ws_endpoint = options[:browser_ws_endpoint]
     @browser_url = options[:browser_url]
     @transport = options[:transport]
+    @channel = options[:channel]
   end
 
   # @return [Puppeteer::Browser]
@@ -28,6 +30,8 @@ class Puppeteer::BrowserConnector
       ignore_https_errors: @browser_options.ignore_https_errors?,
       default_viewport: @browser_options.default_viewport,
       network_enabled: @browser_options.network_enabled,
+      issues_enabled: @browser_options.issues_enabled,
+      block_list: @browser_options.block_list,
       process: nil,
       close_callback: -> { connection.send_message('Browser.close') },
       target_filter_callback: @browser_options.target_filter,
@@ -36,16 +40,24 @@ class Puppeteer::BrowserConnector
   end
 
   private def connection
-    @connection ||=
-      if @browser_ws_endpoint && @browser_url.nil? && @transport.nil?
+    @connection ||= begin
+      connection_options = [@browser_ws_endpoint, @browser_url, @transport, @channel]
+      unless connection_options.count { |option| !!option } == 1
+        raise ArgumentError.new('Exactly one of browserWSEndpoint, browserURL, transport or channel must be passed to puppeteer.connect')
+      end
+
+      if @transport
+        connect_with_transport(@transport)
+      elsif @browser_ws_endpoint
         connect_with_browser_ws_endpoint(@browser_ws_endpoint)
-      elsif @browser_ws_endpoint.nil? && @browser_url && @transport.nil?
+      elsif @browser_url
         connect_with_browser_url(@browser_url)
-      elsif @browser_ws_endpoint.nil? && @browser_url.nil? && @transport
-        connect_with_transport(@transport)
+      elsif @channel
+        connect_with_channel(@channel)
       else
-        raise ArgumentError.new("Exactly one of browserWSEndpoint, browserURL or transport must be passed to puppeteer.connect")
+        raise ArgumentError.new('Invalid connection options')
       end
+    end
   end
 
   # @return [Puppeteer::Connection]
@@ -70,6 +82,31 @@ class Puppeteer::BrowserConnector
     connect_with_browser_ws_endpoint(connection_url)
   end
 
+  # @return [Puppeteer::Connection]
+  private def connect_with_channel(channel)
+    port_path = File.join(
+      Puppeteer::ChromeUserDataDir.resolve_default(channel),
+      'DevToolsActivePort',
+    )
+
+    begin
+      file_content = File.read(port_path, mode: 'r:ASCII')
+      raw_port, raw_path = file_content.lines.map(&:strip).reject(&:empty?)
+      unless raw_port && raw_path
+        raise Puppeteer::Error.new("Invalid DevToolsActivePort '#{file_content}' found")
+      end
+
+      port = raw_port.to_i
+      if port <= 0 || port > 65_535
+        raise Puppeteer::Error.new("Invalid port '#{raw_port}' found")
+      end
+
+      connect_with_browser_ws_endpoint("ws://localhost:#{port}#{raw_path}")
+    rescue StandardError
+      raise Puppeteer::Error.new("Could not find DevToolsActivePort for #{channel} at #{port_path}")
+    end
+  end
+
   # @return [Puppeteer::Connection]
   private def connect_with_transport(transport)
     Puppeteer::Connection.new(

data/lib/puppeteer/chrome_target_manager.rb

@@ -2,7 +2,7 @@ class Puppeteer::ChromeTargetManager
   include Puppeteer::DebugPrint
   include Puppeteer::EventCallbackable
 
-  def initialize(connection:, target_factory:, target_filter_callback:)
+  def initialize(connection:, target_factory:, target_filter_callback:, block_list: nil)
     @discovered_targets_by_target_id = {}
     @attached_targets_by_target_id = {}
     @attached_targets_by_session_id = {}
@@ -13,8 +13,13 @@ class Puppeteer::ChromeTargetManager
     @connection = connection
     @target_filter_callback = target_filter_callback
     @target_factory = target_factory
+    @block_list = block_list
+    if @block_list && !@block_list.is_a?(Array)
+      raise ArgumentError.new('block_list must be an Array of URL patterns')
+    end
     @target_interceptors = {}
     @initialize_promise = Async::Promise.new
+    @initial_attach_done = false
 
     @connection_event_listeners = []
     @connection_event_listeners << @connection.add_event_listener(
@@ -52,7 +57,7 @@ class Puppeteer::ChromeTargetManager
 
   private def store_existing_targets_for_init
     @discovered_targets_by_target_id.each do |target_id, target_info|
-      if @target_filter_callback.call(target_info) && target_info.type != 'browser'
+      if @target_filter_callback.call(target_info) && target_info.type != 'browser' && url_allowed?(target_info.url)
         @target_ids_for_init << target_id
       end
     end
@@ -64,6 +69,7 @@ class Puppeteer::ChromeTargetManager
       flatten: true,
       autoAttach: true,
     })
+    @initial_attach_done = true
     finish_initialization_if_ready
     @initialize_promise.wait
   end
@@ -204,6 +210,12 @@ class Puppeteer::ChromeTargetManager
 
     return unless @connection.auto_attached?(target_info.target_id)
 
+    if !@initial_attach_done && !url_allowed?(target_info.url)
+      finish_initialization_if_ready(target_info.target_id)
+      silent_detach.call
+      return
+    end
+
     # Special case for service workers: being attached to service workers will
     # prevent them from ever being destroyed. Therefore, we silently detach
     # from service workers unless the connection was manually created via
@@ -270,6 +282,7 @@ class Puppeteer::ChromeTargetManager
         flatten: true,
         autoAttach: true,
       }))
+      maybe_setup_network_conditions(session)
       Puppeteer::AsyncUtils.await(session.async_send_message('Runtime.runIfWaitingForDebugger'))
     rescue => err
       Logger.new($stderr).warn(err)
@@ -292,4 +305,38 @@ class Puppeteer::ChromeTargetManager
     @attached_targets_by_target_id.delete(target.target_id)
     emit_event(TargetManagerEmittedEvents::TargetGone, target)
   end
+
+  private def url_allowed?(url)
+    return true if @block_list.nil? || @block_list.empty?
+    return true if url.nil? || url.empty? || url == 'about:blank'
+
+    @block_list.none? do |pattern|
+      File.fnmatch?(pattern, url, File::FNM_EXTGLOB)
+    rescue ArgumentError
+      false
+    end
+  end
+
+  private def maybe_setup_network_conditions(session)
+    return if @block_list.nil? || @block_list.empty?
+
+    matched_network_conditions = @block_list.map do |pattern|
+      {
+        urlPattern: pattern,
+        latency: 0,
+        downloadThroughput: -1,
+        uploadThroughput: -1,
+      }
+    end
+    Puppeteer::AsyncUtils.await(session.async_send_message('Network.enable'))
+    Puppeteer::AsyncUtils.await(session.async_send_message('Network.emulateNetworkConditionsByRule', {
+      matchedNetworkConditions: matched_network_conditions,
+      offline: true,
+    }))
+  rescue => err
+    message = err.message.to_s.downcase
+    return if message.include?('target closed') || message.include?('session closed') || message.include?('not found')
+
+    raise
+  end
 end

data/lib/puppeteer/chrome_user_data_dir.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require_relative './env'
+
+module Puppeteer::ChromeUserDataDir
+  CHANNELS = %w[chrome chrome-beta chrome-canary chrome-dev].freeze #: Array[String]
+
+  MAC_DIR_NAMES = {
+    'chrome' => 'Chrome',
+    'chrome-beta' => 'Chrome Beta',
+    'chrome-canary' => 'Chrome Canary',
+    'chrome-dev' => 'Chrome Dev',
+  }.freeze #: Hash[String, String]
+
+  LINUX_DIR_NAMES = {
+    'chrome' => 'google-chrome',
+    'chrome-beta' => 'google-chrome-beta',
+    'chrome-canary' => 'google-chrome-canary',
+    'chrome-dev' => 'google-chrome-unstable',
+  }.freeze #: Hash[String, String]
+
+  WINDOWS_DIR_NAMES = {
+    'chrome' => ['Google', 'Chrome', 'User Data'],
+    'chrome-beta' => ['Google', 'Chrome Beta', 'User Data'],
+    'chrome-canary' => ['Google', 'Chrome SxS', 'User Data'],
+    'chrome-dev' => ['Google', 'Chrome Dev', 'User Data'],
+  }.freeze #: Hash[String, Array[String]]
+
+  # @rbs channel: (String | Symbol) -- Chrome release channel
+  # @rbs platform: Symbol? -- Optional platform override
+  # @rbs env: Hash[String, String] -- Environment variables
+  # @rbs home: String? -- Home directory override
+  # @rbs return: String -- Default user data directory
+  def self.resolve_default(channel, platform: nil, env: ENV, home: nil)
+    channel = normalize_channel(channel)
+    platform ||= current_platform
+    home ||= Dir.home
+
+    case platform.to_sym
+    when :windows
+      base = env['LOCALAPPDATA']
+      base = join_path(:windows, home, 'AppData', 'Local') if base.nil? || base.empty?
+      join_path(:windows, base, *WINDOWS_DIR_NAMES.fetch(channel))
+    when :darwin
+      join_path(:darwin, home, 'Library', 'Application Support', 'Google', MAC_DIR_NAMES.fetch(channel))
+    when :linux
+      base = env['CHROME_CONFIG_HOME']
+      base = env['XDG_CONFIG_HOME'] if base.nil? || base.empty?
+      base = join_path(:linux, home, '.config') if base.nil? || base.empty?
+      join_path(:linux, base, LINUX_DIR_NAMES.fetch(channel))
+    else
+      raise ArgumentError.new("Unsupported platform: #{platform}")
+    end
+  end
+
+  # @rbs channel: (String | Symbol) -- Chrome release channel
+  # @rbs return: String -- Normalized channel
+  def self.normalize_channel(channel)
+    normalized_channel = channel.to_s
+    return normalized_channel if CHANNELS.include?(normalized_channel)
+
+    raise ArgumentError.new("Invalid channel: '#{channel}'. Allowed channel is #{CHANNELS}")
+  end
+
+  # @rbs return: Symbol -- Current platform
+  def self.current_platform
+    if Puppeteer.env.windows?
+      :windows
+    elsif Puppeteer.env.darwin?
+      :darwin
+    else
+      :linux
+    end
+  end
+  private_class_method :current_platform
+
+  # @rbs platform: Symbol -- Target platform
+  # @rbs parts: String -- Path segments
+  # @rbs return: String -- Joined path
+  def self.join_path(platform, *parts)
+    if platform == :windows
+      parts.map(&:to_s).reject(&:empty?).join('\\')
+    else
+      File.join(*parts)
+    end
+  end
+  private_class_method :join_path
+end

data/lib/puppeteer/debug_print.rb

@@ -1,20 +1,16 @@
 require 'logger'
 
 module Puppeteer::DebugPrint
-  if Puppeteer.env.debug?
-    def debug_puts(*args, **kwargs)
-      @__debug_logger ||= Logger.new($stdout)
-      @__debug_logger.debug(*args, **kwargs)
-    end
+  def debug_puts(*args, **kwargs)
+    return unless Puppeteer.env.debug?
 
-    def debug_print(*args)
-      print(*args)
-    end
-  else
-    def debug_puts(*args, **kwargs)
-    end
+    @__debug_logger ||= Logger.new($stdout)
+    @__debug_logger.debug(*args, **kwargs)
+  end
+
+  def debug_print(*args)
+    return unless Puppeteer.env.debug?
 
-    def debug_print(*args)
-    end
+    print(*args)
   end
 end

data/lib/puppeteer/element_handle.rb

@@ -540,6 +540,22 @@ class Puppeteer::ElementHandle < Puppeteer::JSHandle
     end
   end
 
+  # @rbs credit_card: Hash[Symbol | String, untyped]? -- Credit card autofill payload
+  # @rbs address: Hash[Symbol | String, untyped]? -- Address autofill payload
+  # @rbs return: void -- No return value
+  def autofill(credit_card: nil, address: nil)
+    node_info = @remote_object.node_info(@client)
+    field_id = node_info.dig('node', 'backendNodeId')
+    @client.send_message('Autofill.trigger', {
+      fieldId: field_id,
+      frameId: @frame.id,
+      card: credit_card,
+      address: address,
+    }.compact)
+  end
+
+  define_async_method :async_autofill
+
   # @rbs block: Proc? -- Optional block for Object#tap usage
   # @rbs return: Puppeteer::ElementHandle | nil -- Element handle or nil
   def tap(&block)

data/lib/puppeteer/events.rb

@@ -135,6 +135,9 @@ module PageEmittedEvents ; end
   # Emitted when a frame is navigated to a new URL. Will contain a {@link Frame}.
   FrameNavigated: 'framenavigated',
 
+  # Emitted when a DevTools issue is reported.
+  Issue: 'issue',
+
   # Emitted when the JavaScript
   # {https://developer.mozilla.org/en-US/docs/Web/Events/load | load} event is dispatched.
   Load: 'load',

data/lib/puppeteer/execution_context.rb

@@ -52,13 +52,18 @@ class Puppeteer::ExecutionContext
     # @param context_id [String]
     # @return [Object|JSHandle]
     def evaluate_with(client:, context_id:)
-      result = client.send_message('Runtime.evaluate',
-        expression: expression_with_source_url,
-        contextId: context_id,
-        returnByValue: @return_by_value,
-        awaitPromise: true,
-        userGesture: true,
-      )
+      result =
+        begin
+          client.send_message('Runtime.evaluate',
+            expression: expression_with_source_url,
+            contextId: context_id,
+            returnByValue: @return_by_value,
+            awaitPromise: true,
+            userGesture: true,
+          )
+        rescue Puppeteer::Connection::ProtocolError => err
+          raise @execution_context.send(:rewrite_evaluation_error, err)
+        end
       # }).catch(rewriteError);
 
       exception_details = result['exceptionDetails']
@@ -110,14 +115,19 @@ class Puppeteer::ExecutionContext
       # Original puppeteer implementation take it into consideration.
       # But we don't support the syntax here.
 
-      result = client.send_message('Runtime.callFunctionOn',
-        functionDeclaration: function_declaration,
-        executionContextId: context_id,
-        arguments: converted_args,
-        returnByValue: @return_by_value,
-        awaitPromise: true,
-        userGesture: true,
-      ) # .catch(rewriteError);
+      result =
+        begin
+          client.send_message('Runtime.callFunctionOn',
+            functionDeclaration: function_declaration,
+            executionContextId: context_id,
+            arguments: converted_args,
+            returnByValue: @return_by_value,
+            awaitPromise: true,
+            userGesture: true,
+          )
+        rescue Puppeteer::Connection::ProtocolError => err
+          raise @execution_context.send(:rewrite_evaluation_error, err)
+        end # .catch(rewriteError);
 
       exception_details = result['exceptionDetails']
       if exception_details
@@ -337,6 +347,18 @@ class Puppeteer::ExecutionContext
     )
   end
 
+  # @param error [Puppeteer::Connection::ProtocolError]
+  # @return [StandardError]
+  private def rewrite_evaluation_error(error)
+    message = error.message
+    if message.end_with?('Cannot find context with specified id') ||
+       message.end_with?('Inspected target navigated or closed')
+      return Puppeteer::Error.new('Execution context was destroyed, most likely because of a navigation.')
+    end
+
+    error
+  end
+
   # @rbs page_function: String -- JavaScript code to check
   # @rbs return: bool -- Whether the code represents a function
   private def function_string?(page_function)