ferrum 0.17 → 0.17.2

data/lib/ferrum/browser/options/base.rb

@@ -26,11 +26,11 @@ module Ferrum
         end
 
         def except(*keys)
-          to_h.reject { |n, _| keys.include?(n) }
+          to_h.except(*keys)
         end
 
         def detect_path
-          Binary.find(self.class::PLATFORM_PATH[Utils::Platform.name])
+          Binary.find(self.class::PLATFORM_PATH[Utils::Platform.platform_name])
         end
 
         def merge_required(flags, options, user_data_dir)

data/lib/ferrum/browser/options/chrome.rb

@@ -5,44 +5,63 @@ module Ferrum
     class Options
       class Chrome < Base
         DEFAULT_OPTIONS = {
-          "headless" => nil,
-          "hide-scrollbars" => nil,
-          "mute-audio" => nil,
-          "enable-automation" => nil,
-          "disable-web-security" => nil,
-          "disable-session-crashed-bubble" => nil,
-          "disable-breakpad" => nil,
-          "disable-sync" => nil,
-          "no-first-run" => nil,
-          "use-mock-keychain" => nil,
-          "keep-alive-for-test" => nil,
-          "disable-popup-blocking" => nil,
-          "disable-extensions" => nil,
-          "disable-component-extensions-with-background-pages" => nil,
-          "disable-hang-monitor" => nil,
-          "disable-features" => "site-per-process,IsolateOrigins,TranslateUI",
-          "disable-translate" => nil,
+          "allow-pre-commit-input" => nil,
           "disable-background-networking" => nil,
-          "enable-features" => "NetworkService,NetworkServiceInProcess",
           "disable-background-timer-throttling" => nil,
           "disable-backgrounding-occluded-windows" => nil,
+          "disable-blink-features" => "AutomationControlled",
+          "disable-breakpad" => nil,
           "disable-client-side-phishing-detection" => nil,
+          "disable-component-extensions-with-background-pages" => nil,
+          "disable-component-update" => nil,
+          "disable-crash-reporter" => nil,
           "disable-default-apps" => nil,
           "disable-dev-shm-usage" => nil,
+          "disable-extensions" => nil,
+          "disable-features" => %w[
+            site-per-process
+            IsolateOrigins
+            TranslateUI
+            Translate
+            MacAppCodeSignClone
+            InterestFeedContentSuggestion
+            OptimizationHints
+            AcceptCHFrame
+            MediaRouter
+          ].join(","),
+          "disable-field-trial-config" => nil,
+          "disable-hang-monitor" => nil,
+          "disable-infobars" => nil,
           "disable-ipc-flooding-protection" => nil,
+          "disable-popup-blocking" => nil,
           "disable-prompt-on-repost" => nil,
           "disable-renderer-backgrounding" => nil,
+          "disable-search-engine-choice-screen" => nil,
+          "disable-session-crashed-bubble" => nil,
           "disable-site-isolation-trials" => nil,
+          "disable-smooth-scrolling" => nil,
+          "disable-sync" => nil,
+          "disable-translate" => nil,
+          "disable-web-security" => nil,
+          "enable-automation" => nil,
+          "enable-features" => %w[
+            NetworkService
+            NetworkServiceInProcess
+          ].join(","),
           "force-color-profile" => "srgb",
+          "headless" => nil,
+          "hide-scrollbars" => nil,
+          "keep-alive-for-test" => nil,
           "metrics-recording-only" => nil,
-          "safebrowsing-disable-auto-update" => nil,
-          "password-store" => "basic",
+          "mute-audio" => nil,
+          "no-crash-upload" => nil,
+          "no-default-browser-check" => nil,
+          "no-first-run" => nil,
           "no-startup-window" => nil,
+          "password-store" => "basic",
           "remote-allow-origins" => "*",
-          "disable-blink-features" => "AutomationControlled"
-          # NOTE: --no-sandbox is not needed if you properly set up a user in the container.
-          # https://github.com/ebidel/lighthouse-ci/blob/master/builder/Dockerfile#L35-L40
-          # "no-sandbox" => nil,
+          "safebrowsing-disable-auto-update" => nil,
+          "use-mock-keychain" => nil
         }.freeze
 
         MAC_BIN_PATH = [
@@ -76,15 +95,23 @@ module Ferrum
         end
 
         def merge_default(flags, options)
-          defaults = except("headless", "disable-gpu") if options.headless == false
-          defaults ||= DEFAULT_OPTIONS
+          defaults = options.headless == false ? except("headless", "disable-gpu") : DEFAULT_OPTIONS
           defaults.delete("no-startup-window") if options.incognito == false
+
+          if options.dockerize || ENV["FERRUM_CHROME_DOCKERIZE"] == "true"
+            # NOTE: --no-sandbox is not needed if you properly set up a user in the container.
+            # https://github.com/ebidel/lighthouse-ci/blob/master/builder/Dockerfile#L35-L40
+            defaults = defaults.merge("no-sandbox" => nil, "disable-setuid-sandbox" => nil)
+          end
+
           # On Windows, the --disable-gpu flag is a temporary workaround for a few bugs.
           # See https://bugs.chromium.org/p/chromium/issues/detail?id=737678 for more information.
           defaults = defaults.merge("disable-gpu" => nil) if Utils::Platform.windows?
+
           # Use Metal on Apple Silicon
           # https://github.com/google/angle#platform-support-via-backing-renderers
           defaults = defaults.merge("use-angle" => "metal") if Utils::Platform.mac_arm?
+
           defaults.merge(flags)
         end
       end

data/lib/ferrum/browser/options.rb

@@ -14,7 +14,7 @@ module Ferrum
       attr_reader :window_size, :logger, :ws_max_receive_size,
                   :js_errors, :base_url, :slowmo, :pending_connection_errors,
                   :url, :ws_url, :env, :process_timeout, :browser_name, :browser_path,
-                  :save_path, :proxy, :port, :host, :headless, :incognito, :browser_options,
+                  :save_path, :proxy, :port, :host, :headless, :incognito, :dockerize, :browser_options,
                   :ignore_default_browser_options, :xvfb, :flatten
       attr_accessor :timeout, :default_user_agent
 
@@ -28,6 +28,7 @@ module Ferrum
         @js_errors = @options.fetch(:js_errors, false)
         @headless = @options.fetch(:headless, true)
         @incognito = @options.fetch(:incognito, true)
+        @dockerize = @options.fetch(:dockerize, false)
         @flatten = @options.fetch(:flatten, true)
         @pending_connection_errors = @options.fetch(:pending_connection_errors, true)
         @process_timeout = @options.fetch(:process_timeout, PROCESS_TIMEOUT)

data/lib/ferrum/browser/process.rb

@@ -18,11 +18,8 @@ module Ferrum
       KILL_TIMEOUT = 2
       WAIT_KILLED = 0.05
 
-      attr_reader :host, :port, :ws_url, :pid, :command,
-                  :default_user_agent, :browser_version, :protocol_version,
-                  :v8_version, :webkit_version, :xvfb
-
       extend Forwardable
+
       delegate path: :command
 
       def self.start(*args)
@@ -61,6 +58,10 @@ module Ferrum
         }
       end
 
+      attr_reader :host, :port, :ws_url, :pid, :command,
+                  :default_user_agent, :browser_version, :protocol_version,
+                  :v8_version, :webkit_version, :xvfb
+
       def initialize(options)
         @pid = @xvfb = @user_data_dir = nil
 

data/lib/ferrum/browser.rb

@@ -15,6 +15,7 @@ require "ferrum/browser/version_info"
 module Ferrum
   class Browser
     extend Forwardable
+
     delegate %i[default_context] => :contexts
     delegate %i[targets create_target page pages windows] => :default_context
     delegate %i[go_to goto go back forward refresh reload stop wait_for_reload
@@ -48,6 +49,9 @@ module Ferrum
     # @option options [Boolean] :incognito (true)
     #   Create an incognito profile for the browser startup window.
     #
+    # @option options [Boolean] :dockerize (false)
+    #   Add CLI flags to a browser to run in a container.
+    #
     # @option options [Boolean] :xvfb (false)
     #   Run browser in a virtual framebuffer.
     #
@@ -77,7 +81,7 @@ module Ferrum
     # @option options [Boolean] :js_errors
     #   When true, JavaScript errors get re-raised in Ruby.
     #
-    # @option options [Boolean] :pending_connection_errors (true)
+    # @option options [Boolean] :pending_connection_errors (false)
     #   When main frame is still waiting for slow responses while timeout is
     #   reached {PendingConnectionsError} is raised. It's better to figure out
     #   why you have slow responses and fix or block them rather than turn this
@@ -295,6 +299,8 @@ module Ferrum
     end
 
     def build_remote_debug_url(path:)
+      return path if Addressable::URI.parse(path).absolute?
+
       "http://#{process.host}:#{process.port}#{path}"
     end
   end

data/lib/ferrum/client/web_socket.rb

@@ -19,7 +19,7 @@ module Ferrum
         uri     = URI.parse(@url)
         port    = uri.port || DEFAULT_PORTS[uri.scheme]
 
-        if port == 443
+        if port == 443 || url.scheme == "wss"
           tcp = TCPSocket.new(uri.host, port)
           ssl_context = OpenSSL::SSL::SSLContext.new
           @sock = OpenSSL::SSL::SSLSocket.new(tcp, ssl_context)

data/lib/ferrum/client.rb

@@ -24,8 +24,8 @@ module Ferrum
       @client.send_message(message, async: async)
     end
 
-    def on(event, &block)
-      @client.on(event_name(event), &block)
+    def on(event, &)
+      @client.on(event_name(event), &)
     end
 
     def off(event, id)
@@ -40,8 +40,8 @@ module Ferrum
       @client.respond_to?(name, include_private)
     end
 
-    def method_missing(name, *args, **opts, &block)
-      @client.send(name, *args, **opts, &block)
+    def method_missing(name, ...)
+      @client.send(name, ...)
     end
 
     def close
@@ -61,6 +61,7 @@ module Ferrum
 
   class Client
     extend Forwardable
+
     delegate %i[timeout timeout=] => :options
 
     attr_reader :ws_url, :options, :subscriber
@@ -101,8 +102,8 @@ module Ferrum
       end
     end
 
-    def on(event, &block)
-      @subscriber.on(event, &block)
+    def on(event, &)
+      @subscriber.on(event, &)
     end
 
     def off(event, id)

data/lib/ferrum/context.rb

@@ -61,6 +61,8 @@ module Ferrum
       new_target = Target.new(@client, session_id, params)
       # `put_if_absent` returns nil if added a new value or existing if there was one already
       target = @targets.put_if_absent(new_target.id, new_target) || new_target
+      # on first iteration session_id may be nil, then if session is present here we must set it to the target
+      target.session_id = session_id if session_id && target.session_id.nil?
       @default_target ||= target
 
       new_pending = Concurrent::IVar.new

data/lib/ferrum/contexts.rb

@@ -22,10 +22,10 @@ module Ferrum
       @default_context ||= create
     end
 
-    def each(&block)
+    def each(&)
       return enum_for(__method__) unless block_given?
 
-      @contexts.each(&block)
+      @contexts.each(&)
     end
 
     def [](id)
@@ -48,6 +48,8 @@ module Ferrum
 
     def dispose(context_id)
       context = @contexts[context_id]
+      return unless context
+
       context.close_targets_connection
       @client.command("Target.disposeBrowserContext", browserContextId: context.id)
       @contexts.delete(context_id)
@@ -59,8 +61,9 @@ module Ferrum
     end
 
     def reset
-      @default_context = nil
-      @contexts.each_key { |id| dispose(id) }
+      context_ids = @client.command("Target.getBrowserContexts")["browserContextIds"]
+      @default_context = nil if context_ids.include?(@default_context&.id)
+      @contexts.each_key { |id| dispose(id) if context_ids.include?(id) }
     end
 
     def size
@@ -69,18 +72,13 @@ module Ferrum
 
     private
 
-    # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
-    def subscribe
+    def subscribe # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
       @client.on("Target.attachedToTarget") do |params|
         info, session_id = params.values_at("targetInfo", "sessionId")
         next unless ALLOWED_TARGET_TYPES.include?(info["type"])
 
         context_id = info["browserContextId"]
-        unless @contexts[context_id]
-          context = Context.new(@client, self, context_id)
-          @contexts[context_id] = context
-          @default_context ||= context
-        end
+        add_context(context_id)
 
         @contexts[context_id]&.add_target(session_id: session_id, params: info)
         if params["waitingForDebugger"]
@@ -93,9 +91,10 @@ module Ferrum
         next unless ALLOWED_TARGET_TYPES.include?(info["type"])
 
         context_id = info["browserContextId"]
+        add_context(context_id)
 
         if info["type"] == "iframe" &&
-           (target = @contexts[context_id].find_target { |t| t.connected? && t.page.frame_by(id: info["targetId"]) })
+           (target = @contexts[context_id]&.find_target { |t| t.connected? && t.page.frame_by(id: info["targetId"]) })
           @contexts[context_id]&.add_target(session_id: target.page.client.session_id, params: info)
         else
           @contexts[context_id]&.add_target(params: info)
@@ -120,16 +119,21 @@ module Ferrum
         context&.delete_target(params["targetId"])
       end
     end
-    # rubocop:enable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
 
     def discover
       @client.command("Target.setDiscoverTargets", discover: true)
     end
 
     def auto_attach
-      return unless @client.options.flatten
-
       @client.command("Target.setAutoAttach", autoAttach: true, waitForDebuggerOnStart: true, flatten: true)
     end
+
+    def add_context(context_id)
+      return if @contexts[context_id]
+
+      context = Context.new(@client, self, context_id)
+      @contexts[context_id] = context
+      @default_context ||= context # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
   end
 end

data/lib/ferrum/cookies/cookie.rb

@@ -161,7 +161,7 @@ module Ferrum
       #   The raw cookie string.
       #
       def to_s
-        string = String.new("#{@attributes['name']}=#{@attributes['value']}")
+        string = "#{@attributes['name']}=#{@attributes['value']}"
 
         @attributes.each do |key, value|
           case key

data/lib/ferrum/errors.rb

@@ -113,9 +113,10 @@ module Ferrum
   class JavaScriptError < BrowserError
     attr_reader :class_name, :message, :stack_trace
 
-    def initialize(response, stack_trace = nil)
-      @class_name, @message = response.values_at("className", "description")
-      @stack_trace = stack_trace
+    def initialize(response)
+      @class_name, @message = response["exception"]&.values_at("className", "description")
+      @message ||= response["text"]
+      @stack_trace = response["stackTrace"]
       super(response.merge("message" => @message))
     end
   end

data/lib/ferrum/frame/runtime.rb

@@ -135,7 +135,7 @@ module Ferrum
         when /\AError: timed out promise/
           raise ScriptTimeoutError
         else
-          raise JavaScriptError.new(result, response.dig("exceptionDetails", "stackTrace"))
+          raise JavaScriptError, response["exceptionDetails"]
         end
       end
 

data/lib/ferrum/network/response.rb

@@ -124,7 +124,9 @@ module Ferrum
       #
       # @return [String]
       #
-      def body
+      # @raise [Ferrum::BrowserError]
+      #
+      def body!
         @body ||= begin
           body, encoded = @page.command("Network.getResponseBody", requestId: id)
                                .values_at("body", "base64Encoded")
@@ -132,6 +134,17 @@ module Ferrum
         end
       end
 
+      #
+      # The response body.
+      #
+      # @return [String, nil]
+      #
+      def body
+        body!
+      rescue Ferrum::BrowserError
+        # nop
+      end
+
       #
       # @return [Boolean]
       #

data/lib/ferrum/network.rb

@@ -17,7 +17,7 @@ module Ferrum
                         SignedExchange Ping CSPViolationReport Preflight Other].freeze
     AUTHORIZE_BLOCK_MISSING = "Block is missing, call `authorize(...) { |r| r.continue } " \
                               "or subscribe to `on(:request)` events before calling it"
-    AUTHORIZE_TYPE_WRONG = ":type should be in #{AUTHORIZE_TYPE}"
+    AUTHORIZE_TYPE_WRONG = ":type should be in #{AUTHORIZE_TYPE}".freeze
     ALLOWED_CONNECTION_TYPE = %w[none cellular2g cellular3g cellular4g bluetooth ethernet wifi wimax other].freeze
 
     # Network traffic.

data/lib/ferrum/page/animation.rb

@@ -6,7 +6,7 @@ module Ferrum
       #
       # Returns playback rate for CSS animations, defaults to `1`.
       #
-      # @return [Integer]
+      # @return [Number]
       #
       def playback_rate
         command("Animation.getPlaybackRate")["playbackRate"]
@@ -15,7 +15,7 @@ module Ferrum
       #
       # Sets playback rate of CSS animations.
       #
-      # @param [Integer] value
+      # @param [Number] value
       #
       # @example
       #   browser = Ferrum::Browser.new

data/lib/ferrum/page/screenshot.rb

@@ -266,11 +266,11 @@ module Ferrum
       def bounding_rect(selector)
         rect = evaluate_async(%(
           const rect = document
-                         .querySelector('#{selector}')
+                         .querySelector(arguments[0])
                          .getBoundingClientRect();
           const {x, y, width, height} = rect;
-          arguments[0]([x, y, width, height])
-        ), timeout)
+          arguments[1]([x, y, width, height])
+        ), timeout, selector)
 
         { x: rect[0], y: rect[1], width: rect[2], height: rect[3] }
       end

data/lib/ferrum/page.rb

@@ -21,6 +21,7 @@ module Ferrum
     GOTO_WAIT = ENV.fetch("FERRUM_GOTO_WAIT", 0.1).to_f
 
     extend Forwardable
+
     delegate %i[at_css at_xpath css xpath
                 current_url current_title url title body doctype content=
                 execution_id execution_id! evaluate evaluate_on evaluate_async execute evaluate_func
@@ -442,10 +443,7 @@ module Ferrum
       if @options.js_errors
         on("Runtime.exceptionThrown") do |params|
           # FIXME: https://jvns.ca/blog/2015/11/27/why-rubys-timeout-is-dangerous-and-thread-dot-raise-is-terrifying/
-          Thread.main.raise JavaScriptError.new(
-            params.dig("exceptionDetails", "exception"),
-            params.dig("exceptionDetails", "stackTrace")
-          )
+          Thread.main.raise JavaScriptError, params["exceptionDetails"]
         end
       end
 

data/lib/ferrum/utils/platform.rb

@@ -5,7 +5,7 @@ module Ferrum
     module Platform
       module_function
 
-      def name
+      def platform_name
         return :mac if mac?
         return :windows if windows?
 

data/lib/ferrum/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ferrum
-  VERSION = "0.17"
+  VERSION = "0.17.2"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ferrum
 version: !ruby/object:Gem::Version
-  version: '0.17'
+  version: 0.17.2
 platform: ruby
 authors:
 - Dmitry Vorotilin
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -152,7 +151,6 @@ metadata:
   changelog_uri: https://github.com/rubycdp/ferrum/blob/main/CHANGELOG.md
   source_code_uri: https://github.com/rubycdp/ferrum
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -160,15 +158,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Ruby headless Chrome driver
 test_files: []