cuprite 0.18 → 0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed2641aa002e810fd4dfedc8b3128f38e5f2df0f747d59bc1cf7a81aa1295076
-  data.tar.gz: 7e967cb1a6a11ad9f446290cd5035d2d5d3e9c6724ba6f4df4c31e761b29545d
+  metadata.gz: 7fa19bf03d8a264421374bf813afb0f6c062e15e8aa92ca7c046d3a659122319
+  data.tar.gz: d12031c15dda9ad7e777f7b66a887c6979af5b4c3e27010083378af512f979d1
 SHA512:
-  metadata.gz: dcee409e8ee24caf139c3a0c29318ccea5ddefb0759f228f0f24db76aef28864c73d46e02ecc820160e82d6f366c61648ad1dc20dd930b5d9f300c8853d17003
-  data.tar.gz: 5168b1c18e81936795a02154829100dc3a616c2d2c3db71c134c8e64f5f13d93fd1098e8c26aea8d84a26840bf547a80b263b63b293420dc9f18cc18a5d29632
+  metadata.gz: c85ee6afd497cfdc03375c111cc58dbcd6463f41c63bd745a6229a31a4d4e6bb6dc03fb8eddc0f8a7f93079c2cdf81524a3febca3494031e002eb869e9943188
+  data.tar.gz: 0d066fa1a7fb851a9ce0d3d9a9e4891a6c76bd3c7e558a74fa021035b8e2316d860fce4674f3054134fe03dc05c7c622124d8b88ded27d81bfeede3d75e28e7f

data/README.md

@@ -1,5 +1,12 @@
 # Cuprite - Headless Chrome driver for Capybara
 
+## [Documentation](https://docs.rubycdp.com/docs/cuprite/introduction)
+
+<img align="right"
+     width="160" height="160"
+     alt="Cuprite logo"
+     src="https://raw.githubusercontent.com/rubycdp/cuprite/main/logo.svg?sanitize=true">
+
 Cuprite is a pure Ruby driver (read as _no_ Selenium/WebDriver/ChromeDriver
 dependency) for [Capybara](https://github.com/teamcapybara/capybara). It allows
 you to run Capybara tests on a headless Chrome or Chromium. Under the hood it
@@ -7,6 +14,8 @@ uses [Ferrum](https://github.com/rubycdp/ferrum#index) which is high-level API
 to the browser by CDP protocol.
 
 
+<br clear="right">
+
 ## Install
 
 Add this to your `Gemfile` and run `bundle install`.
@@ -84,7 +93,18 @@ end
     timer) only surfaces on whatever command runs next.
   * `:url_blacklist` (Array) - array of regexes to match against requested URLs
   * `:url_whitelist` (Array) - array of regexes to match against requested URLs
+  * `:emulate` (Symbol) - device from Chrome DevTools' list to emulate, e.g. `:iphone_16`, `:pixel_9`, `:ipad_mini`
+  * `:mobile` (Boolean) - emulate a mobile device: viewport meta tag and touch events
+  * `:scale_factor` (Numeric) - device scale factor to emulate
 
+`emulate:` sets the device's `:window_size`, `:scale_factor`, `:mobile` and user agent, options passed explicitly
+take precedence:
+
+```ruby
+Capybara.register_driver(:cuprite) do |app|
+  Capybara::Cuprite::Driver.new(app, emulate: :iphone_14)
+end
+```
 
 ## Debugging
 
@@ -198,7 +218,17 @@ Besides capybara screenshot method you can get image as Base64:
 
 ## Proxy
 
-* `page.driver.set_proxy(ip, port, user, password)`
+* `page.driver.set_proxy(ip, port, user, password, bypass)`
+
+The proxy is passed to Chrome as a command-line flag, so it has to be set before the browser starts: either with the
+`:proxy` driver option or by calling `set_proxy` before the browser is first used. Calling it once the browser is
+running has no effect.
+
+When connecting to a remote browser with the `:url` option (browserless, Selenoid, etc.), Cuprite doesn't launch
+Chrome and the proxy flag is never applied, so configure the proxy on the remote browser itself. The `user` and
+`password` are still used to answer the proxy's authentication challenge.
+
+The `bypass` argument is a list of hosts that skip the proxy, so don't pass the host you want to go through it.
 
 
 ## URL Blocklisting & Allowlisting

data/lib/capybara/cuprite/browser.rb

@@ -14,6 +14,8 @@ module Capybara
                   dismiss_prompt reset_modals] => :page
 
       def initialize(options = nil)
+        device = options&.dig(:emulate)
+        options = Devices.fetch(device).except(:user_agent).merge(options) if device
         super
 
         @options.raise_on_unhandled_modal = options&.dig(:raise_on_unhandled_modal)
@@ -38,6 +40,7 @@ module Capybara
 
       def reset
         super
+      ensure
         @options.reset_window_size
         @page = nil
       end
@@ -109,7 +112,7 @@ module Capybara
       end
 
       def window_handles
-        targets.keys
+        targets.values.select(&:page?).map(&:id)
       end
 
       def within_window(locator = nil)
@@ -123,17 +126,13 @@ module Capybara
       end
 
       def switch_to_window(target_id)
-        target = targets[target_id]
-        raise Ferrum::NoSuchPageError unless target
-
+        target = window_target(target_id)
         @page = attach_page(target.id)
         @page.activate
       end
 
       def close_window(target_id)
-        target = targets[target_id]
-        raise Ferrum::NoSuchPageError unless target
-
+        target = window_target(target_id)
         @page = ClosedPage.new if @page.target_id == target.id
         target.page.close
         targets.delete(target_id) # page.close is async, delete target asap
@@ -156,6 +155,7 @@ module Capybara
         delay = options[:delay]
         scroll = options.fetch(:scroll, true)
         html5 = options[:html5]
+        drop_offset = options[:drop_offset]
 
         execute("_cuprite.dragMousedownTracker()")
 
@@ -169,21 +169,21 @@ module Capybara
         html5 = !evaluate_on(node: node, expression: "_cuprite.legacyDragCheck(this)") if html5.nil?
 
         if html5
-          drag_html5(node, other, drop_modifiers, delay)
+          drag_html5(node, other, drop_modifiers, delay, drop_offset)
         else
           modifiers = keyboard.modifiers(drop_modifiers)
 
           other.scroll_into_view if scroll
-          x2, y2 = other.find_position
+          x2, y2 = other.find_position(**drop_offset.to_h)
           mouse.move(x: x2, y: y2, steps: steps)
 
           mouse.up(modifiers: modifiers)
         end
       end
 
-      def drag_html5(node, other, drop_modifiers, delay)
+      def drag_html5(node, other, drop_modifiers, delay, drop_offset = nil)
         keys = drop_modifiers.map(&:to_s)
-        evaluate_async(DRAG_HTML5_JS, timeout, node, other, (delay || 0.05) * 1000, keys)
+        evaluate_async(DRAG_HTML5_JS, timeout, node, other, (delay || 0.05) * 1000, keys, drop_offset)
         mouse.up
       end
 
@@ -266,6 +266,10 @@ module Capybara
       private
 
       def find_all(method, selector, within = nil)
+        # Capybara appends its text-match hint as `(expr)[...]`, but with `exact_text: true` the hint
+        # is empty and the result `(expr)[]` is invalid XPath. An empty predicate is never valid, so
+        # dropping it can't change a valid selector. Remove once teamcapybara/capybara#2860 is released.
+        selector = selector.delete_suffix("[]") if method == :xpath
         nodes = if within
                   evaluate("_cuprite.find(arguments[0], arguments[1], arguments[2])", method, selector, within)
                 else
@@ -297,6 +301,13 @@ module Capybara
         end
       end
 
+      def window_target(target_id)
+        target = targets[target_id]
+        raise Ferrum::NoSuchPageError unless target&.page?
+
+        target
+      end
+
       def attach_page(target_id = nil)
         target = targets[target_id] if target_id
         target ||= default_context.default_target

data/lib/capybara/cuprite/devices.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+module Capybara
+  module Cuprite
+    module Devices
+      IPHONE_USER_AGENT = "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1"
+      SAMSUNG_GALAXY_S8_PLUS_USER_AGENT = "Mozilla/5.0 (Linux; Android 8.0.0; SM-G955U Build/R16NW) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+      WINDOWS_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Safari/537.36"
+
+      LIST = {
+        iphone_se: {
+          window_size: [375, 667], scale_factor: 2, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_xr: {
+          window_size: [414, 896], scale_factor: 2, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_12_pro: {
+          window_size: [390, 844], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_14: {
+          window_size: [390, 844], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_14_plus: {
+          window_size: [428, 926], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_14_pro: {
+          window_size: [393, 852], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_14_pro_max: {
+          window_size: [430, 932], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_15: {
+          window_size: [393, 852], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_15_plus: {
+          window_size: [430, 932], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_15_pro: {
+          window_size: [393, 852], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_15_pro_max: {
+          window_size: [430, 932], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_16e: {
+          window_size: [390, 844], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_16: {
+          window_size: [393, 852], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_16_plus: {
+          window_size: [430, 932], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_16_pro: {
+          window_size: [402, 874], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        iphone_16_pro_max: {
+          window_size: [440, 956], scale_factor: 3, mobile: true,
+          user_agent: IPHONE_USER_AGENT
+        },
+        ipad_mini: {
+          window_size: [768, 1024], scale_factor: 2, mobile: true,
+          user_agent: "Mozilla/5.0 (iPad; CPU OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1"
+        },
+        ipad_pro_13: {
+          window_size: [1032, 1376], scale_factor: 2, mobile: true,
+          user_agent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Safari/605.1.15"
+        },
+
+        pixel_7: {
+          window_size: [412, 915], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 13; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_8: {
+          window_size: [412, 915], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_8_pro: {
+          window_size: [448, 997], scale_factor: 3, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; Pixel 8 Pro) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_8a: {
+          window_size: [412, 915], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; Pixel 8a) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_9: {
+          window_size: [412, 924], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; Pixel 9) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_9_pro: {
+          window_size: [427, 952], scale_factor: 3, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; Pixel 9 Pro) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_9_pro_xl: {
+          window_size: [448, 997], scale_factor: 3, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; Pixel 9 Pro XL) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_10: {
+          window_size: [412, 924], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 16; Pixel 10) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        pixel_9_pro_fold: {
+          window_size: [412, 922], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; Pixel 9 Pro Fold) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+
+        samsung_galaxy_s8_plus: {
+          window_size: [360, 740], scale_factor: 4, mobile: true,
+          user_agent: SAMSUNG_GALAXY_S8_PLUS_USER_AGENT
+        },
+        samsung_galaxy_s20_ultra: {
+          window_size: [412, 915], scale_factor: 3.5, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 13; SM-G981B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        samsung_galaxy_a55: {
+          window_size: [360, 800], scale_factor: 2.25, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; SM-A556B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        galaxy_z_fold_6: {
+          window_size: [412, 968], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 14; SM-F956U) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        galaxy_z_fold_5: {
+          window_size: [344, 882], scale_factor: 2.625, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        samsung_galaxy_a51_71: {
+          window_size: [412, 914], scale_factor: 2.625, mobile: true,
+          user_agent: SAMSUNG_GALAXY_S8_PLUS_USER_AGENT
+        },
+        galaxy_tab_s4: {
+          window_size: [712, 1138], scale_factor: 2.25, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 8.1.0; SM-T837A) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Safari/537.36"
+        },
+
+        surface_pro_7: {
+          window_size: [912, 1368], scale_factor: 2, mobile: true,
+          user_agent: WINDOWS_USER_AGENT
+        },
+        surface_pro_10: {
+          window_size: [960, 1440], scale_factor: 2, mobile: true,
+          user_agent: WINDOWS_USER_AGENT
+        },
+        surface_duo: {
+          window_size: [540, 720], scale_factor: 2.5, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 11.0; Surface Duo) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+
+        nest_hub_max: {
+          window_size: [1280, 800], scale_factor: 2, mobile: true,
+          user_agent: "Mozilla/5.0 (X11; Linux aarch64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Safari/537.36 CrKey/1.54.250320"
+        },
+        jiophone_2: {
+          window_size: [240, 320], scale_factor: 1, mobile: true,
+          user_agent: "Mozilla/5.0 (Mobile; LYF/F300B/LYF-F300B-001-01-15-130718-i;Android; rv:48.0) Gecko/48.0 Firefox/48.0 KAIOS/2.5"
+        },
+        moto_g4: {
+          window_size: [360, 640], scale_factor: 3, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 6.0.1; Moto G (4)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        },
+        moto_g_power: {
+          window_size: [412, 823], scale_factor: 1.75, mobile: true,
+          user_agent: "Mozilla/5.0 (Linux; Android 11; moto g power (2022)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%<version>s Mobile Safari/537.36"
+        }
+      }.freeze
+
+      def self.fetch(name)
+        LIST.fetch(name.to_sym) do
+          raise ArgumentError, "Unknown device to emulate: #{name.inspect}, use one of #{LIST.keys.join(', ')}"
+        end
+      end
+    end
+  end
+end

data/lib/capybara/cuprite/driver.rb

@@ -42,6 +42,7 @@ module Capybara
         unless @options[:browser_options][:"remote-allow-origins"]
           @options[:browser_options].merge!("remote-allow-origins": "*")
         end
+        @options[:browser_options] = { "disable-web-security": nil }.merge(@options[:browser_options])
 
         super()
       end
@@ -139,6 +140,7 @@ module Capybara
         browser.url_whitelist = @options[:url_whitelist]
         browser.raise_on_unhandled_modal = @options.fetch(:raise_on_unhandled_modal, false)
         browser.reset
+      ensure
         @started = false
       end
 

data/lib/capybara/cuprite/javascripts/drag.js

@@ -1,11 +1,9 @@
 // HTML5 drag-and-drop emulation.
 //
-// Ported near-verbatim from Capybara's Selenium driver
-// (capybara/selenium/extensions/html5_drag.rb, HTML5_DRAG_DROP_SCRIPT) so
-// Cuprite matches Capybara's HTML5 drag behaviour and its shared specs. Kept
-// close to the source to ease future syncs; known upstream quirks (rectPt.top
-// in pointOnRect, undeclared `key`, callback.call(true)) are preserved
-// deliberately. See https://github.com/rubycdp/cuprite/issues/314.
+// Ported from Capybara's Selenium driver (capybara/selenium/extensions/html5_drag.rb,
+// HTML5_DRAG_DROP_SCRIPT), see https://github.com/rubycdp/cuprite/issues/314.
+// Unlike the original, a drag ends the way it does in a browser: with `drop` if
+// the target accepted it, otherwise with `dragleave`, never both [#325].
 
 function rectCenter(rect){
   return new DOMPoint(
@@ -31,7 +29,7 @@ function pointOnRect(pt, rect) {
   }
 
   if (pt.y <= rectPt.y) { // top side
-    var minYx = (rectPt.top - pt.y) / slope + pt.x;
+    var minYx = (rect.top - pt.y) / slope + pt.x;
     if (rect.left <= minYx && minYx <= rect.right)
       return new DOMPoint(minYx, rect.top);
   }
@@ -51,7 +49,7 @@ function dragEnterTarget() {
   var sourceCenter = rectCenter(source.getBoundingClientRect());
 
   for (var i = 0; i < drop_modifier_keys.length; i++) {
-    key = drop_modifier_keys[i];
+    var key = drop_modifier_keys[i];
     if (key == "control"){
       key = "ctrl"
     }
@@ -69,23 +67,26 @@ function dragEnterTarget() {
   window.setTimeout(dragOnTarget, step_delay);
 }
 
+function dropPoint(rect) {
+  if (!drop_offset) return rectCenter(rect);
+
+  var origin = drop_offset.position == 'center' ? rectCenter(rect) : new DOMPoint(rect.left, rect.top);
+  return new DOMPoint(origin.x + drop_offset.x, origin.y + drop_offset.y);
+}
+
 function dragOnTarget() {
-  var targetCenter = rectCenter(target.getBoundingClientRect());
-  var dragOverOpts = Object.assign({clientX: targetCenter.x, clientY: targetCenter.y}, opts);
+  var point = dropPoint(target.getBoundingClientRect());
+  var dragOverOpts = Object.assign({clientX: point.x, clientY: point.y}, opts);
   var dragOverEvent = new DragEvent('dragover', dragOverOpts);
   target.dispatchEvent(dragOverEvent);
-  window.setTimeout(dragLeave, step_delay, dragOverEvent.defaultPrevented, dragOverOpts);
+  window.setTimeout(dragEnd, step_delay, dragOverEvent.defaultPrevented, dragOverOpts);
 }
 
-function dragLeave(drop, dragOverOpts) {
-  var dragLeaveOptions = Object.assign({}, opts, dragOverOpts);
-  var dragLeaveEvent = new DragEvent('dragleave', dragLeaveOptions);
-  target.dispatchEvent(dragLeaveEvent);
-  if (drop) {
-    var dropEvent = new DragEvent('drop', dragLeaveOptions);
-    target.dispatchEvent(dropEvent);
-  }
-  var dragEndEvent = new DragEvent('dragend', dragLeaveOptions);
+function dragEnd(drop, dragOverOpts) {
+  var dragEndOptions = Object.assign({}, opts, dragOverOpts);
+  var dropOrLeaveEvent = new DragEvent(drop ? 'drop' : 'dragleave', dragEndOptions);
+  target.dispatchEvent(dropOrLeaveEvent);
+  var dragEndEvent = new DragEvent('dragend', dragEndOptions);
   source.dispatchEvent(dragEndEvent);
   callback.call(true);
 }
@@ -94,7 +95,8 @@ var source = arguments[0],
     target = arguments[1],
     step_delay = arguments[2],
     drop_modifier_keys = arguments[3],
-    callback = arguments[4];
+    drop_offset = arguments[4],
+    callback = arguments[5];
 
 var dt = new DataTransfer();
 var opts = { cancelable: true, bubbles: true, dataTransfer: dt };

data/lib/capybara/cuprite/javascripts/index.js

@@ -77,15 +77,27 @@ class Cuprite {
       }
     }
 
+    let ancestorOpacityApplies = true;
+
     while (node) {
       if (node instanceof ShadowRoot) {
         node = node.host;
       } else {
         style = window.getComputedStyle(node);
-        if (style.display === "none" || style.visibility === "hidden" || parseFloat(style.opacity) === 0) {
+        if (style.display === "none" || style.visibility === "hidden" || (ancestorOpacityApplies && parseFloat(style.opacity) === 0)) {
           return false;
         }
 
+        // A node matching :modal or :popover-open is a top-layer element, so
+        // an ancestor's opacity no longer applies to it once shown.
+        if (ancestorOpacityApplies) {
+          try {
+            if (node.matches(":modal, :popover-open")) {
+              ancestorOpacityApplies = false;
+            }
+          } catch (e) {}
+        }
+
         let parent = node.parentElement;
         if (parent && parent.tagName === "DETAILS" && !parent.open) {
           // In a closed <details> only the first <summary> (and its subtree) is rendered.
@@ -208,6 +220,10 @@ class Cuprite {
 
         this.keyupdowned(node, "keyup", char, keyCode);
       }
+
+      if (valueBefore !== "" && node.value === "") {
+        this.input(node, "deleteContentBackward");
+      }
     }
 
     if (valueBefore !== node.value) {
@@ -226,8 +242,8 @@ class Cuprite {
     return nativeTextareaValueSetter.call(node, value);
   }
 
-  input(node) {
-    let event = new InputEvent("input", { inputType: "insertText", bubbles: true, cancelable: false });
+  input(node, inputType = "insertText") {
+    let event = new InputEvent("input", { inputType: inputType, bubbles: true, cancelable: false });
     node.dispatchEvent(event);
   }
 
@@ -417,13 +433,14 @@ class Cuprite {
     } else if (value == false && !node.parentNode.multiple) {
       return false;
     } else {
-      let parentNode = node.parentNode;
-      this.trigger(parentNode, "focus");
+      let selectNode = node.closest("select");
+      this.trigger(selectNode, "focus");
 
       node.selected = value;
+      selectNode.dispatchEvent(new Event("input", { bubbles: true, composed: true }));
       this.changed(node);
 
-      this.trigger(parentNode, "blur");
+      this.trigger(selectNode, "blur");
       return true;
     }
   }
@@ -467,8 +484,10 @@ class Cuprite {
       event = new FocusEvent(name, { bubbles: true, cancelable: true });
     } else if (EVENTS.FORM.indexOf(name) != -1) {
       event = this.obtainEvent(name);
+    } else if (name == "input") {
+      event = new InputEvent(name, { inputType: "insertText", bubbles: true, composed: true });
     } else {
-      throw "Unknown event";
+      event = new Event(name, { bubbles: true, cancelable: true });
     }
 
     node.dispatchEvent(event);
@@ -523,6 +542,10 @@ class Cuprite {
     window.getSelection().deleteFromDocument();
   }
 
+  hasFocus(node) {
+    return document.activeElement === node;
+  }
+
   containsSelection(node) {
     let selectedNode = document.getSelection().focusNode;
 

data/lib/capybara/cuprite/node.rb

@@ -181,11 +181,14 @@ module Capybara
       end
 
       def drag_to(other, **options)
+        raise ArgumentError, "You must specify both x: and y: for a drop offset" if options[:x].nil? ^ options[:y].nil?
+
         options[:steps] ||= 1
         options[:scroll] = true unless options.key?(:scroll)
+        options[:drop_offset] = drop_offset(*options.values_at(:x, :y, :offset))
         modifiers = Array(options[:drop_modifiers]).map { |m| DRAG_MODIFIER_ALIASES.fetch(m.to_sym, m.to_sym) }
 
-        command(:drag, other.node, modifiers, options.slice(:steps, :delay, :scroll, :html5))
+        command(:drag, other.node, modifiers, options.slice(:steps, :delay, :scroll, :html5, :drop_offset))
       end
 
       def drag_by(x, y, **options)
@@ -282,6 +285,13 @@ module Capybara
         node.click(mode: mode, keys: keys, offset: offset, delay: delay)
       end
 
+      def drop_offset(x, y, position)
+        return unless x
+
+        position ||= driver.session_options.w3c_click_offset ? :center : :top
+        { x: x, y: y, position: position.to_sym }
+      end
+
       def filter_text(text)
         text.gsub(/[\u200b\u200e\u200f]/, "")
             .gsub(/[\ \n\f\t\v\u2028\u2029]+/, " ")

data/lib/capybara/cuprite/options.rb

@@ -6,6 +6,25 @@ module Ferrum
       attr_writer :window_size
       attr_accessor :url_blacklist, :url_whitelist, :raise_on_unhandled_modal
 
+      def mobile
+        @options.fetch(:mobile, false)
+      end
+
+      def scale_factor
+        @options.fetch(:scale_factor, 0)
+      end
+
+      def device_user_agent
+        Capybara::Cuprite::Devices.fetch(@options[:emulate])[:user_agent] if @options[:emulate]
+      end
+
+      def default_user_agent
+        return @default_user_agent unless device_user_agent
+
+        chrome_version = @default_user_agent.to_s[%r{Chrome/(\S+)}, 1].to_s
+        format(device_user_agent, version: chrome_version)
+      end
+
       def reset_window_size
         @window_size = @options[:window_size]
       end

data/lib/capybara/cuprite/page.rb

@@ -44,6 +44,10 @@ module Capybara
         raise_pending_unhandled_modal_error! { super }
       end
 
+      def set_viewport(width: 0, height: 0, scale_factor: @options.scale_factor, mobile: @options.mobile)
+        super
+      end
+
       def set(node, value)
         object_id = command("DOM.resolveNode", nodeId: node.node_id).dig("object", "objectId")
         evaluate("_cuprite.set(arguments[0], arguments[1])", { "objectId" => object_id }, value)
@@ -66,7 +70,7 @@ module Capybara
       end
 
       def send_keys(node, keys)
-        unless evaluate_on(node: node, expression: %(_cuprite.containsSelection(this)))
+        unless evaluate_on(node: node, expression: %(_cuprite.containsSelection(this) || _cuprite.hasFocus(this)))
           before_click(node, "click")
           node.click(mode: :left, keys: keys)
         end
@@ -174,7 +178,8 @@ module Capybara
         super
 
         width, height = @options.window_size
-        resize(width: width, height: height)
+        width && height ? resize(width: width, height: height) : set_viewport
+        command("Network.setUserAgentOverride", userAgent: default_user_agent) if @options.device_user_agent
 
         if @options.url_blacklist.any?
           network.blacklist = @options.url_blacklist

data/lib/capybara/cuprite/version.rb

@@ -2,6 +2,6 @@
 
 module Capybara
   module Cuprite
-    VERSION = "0.18"
+    VERSION = "0.19"
   end
 end

data/lib/capybara/cuprite.rb

@@ -8,6 +8,7 @@ require "capybara/cuprite/driver"
 require "capybara/cuprite/browser"
 require "capybara/cuprite/page"
 require "capybara/cuprite/options"
+require "capybara/cuprite/devices"
 require "capybara/cuprite/node"
 require "capybara/cuprite/errors"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cuprite
 version: !ruby/object:Gem::Version
-  version: '0.18'
+  version: '0.19'
 platform: ruby
 authors:
 - Dmitry Vorotilin
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-03 00:00:00.000000000 Z
+date: 2026-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.1
 description: Cuprite is a driver for Capybara that allows you to run your tests on
   a headless Chrome browser
 email:
@@ -51,6 +51,7 @@ files:
 - lib/capybara/cuprite.rb
 - lib/capybara/cuprite/browser.rb
 - lib/capybara/cuprite/cookie.rb
+- lib/capybara/cuprite/devices.rb
 - lib/capybara/cuprite/driver.rb
 - lib/capybara/cuprite/errors.rb
 - lib/capybara/cuprite/javascripts/drag.js