puppeteer-ruby 0.52.0 → 0.52.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc3601ac8a64edb1a6054663944d5244eb0fcbc774b2d2f73529eef194031689
-  data.tar.gz: c364f8b73fc4dc6a591baca37e2e116d3147c5572f42dd026de77e36b0842851
+  metadata.gz: 70526928098a3ab1bcf1718b6110a6620188a30c77419a04181cb746acf4ed15
+  data.tar.gz: 073e09f7dd759b1b2b2d268ec3021cab96c3e56df93353343fd6ded898556d7b
 SHA512:
-  metadata.gz: a4de65d9249823c8532150d9cbeace0670d5e0c35de747193bee4923edb751b3dcc7a46aa6ec5f58393e20fabe9933b12eaca0ac47ead1d91c5793fec8ca0e9b
-  data.tar.gz: 4d5d39fe7dac8d74a3f90478f3bae1bd7e9dcb14018518551ca4ca7d59f48ed1e9f9e7205c33956d82591b2985b4fecd5f1eb4f0af8efc03f4a1b3f22a0b2281
+  metadata.gz: a222036f53e7552d12a8340850369aeed45277f44f1914984ff91168131fbc8ad0a93adf0a3ffe07b98e0f5038a14ee2da6239685bdbf297883bb2702d31df86
+  data.tar.gz: 57c5a117800a1b814d77abd3ad41d9b25487b08993e1752327dbac49a3e80474c612a52dd3141fd1025dd4fc96e5758c199a82de470abba73e290a5316db0516

data/lib/puppeteer/browser_connector.rb

@@ -1,4 +1,5 @@
 require_relative './browser'
+require_relative './chrome_user_data_dir'
 require_relative './launcher/browser_options'
 
 class Puppeteer::BrowserConnector
@@ -7,6 +8,7 @@ class Puppeteer::BrowserConnector
     @browser_ws_endpoint = options[:browser_ws_endpoint]
     @browser_url = options[:browser_url]
     @transport = options[:transport]
+    @channel = options[:channel]
   end
 
   # @return [Puppeteer::Browser]
@@ -38,16 +40,24 @@ class Puppeteer::BrowserConnector
   end
 
   private def connection
-    @connection ||=
-      if @browser_ws_endpoint && @browser_url.nil? && @transport.nil?
+    @connection ||= begin
+      connection_options = [@browser_ws_endpoint, @browser_url, @transport, @channel]
+      unless connection_options.count { |option| !!option } == 1
+        raise ArgumentError.new('Exactly one of browserWSEndpoint, browserURL, transport or channel must be passed to puppeteer.connect')
+      end
+
+      if @transport
+        connect_with_transport(@transport)
+      elsif @browser_ws_endpoint
         connect_with_browser_ws_endpoint(@browser_ws_endpoint)
-      elsif @browser_ws_endpoint.nil? && @browser_url && @transport.nil?
+      elsif @browser_url
         connect_with_browser_url(@browser_url)
-      elsif @browser_ws_endpoint.nil? && @browser_url.nil? && @transport
-        connect_with_transport(@transport)
+      elsif @channel
+        connect_with_channel(@channel)
       else
-        raise ArgumentError.new("Exactly one of browserWSEndpoint, browserURL or transport must be passed to puppeteer.connect")
+        raise ArgumentError.new('Invalid connection options')
       end
+    end
   end
 
   # @return [Puppeteer::Connection]
@@ -72,6 +82,31 @@ class Puppeteer::BrowserConnector
     connect_with_browser_ws_endpoint(connection_url)
   end
 
+  # @return [Puppeteer::Connection]
+  private def connect_with_channel(channel)
+    port_path = File.join(
+      Puppeteer::ChromeUserDataDir.resolve_default(channel),
+      'DevToolsActivePort',
+    )
+
+    begin
+      file_content = File.read(port_path, mode: 'r:ASCII')
+      raw_port, raw_path = file_content.lines.map(&:strip).reject(&:empty?)
+      unless raw_port && raw_path
+        raise Puppeteer::Error.new("Invalid DevToolsActivePort '#{file_content}' found")
+      end
+
+      port = raw_port.to_i
+      if port <= 0 || port > 65_535
+        raise Puppeteer::Error.new("Invalid port '#{raw_port}' found")
+      end
+
+      connect_with_browser_ws_endpoint("ws://localhost:#{port}#{raw_path}")
+    rescue StandardError
+      raise Puppeteer::Error.new("Could not find DevToolsActivePort for #{channel} at #{port_path}")
+    end
+  end
+
   # @return [Puppeteer::Connection]
   private def connect_with_transport(transport)
     Puppeteer::Connection.new(

data/lib/puppeteer/chrome_user_data_dir.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require_relative './env'
+
+module Puppeteer::ChromeUserDataDir
+  CHANNELS = %w[chrome chrome-beta chrome-canary chrome-dev].freeze #: Array[String]
+
+  MAC_DIR_NAMES = {
+    'chrome' => 'Chrome',
+    'chrome-beta' => 'Chrome Beta',
+    'chrome-canary' => 'Chrome Canary',
+    'chrome-dev' => 'Chrome Dev',
+  }.freeze #: Hash[String, String]
+
+  LINUX_DIR_NAMES = {
+    'chrome' => 'google-chrome',
+    'chrome-beta' => 'google-chrome-beta',
+    'chrome-canary' => 'google-chrome-canary',
+    'chrome-dev' => 'google-chrome-unstable',
+  }.freeze #: Hash[String, String]
+
+  WINDOWS_DIR_NAMES = {
+    'chrome' => ['Google', 'Chrome', 'User Data'],
+    'chrome-beta' => ['Google', 'Chrome Beta', 'User Data'],
+    'chrome-canary' => ['Google', 'Chrome SxS', 'User Data'],
+    'chrome-dev' => ['Google', 'Chrome Dev', 'User Data'],
+  }.freeze #: Hash[String, Array[String]]
+
+  # @rbs channel: (String | Symbol) -- Chrome release channel
+  # @rbs platform: Symbol? -- Optional platform override
+  # @rbs env: Hash[String, String] -- Environment variables
+  # @rbs home: String? -- Home directory override
+  # @rbs return: String -- Default user data directory
+  def self.resolve_default(channel, platform: nil, env: ENV, home: nil)
+    channel = normalize_channel(channel)
+    platform ||= current_platform
+    home ||= Dir.home
+
+    case platform.to_sym
+    when :windows
+      base = env['LOCALAPPDATA']
+      base = join_path(:windows, home, 'AppData', 'Local') if base.nil? || base.empty?
+      join_path(:windows, base, *WINDOWS_DIR_NAMES.fetch(channel))
+    when :darwin
+      join_path(:darwin, home, 'Library', 'Application Support', 'Google', MAC_DIR_NAMES.fetch(channel))
+    when :linux
+      base = env['CHROME_CONFIG_HOME']
+      base = env['XDG_CONFIG_HOME'] if base.nil? || base.empty?
+      base = join_path(:linux, home, '.config') if base.nil? || base.empty?
+      join_path(:linux, base, LINUX_DIR_NAMES.fetch(channel))
+    else
+      raise ArgumentError.new("Unsupported platform: #{platform}")
+    end
+  end
+
+  # @rbs channel: (String | Symbol) -- Chrome release channel
+  # @rbs return: String -- Normalized channel
+  def self.normalize_channel(channel)
+    normalized_channel = channel.to_s
+    return normalized_channel if CHANNELS.include?(normalized_channel)
+
+    raise ArgumentError.new("Invalid channel: '#{channel}'. Allowed channel is #{CHANNELS}")
+  end
+
+  # @rbs return: Symbol -- Current platform
+  def self.current_platform
+    if Puppeteer.env.windows?
+      :windows
+    elsif Puppeteer.env.darwin?
+      :darwin
+    else
+      :linux
+    end
+  end
+  private_class_method :current_platform
+
+  # @rbs platform: Symbol -- Target platform
+  # @rbs parts: String -- Path segments
+  # @rbs return: String -- Joined path
+  def self.join_path(platform, *parts)
+    if platform == :windows
+      parts.map(&:to_s).reject(&:empty?).join('\\')
+    else
+      File.join(*parts)
+    end
+  end
+  private_class_method :join_path
+end

data/lib/puppeteer/puppeteer.rb

@@ -140,6 +140,7 @@ class Puppeteer::Puppeteer
   # @rbs browser_ws_endpoint: String? -- Browser WebSocket endpoint
   # @rbs browser_url: String? -- Browser HTTP URL for WebSocket discovery
   # @rbs transport: Puppeteer::WebSocketTransport? -- Pre-connected transport
+  # @rbs channel: (String | Symbol)? -- Browser channel
   # @rbs ignore_https_errors: bool? -- Ignore HTTPS errors
   # @rbs network_enabled: bool? -- Enable network domain
   # @rbs issues_enabled: bool? -- Enable issues domain
@@ -153,11 +154,12 @@ class Puppeteer::Puppeteer
     browser_ws_endpoint: nil,
     browser_url: nil,
     transport: nil,
+    channel: nil,
     ignore_https_errors: nil,
     network_enabled: true,
     issues_enabled: true,
     block_list: nil,
-    default_viewport: nil,
+    default_viewport: NoViewport.new,
     slow_mo: nil,
     protocol_timeout: nil,
     &block
@@ -166,14 +168,17 @@ class Puppeteer::Puppeteer
       browser_ws_endpoint: browser_ws_endpoint,
       browser_url: browser_url,
       transport: transport,
+      channel: channel&.to_s,
       ignore_https_errors: ignore_https_errors,
       network_enabled: network_enabled,
       issues_enabled: issues_enabled,
       block_list: block_list,
-      default_viewport: default_viewport,
       slow_mo: slow_mo,
       protocol_timeout: protocol_timeout,
     }.compact
+    unless default_viewport.is_a?(NoViewport)
+      options[:default_viewport] = default_viewport
+    end
     if async_context?
       browser = Puppeteer::BrowserConnector.new(options).connect_to_browser
       if block

data/lib/puppeteer/version.rb

@@ -1,4 +1,4 @@
 module Puppeteer
-  VERSION = '0.52.0'
+  VERSION = '0.52.1'
   REF_PUPPETEER_VERSION = '24.42.0'
 end

data/sig/puppeteer/chrome_user_data_dir.rbs

@@ -0,0 +1,30 @@
+# Generated from lib/puppeteer/chrome_user_data_dir.rb with RBS::Inline
+
+module Puppeteer::ChromeUserDataDir
+  CHANNELS: Array[String]
+
+  MAC_DIR_NAMES: Hash[String, String]
+
+  LINUX_DIR_NAMES: Hash[String, String]
+
+  WINDOWS_DIR_NAMES: Hash[String, Array[String]]
+
+  # @rbs channel: (String | Symbol) -- Chrome release channel
+  # @rbs platform: Symbol? -- Optional platform override
+  # @rbs env: Hash[String, String] -- Environment variables
+  # @rbs home: String? -- Home directory override
+  # @rbs return: String -- Default user data directory
+  def self.resolve_default: (String | Symbol channel, ?platform: Symbol?, ?env: Hash[String, String], ?home: String?) -> String
+
+  # @rbs channel: (String | Symbol) -- Chrome release channel
+  # @rbs return: String -- Normalized channel
+  def self.normalize_channel: (String | Symbol channel) -> String
+
+  # @rbs return: Symbol -- Current platform
+  def self.current_platform: () -> Symbol
+
+  # @rbs platform: Symbol -- Target platform
+  # @rbs parts: String -- Path segments
+  # @rbs return: String -- Joined path
+  def self.join_path: (Symbol platform, *untyped parts) -> String
+end

data/sig/puppeteer/puppeteer.rbs

@@ -42,6 +42,7 @@ class Puppeteer::Puppeteer
   # @rbs browser_ws_endpoint: String? -- Browser WebSocket endpoint
   # @rbs browser_url: String? -- Browser HTTP URL for WebSocket discovery
   # @rbs transport: Puppeteer::WebSocketTransport? -- Pre-connected transport
+  # @rbs channel: (String | Symbol)? -- Browser channel
   # @rbs ignore_https_errors: bool? -- Ignore HTTPS errors
   # @rbs network_enabled: bool? -- Enable network domain
   # @rbs issues_enabled: bool? -- Enable issues domain
@@ -51,7 +52,7 @@ class Puppeteer::Puppeteer
   # @rbs protocol_timeout: Integer? -- CDP protocol timeout in milliseconds
   # @rbs block: Proc? -- Optional block receiving the browser
   # @rbs return: Puppeteer::Browser -- Browser instance
-  def connect: (?browser_ws_endpoint: String?, ?browser_url: String?, ?transport: Puppeteer::WebSocketTransport?, ?ignore_https_errors: bool?, ?network_enabled: bool?, ?issues_enabled: bool?, ?block_list: Array[String]?, ?default_viewport: Puppeteer::Viewport?, ?slow_mo: Integer?, ?protocol_timeout: Integer?) ?{ (?) -> untyped } -> Puppeteer::Browser
+  def connect: (?browser_ws_endpoint: String?, ?browser_url: String?, ?transport: Puppeteer::WebSocketTransport?, ?channel: (String | Symbol)?, ?ignore_https_errors: bool?, ?network_enabled: bool?, ?issues_enabled: bool?, ?block_list: Array[String]?, ?default_viewport: Puppeteer::Viewport?, ?slow_mo: Integer?, ?protocol_timeout: Integer?) ?{ (?) -> untyped } -> Puppeteer::Browser
 
   # @rbs channel: String? -- Browser channel
   # @rbs return: String -- Executable path

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puppeteer-ruby
 version: !ruby/object:Gem::Version
-  version: 0.52.0
+  version: 0.52.1
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-05-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -317,6 +317,7 @@ files:
 - lib/puppeteer/browser_runner.rb
 - lib/puppeteer/cdp_session.rb
 - lib/puppeteer/chrome_target_manager.rb
+- lib/puppeteer/chrome_user_data_dir.rb
 - lib/puppeteer/connection.rb
 - lib/puppeteer/console_message.rb
 - lib/puppeteer/console_patch.rb
@@ -399,6 +400,7 @@ files:
 - sig/_supplementary.rbs
 - sig/puppeteer/browser.rbs
 - sig/puppeteer/cdp_session.rbs
+- sig/puppeteer/chrome_user_data_dir.rbs
 - sig/puppeteer/dialog.rbs
 - sig/puppeteer/element_handle.rbs
 - sig/puppeteer/execution_context.rbs