ferrum-har 0.1.4 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ece6969fb3a3135a534510dbbee3a94544dfceaaebbf7ffdf2ca3b7ef9483a0c
-  data.tar.gz: f1feb7448c4b4cd86b823e22f433f650bcbe7f2bae13b68668d35efaebc427a9
+  metadata.gz: 90c64095f327010a5364542de46bdb7eb2b5af3bbb401b0d643438900311c8ea
+  data.tar.gz: b53a43f0a6198c95cb20968ba4bd941ac8b085484e4592bc5853a72716a29043
 SHA512:
-  metadata.gz: 6f60149634aababca262378cf044e8ffdd9c4dd0f6e34556ce336d3f50aec819ff43a7aea21cac26e30fa8cb7b820cb964d7a9ae9538d22c38c2a1c2d38582b2
-  data.tar.gz: 21cdba221d68c0ae8eebb2ab4d915b33f17d4c9d4058110101a94729ece0bd95080e99d5ddd55943c6ff604e3c31901199c6d54e0c11172d1d8460241c4169e0
+  metadata.gz: fcf185fd1cd4b579fc0a1a2a57169285f7333f189eb8eeebd11d61202a8fc797bcce03db925e522dfa381f83f84038ce9b41fdced0957e7d8a4af3477fb88581
+  data.tar.gz: 951491f82275957ad30ea99a8e50f07867388744173e360f887558259bc6a252cffa2e96d99f2eb3ae8ee16b93c93ce1b44ce186a49093b6110acbff7dc4ea89

data/README.md

@@ -1,7 +1,9 @@
 ferrum-har
 ================
 
-[![Gem Version](https://img.shields.io/gem/v/ferrum-har?color=green)](https://img.shields.io/gem/v/ferrum-har?color=green)
+[![Gem Version](https://img.shields.io/gem/v/ferrum-har?color=green)](https://rubygems.org/gems/ferrum-har)
+[![specs workflow](https://github.com/hlascelles/ferrum-har/actions/workflows/specs.yml/badge.svg)](https://github.com/hlascelles/ferrum-har/actions)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 [ferrum-har](https://github.com/hlascelles/ferrum-har) is a gem that adds the ability to capture
 [HAR](https://en.wikipedia.org/wiki/HAR_(file_format)) files while running tests
@@ -15,6 +17,17 @@ Add ferrum-har to your Gemfile and `bundle install`:
 gem "ferrum-har"
 ```
 
+Since version 1.0, we have had to support [a change](https://developer.chrome.com/blog/extension-news-june-2025#deprecations)
+to the way Chrome handles extensions. You must
+use Chrome Testing to use ferrum-har. A rake task is provided to help you download a chrome binary.
+It will put it in a folder called 
+
+```bash
+bundle exec rake chrome:install
+```
+
+Alternatively you can use the ENV `BROWSER_PATH` to point to the binary location.
+
 ## Usage
 
 Use [ferrum](https://github.com/rubycdp/ferrum) as normal and call the `har` method on

data/lib/ferrum/har/command_extension.rb

@@ -11,6 +11,22 @@ module Ferrum
         super.tap do |options|
           check_har_related_browser_options(options)
         end
+
+        @path = ENV["BROWSER_PATH"] ||
+                begin
+                  # Find the one in the temp download dir.
+                  Dir.glob(".chrome-for-testing/*/chrome-linux64/chrome").max_by { |p|
+                    Gem::Version.new(p.split("/")[1])
+                  }
+                end
+
+        return if @path
+
+        raise <<~ERR
+          Browser path not found. Please set BROWSER_PATH environment variable, or trigger a download of Chrome Testing by using:
+
+          bundle exec rake chrome:install
+        ERR
       end
 
       private def check_har_related_browser_options(options)

data/lib/ferrum/har/options_extension.rb

@@ -10,6 +10,8 @@ module Ferrum
           # We have to remove the "disable-extensions" option from the default browser extension
           # list because the ferrum-har gem requires an (internal) extension to work.
           .except("disable-extensions")
+          # At some point past v134 this stopped extensions loading properly in the first tab.
+          .except("no-startup-window")
           .merge(
             "auto-open-devtools-for-tabs" => nil, # Chrome devtools must be open to invoke getHAR
             "load-extension" => "#{Ferrum::Har::GEM_DIR}/extension", # Extension that gets the HAR

data/lib/ferrum/har/page_extension.rb

@@ -12,7 +12,7 @@ module Ferrum
       def har
         network.wait_for_idle
         execute("document.ferrumHarRequested = true;")
-        base64_encoded_har = Ferrum::Utils::Attempt.with_retry(
+        har_hash_result = Ferrum::Utils::Attempt.with_retry(
           errors: [HarNotReadyError],
           # 10 seconds
           max: 20,
@@ -21,13 +21,18 @@ module Ferrum
           found = evaluate("document.ferrumHar;")
           raise HarNotReadyError unless found
 
-          found
+          inlined_har = Base64.decode64(found)
+          har_hash = JSON.parse(inlined_har)
+          raise HarNotReadyError, "Result does not appear to be a HAR" unless har_hash.key?("log")
+
+          entries = har_hash.dig("log", "entries")
+          # If entries is nil or empty, the HAR is not ready yet.
+          raise HarNotReadyError if entries.nil? || entries.empty?
+
+          har_hash
         end
-        inlined_har = Base64.decode64(base64_encoded_har)
-        har_hash = JSON.parse(inlined_har)
-        raise "Result does not appear to be a HAR" unless har_hash.key?("log")
 
-        JSON.pretty_generate(har_hash)
+        JSON.pretty_generate(har_hash_result)
       end
     end
   end

data/lib/ferrum/har/version.rb

@@ -2,6 +2,6 @@
 
 module Ferrum
   module Har
-    VERSION = "0.1.4"
+    VERSION = "1.0.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ferrum-har
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 1.0.1
 platform: ruby
 authors:
 - Harry Lascelles
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-24 00:00:00.000000000 Z
+date: 2025-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: selenium_chrome_helper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Rubygem to convert ferrum traffic to HAR files
 email:
 - harry@harrylascelles.com
@@ -74,14 +88,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Rubygem to convert ferrum traffic to HAR files