capybara-dommy 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 288082f09fb0e1151ba15dfa7bce080997855de9ac4cbced143238b8fbc6db6b
-  data.tar.gz: 8c7c68b114eb0526071f15ae2675a94bc38492161fadbf29f3b5cf934d810f09
+  metadata.gz: ce693099e9f737e726914acb5cf9129ad87a96978209f5b1d9cc27132925b652
+  data.tar.gz: a69e70e2f0878025fd8d8c5a9411aaa990d6ebd7f812bd623cd3f27c4614e3bd
 SHA512:
-  metadata.gz: a6544c835b5721f26d77ab97c8278dc7a722c859a86c32ca06b81c263c8cb5a2d9062b318b92e731dd646795cb634bc69c91bbb229da6de3dbaf719f1bec2887
-  data.tar.gz: 707be8eeb45ba4a7ca871f1aef7160755bc0fb8a33f587b9bd37ea10fc69c9095c164684d765a5884ca7c1f79d69db650bc0fe758cdc5b752c3d61715abee610
+  metadata.gz: 1f351cf3f7989d3bfa1a984dc425cf895790350ed699431f1e6fb8a7d6708c8b1abc05ab20df20f129839a0c926074d6b64774b9885a97b593ad41b8354b0b2a
+  data.tar.gz: 4246e91a681b995f8cc2fb2633eac92a1d6e5b1fc8dad67954d099124cc999055575597a59a94965ea6d37b201ed04d9ec2271a6dbd0146d7eede6b634a416cc

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.10.0 — 2026-07-13
+
+### Added
+- **JavaScript-enabled driver variant** (`:dommy_js`, or `Driver.new(app, javascript: true)` / `config.javascript`): pages run their real Turbo/Stimulus/React bundles in the embedded QuickJS runtime, no browser process. Node interactions behave like a browser instead of the HTML-only fast paths — `click` dispatches the full pointer/mouse/click sequence before the default action (Turbo can `preventDefault` and take over), `set` types with focus + `input` / `change` events, `select_option` fires `input` / `change`, and `send_keys` dispatches real keyboard events. `execute_script` / `evaluate_script` run for real, and a time pump advances the virtual clock inside Capybara's synchronize loop so waiting matchers converge. Requires `dommy-js-quickjs`.
+
+### Fixed
+- The dommy-rack session is fully disposed on `reset!` and when the effective host changes, so JS runtimes and open WebSocket transports no longer leak across tests.
+
 ## 0.9.0 — 2026-06-22
 
 Versioned in lockstep with [`dommy`](https://github.com/takahashim/dommy) 0.9.0.

data/lib/capybara/dommy/configuration.rb

@@ -6,7 +6,7 @@ module Capybara
     # when a keyword argument is omitted.
     class Configuration
       attr_accessor :default_host, :follow_redirects, :max_redirects, :visibility,
-                    :raise_on_unsupported_js
+                    :raise_on_unsupported_js, :javascript
 
       def initialize
         @default_host = "http://example.org"
@@ -14,6 +14,7 @@ module Capybara
         @max_redirects = 5
         @visibility = :html
         @raise_on_unsupported_js = true
+        @javascript = false
       end
     end
 

data/lib/capybara/dommy/driver.rb

@@ -28,10 +28,12 @@ module Capybara
                      default_host: nil,
                      follow_redirects: nil,
                      max_redirects: nil,
-                     visibility: nil)
+                     visibility: nil,
+                     javascript: nil)
         super()
         config = Capybara::Dommy.configuration
         @app = app
+        @javascript = javascript.nil? ? config.javascript : javascript
         @visibility = visibility || config.visibility
         unless VISIBILITY_MODES.include?(@visibility)
           raise ArgumentError,
@@ -46,6 +48,24 @@ module Capybara
           # hosts (e.g. app_host / multi-server specs), so don't enforce origin.
           enforce_same_origin: false
         }
+        @session_options[:javascript] = true if @javascript
+        # A JS session needs the virtual clock pumped inside Capybara's
+        # synchronize loop, so waiting expectations converge on timer/fetch
+        # driven updates. A host-installed pump (the documented seam) wins.
+        @time_pump ||= -> { @rack_session&.advance_time(16) } if @javascript
+      end
+
+      # Whether this driver runs page JavaScript (`javascript: true`, backed by
+      # a `Dommy::Rack::Session.new(app, javascript: true)`). Node interactions
+      # then dispatch real DOM events (Turbo/Stimulus handlers run) instead of
+      # the HTML-only fast paths.
+      def javascript? = @javascript
+
+      # Drain the JS runtime after an interaction's events (promise reactions
+      # settle before the next Capybara step). No-op without JavaScript.
+      def drain_js
+        rack_session.after_interaction if @javascript
+        nil
       end
 
       # The dommy-rack session. Named `rack_session` to avoid colliding with
@@ -55,6 +75,7 @@ module Capybara
       def rack_session
         host = effective_host
         if @rack_session.nil? || @rack_session_host != host
+          @rack_session&.dispose
           @rack_session = ::Dommy::Rack::Session.new(@app, **@session_options.merge(default_host: host))
           @rack_session_host = host
         end
@@ -179,6 +200,7 @@ module Capybara
       # --- Lifecycle ---
 
       def reset!
+        @rack_session&.dispose
         @rack_session = nil
         @frame_stack = []
       end
@@ -200,12 +222,18 @@ module Capybara
       # When raise_on_unsupported_js is false these become no-ops, so tests
       # that incidentally call them don't fail.
 
-      def execute_script(_script, *_args)
-        unsupported_js!("execute_script")
+      def execute_script(script, *args)
+        return unsupported_js!("execute_script") unless @javascript
+        raise ArgumentError, "script arguments are not supported" unless args.empty?
+
+        rack_session.execute_script(script)
       end
 
-      def evaluate_script(_script, *_args)
-        unsupported_js!("evaluate_script")
+      def evaluate_script(script, *args)
+        return unsupported_js!("evaluate_script") unless @javascript
+        raise ArgumentError, "script arguments are not supported" unless args.empty?
+
+        rack_session.evaluate_script(script)
       end
 
       def evaluate_async_script(_script, *_args)

data/lib/capybara/dommy/node.rb

@@ -107,6 +107,12 @@ module Capybara
       # Capybara's non-JS send_keys specs use. Key *events* are not dispatched
       # (nothing here can observe them without JavaScript).
       def send_keys(*args)
+        # Under JavaScript, dispatch real keyboard events (keydown/keypress/
+        # input/keyup with browser default actions) through the dommy driver,
+        # so keyboard handlers (arrow navigation, Enter selection) run.
+        # Key chords ([:shift, "o"]) are not supported on this path.
+        return driver.rack_session.send_keys_to(native, *args) if driver.javascript?
+
         return unless native.respond_to?(:value=)
 
         state = {chars: native.value.to_s.chars, caret: native.value.to_s.length, shift: false}
@@ -136,6 +142,8 @@ module Capybara
       # --- Interaction ---
 
       def click(_keys = [], **_options)
+        return js_click if driver.javascript?
+
         if link?
           click_link_node
         elsif submits?
@@ -171,6 +179,7 @@ module Capybara
         select_el = select_node
         deselect_all(select_el) unless select_el&.multiple
         native.selected = true
+        notify_select_changed(select_el)
       end
 
       def unselect_option
@@ -257,6 +266,40 @@ module Capybara
       # javascript: links are no-ops in Capybara (a policy decision); every
       # other link delegates to dommy-rack, which handles fragment / same-page
       # / blank-href semantics and raises on genuinely unsupported schemes.
+      # A JavaScript click: dispatch the full pointer/mouse/click sequence
+      # (Stimulus actions, Turbo's link/submit interception run like in a
+      # browser), then perform the un-prevented default action ourselves —
+      # link navigation, or the form submission algorithm (a cancelable
+      # submit event, then the real submission if nothing canceled it;
+      # Turbo cancels and takes over). Checkbox/radio toggling already ran
+      # as the click event's activation behavior.
+      def js_click
+        prevented = ::Dommy::Interaction::EventSynthesis.click(native)
+        unless prevented
+          # Link navigation and form submission are the elements' own activation
+          # behavior — run inside EventSynthesis.click above, routing through the
+          # session's navigation delegate (performed when driver.drain_js drains).
+          # Only the non-navigating default actions remain here.
+          if tag_name == "label"
+            click_label
+          elsif (details = native.closest("details"))
+            toggle_details(details)
+          end
+        end
+        driver.drain_js
+        nil
+      end
+
+      # Selecting an option through the UI fires input + change on the select
+      # (under JavaScript; nothing listens without it).
+      def notify_select_changed(select_el)
+        return unless driver.javascript? && select_el
+
+        ::Dommy::Interaction::EventSynthesis.input(select_el)
+        ::Dommy::Interaction::EventSynthesis.change(select_el)
+        driver.drain_js
+      end
+
       def click_link_node
         scheme = native.get_attribute("href").to_s.split(":", 2).first.to_s.downcase
         return if scheme == "javascript"
@@ -303,11 +346,28 @@ module Capybara
         # There is no submitter button in this case.
         form = single_field_form
         if input_field? && string.end_with?("\n") && form
-          native.value = string.chomp
+          write_text(string.chomp)
           driver.submit_form(form, submitter: nil)
         else
+          write_text(string)
+        end
+      end
+
+      # Set a text field's value. Under JavaScript this types like a user:
+      # focus, value, then input + change events, so Stimulus/React handlers
+      # observe the edit; the JS-less driver keeps the bare value write
+      # (nothing listens).
+      def write_text(string)
+        unless driver.javascript?
           native.value = string
+          return
         end
+
+        ::Dommy::Interaction::EventSynthesis.focus(native)
+        native.value = string
+        ::Dommy::Interaction::EventSynthesis.input(native, string)
+        ::Dommy::Interaction::EventSynthesis.change(native)
+        driver.drain_js
       end
 
       def single_field_form

data/lib/capybara/dommy/rails.rb

@@ -8,3 +8,10 @@ require "capybara/dommy"
 Capybara.register_driver(:dommy) do |app|
   Capybara::Dommy::Driver.new(app)
 end
+
+# The JavaScript-enabled variant (`driven_by :dommy_js`): pages run their real
+# Turbo/Stimulus/React bundles in the embedded QuickJS runtime, no browser
+# process. Requires dommy-js-quickjs.
+Capybara.register_driver(:dommy_js) do |app|
+  Capybara::Dommy::Driver.new(app, javascript: true)
+end

data/lib/capybara/dommy/version.rb

@@ -2,6 +2,6 @@
 
 module Capybara
   module Dommy
-    VERSION = "0.9.0"
+    VERSION = "0.10.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capybara-dommy
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - takahashim
@@ -29,28 +29,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.10.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.10.0
 - !ruby/object:Gem::Dependency
   name: dommy-rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.10.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.10.0
 description: |
   capybara-dommy is a Capybara driver backed by Dommy and dommy-rack. It drives
   Rack/Rails apps through the Capybara DSL without a real browser or JavaScript,
@@ -94,7 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: A Dommy-backed Capybara driver
 test_files: []