capybara-storyboard 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c4545f0de7b20b1fbfcf71a08ed644553d5445001370ff3d59a4d8c9fc9c88f
-  data.tar.gz: a3aa8204023cab2f89f1799f0fbf7aee7fe6965bbbe00d1944e75c27010dc158
+  metadata.gz: ad9e5b4eaf1c9021974e3b98572e5df40de5cd7d9a76a4596d1d1498a5b1ba6e
+  data.tar.gz: d43fd39b24c6501f2e22f89c63e83df203da15cc111b4812b520727fa26280e7
 SHA512:
-  metadata.gz: 4aed98cd98f7137740c85d5b9d994adbec0ecd2f9c06c972c7caacc5b4087e7450710855e267d507651ceb1f5d4f4667bfb1bdf8d0a9d0f037c5d39f27bcadb4
-  data.tar.gz: f801d661ab48e2d980fc39aaa7f8d9614a79a6c6b3795c7335f33263658a872d97894c8e7ad76fabf72bd51767d2dfbbc17ad45c056bd86661c4c425e8d1d8b6
+  metadata.gz: 83807f656992133cd59d9602f2a1574e9d018d69e63a69010b01dc28ba0bcc27de48d464fe10e36eb1e60ab914eae6b9725d226735b4b3266cf39c983c24d0ce
+  data.tar.gz: 513c4e0147ef78eee5a5e36c720ea428b8a8ee9ebbf885c31201438d3d12b8bdbc2bc495a3e0fd6e8c58c2458ba49fc7ddd3d8350f59d5ead1b5f9e019953afc

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-07-23
+
+- Fix `NoMethodError` / spurious "skipped after error" warnings when a page navigation happens between setup and a stability poll, by treating non-finite poll results (nil/NaN/Infinity) as "measurement lost" and re-arming the observer
+
 ## [0.2.0] - 2026-07-22
 
 - Add `visual-regression-test` skill for AI-assisted before/after screenshot comparison

data/lib/capybara/storyboard/page_stability.rb

@@ -62,8 +62,15 @@ module Capybara
           stable = stable?(result, interval)
           break if stable
 
-          # No point sleeping after the final check — nothing re-checks it.
-          sleep(interval) unless attempt == max_attempts - 1
+          # No point re-arming or sleeping after the final check — cleanup runs
+          # immediately after and nothing re-checks it.
+          next if attempt == max_attempts - 1
+
+          # The measurement was reset by a page navigation (non-numeric result);
+          # re-arm the observer with the configured excluded animations so the
+          # next poll can measure again.
+          setup(page, excluded_animations) unless measurable?(result)
+          sleep(interval)
         end
 
         # Unstable (or max_attempts was 0): the page is deemed good enough.
@@ -106,9 +113,32 @@ module Capybara
         nil
       end
 
+      # True when the poll returned real numbers to compare. A page navigation
+      # between setup and a poll swaps in a fresh document whose
+      # window._lastMutationTime is undefined, so Date.now() - undefined === NaN.
+      # Callers use this to decide whether to re-arm the observer (Ruby side) and
+      # whether the numeric comparison in #stable? is even meaningful.
+      def measurable?(result)
+        finite_number?(result['runningAnimations']) && finite_number?(result['timeSinceLastMutation'])
+      end
+
+      # True only for a real, finite number. Guards against nil (Selenium
+      # serializes a navigation-reset NaN to JSON null) and against Float::NAN /
+      # Infinity (CDP drivers such as Cuprite/Ferrum decode the reset NaN back
+      # into a literal Float::NAN), both of which mean "the measurement was lost
+      # and must be re-armed".
+      def finite_number?(value)
+        value.is_a?(Numeric) && (!value.is_a?(Float) || value.finite?)
+      end
+
       # evaluate_script returns string-keyed hashes on the real drivers; the
       # DOM-quiet window is measured in ms, so compare against interval * 1000.
+      # A non-numeric result (e.g. the measurement was reset by a page
+      # navigation) is treated as "not stable yet", which also keeps this
+      # comparison free of NoMethodError regardless of what the driver hands back.
       def stable?(result, interval)
+        return false unless measurable?(result)
+
         result['runningAnimations'].zero? && result['timeSinceLastMutation'] >= (interval * 1000)
       end
 

data/lib/capybara/storyboard/version.rb

@@ -2,6 +2,6 @@
 
 module Capybara
   module Storyboard
-    VERSION = '0.2.0'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capybara-storyboard
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - aki