puppeteer-ruby 0.50.1 → 0.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e905c9995f718c953c11c9c199e7c945c0d413750becae8bdbc13cc4c0c1e5f
-  data.tar.gz: 9fec2af23369834b277ec50ef655b4a086b9df67698465f133b1af2ed059b11e
+  metadata.gz: 74f00095ae82e1e4502260b99ff766cc46c758ae5e762050a6e7c46b7249f469
+  data.tar.gz: a197f92fc8b7ccbe2904c088d52e60409af119d94449a6a4e9f518601c4c5788
 SHA512:
-  metadata.gz: e636edbdf0dcb3731e7b688936f4c04bf7b9f21668ce6ed712d993e2dac41b748f4e49e89b9b43ddfcdd2b37138275bf1b95e5191d7d09cd1d3df664f6838358
-  data.tar.gz: 1e7478c8a4757743d6e31321af550b0900b04a46785b51ac2bb0203060d1456e8917722ad6631ae86a546b8fccb7f1947b185b7c9007e7720773a1772146557a
+  metadata.gz: df595ba0c4996b100b1d8b22bb35e0e0ce9b6552d368c11fc25b9c8cf60c1a270b651f6f96e6c1b65b64d32550b71c402a059a0fd4d3a1393a394b65de472aef
+  data.tar.gz: f82344aba53b730d5fdb7273ef29fdb07d0b8aadc831d680fd5611d55df980955cb5fd5cbdbe78d0de88c70d689f738952187193b4f006386a2170970f928dd2

data/docs/api_coverage.md

@@ -1,6 +1,6 @@
 # API coverages
-- Puppeteer version: v24.35.0
-- puppeteer-ruby version: 0.50.1
+- Puppeteer version: v24.37.0
+- puppeteer-ruby version: 0.51.0
 
 ## Puppeteer
 
@@ -34,6 +34,7 @@
 * ~~removeScreen~~
 * ~~screens~~
 * ~~setCookie~~
+* setPermission => `#set_permission`
 * ~~setWindowBounds~~
 * target
 * targets
@@ -55,6 +56,7 @@
 * overridePermissions => `#override_permissions`
 * pages
 * setCookie => `#set_cookie`
+* setPermission => `#set_permission`
 * targets
 * waitForTarget => `#wait_for_target`
 
@@ -321,6 +323,7 @@
 * bringToFront => `#bring_to_front`
 * browser
 * browserContext => `#browser_context`
+* captureHeapSnapshot => `#capture_heap_snapshot`
 * click
 * close
 * content

data/lib/puppeteer/browser.rb

@@ -196,6 +196,13 @@ class Puppeteer::Browser
     @default_context
   end
 
+  # @rbs origin: String -- Origin URL, or '*' for all origins
+  # @rbs permissions: Array[Hash[Symbol | String, untyped]] -- Permission descriptors and states
+  # @rbs return: void -- No return value
+  def set_permission(origin, *permissions)
+    @default_context.set_permission(origin, *permissions)
+  end
+
   # @rbs context_id: String? -- Browser context ID
   # @rbs return: void -- No return value
   def dispose_context(context_id)

data/lib/puppeteer/browser_context.rb

@@ -153,6 +153,44 @@ class Puppeteer::BrowserContext
     }.compact)
   end
 
+  # @param origin [String] Use '*' to apply to all origins.
+  # @param permissions [Array<Hash>] { permission: { name:, userVisibleOnly:, sysex:, panTiltZoom:, allowWithoutSanitization: }, state: 'granted'|'denied'|'prompt' }
+  def set_permission(origin, *permissions)
+    permissions.each do |permission|
+      descriptor = hash_value(permission, 'permission')
+      state = hash_value(permission, 'state')
+      unless descriptor.is_a?(Hash)
+        raise ArgumentError.new('Each permission entry must include a permission descriptor')
+      end
+      unless state
+        raise ArgumentError.new('Each permission entry must include state')
+      end
+
+      name = hash_value(descriptor, 'name')
+      unless name
+        raise ArgumentError.new('Permission descriptor must include name')
+      end
+
+      protocol_permission = { name: name.to_s }
+      {
+        userVisibleOnly: %w[userVisibleOnly user_visible_only],
+        sysex: %w[sysex],
+        panTiltZoom: %w[panTiltZoom pan_tilt_zoom],
+        allowWithoutSanitization: %w[allowWithoutSanitization allow_without_sanitization],
+      }.each do |protocol_key, keys|
+        value = hash_value(descriptor, *keys)
+        protocol_permission[protocol_key] = value unless value.nil?
+      end
+
+      @connection.send_message('Browser.setPermission', {
+        origin: origin == '*' ? nil : origin,
+        browserContextId: @id,
+        permission: protocol_permission,
+        setting: state.to_s,
+      }.compact)
+    end
+  end
+
   def clear_permission_overrides
     if @id
       @connection.send_message('Browser.resetPermissions', browserContextId: @id)
@@ -214,6 +252,9 @@ class Puppeteer::BrowserContext
       normalized = normalize_cookie_hash(cookie)
       partition_key = normalized.delete('partitionKey') || normalized.delete('partition_key')
       normalized['partitionKey'] = convert_partition_key_for_cdp(partition_key) if partition_key
+      same_site = normalized.delete('sameSite') || normalized.delete('same_site')
+      converted_same_site = convert_same_site_for_cdp(same_site)
+      normalized['sameSite'] = converted_same_site if converted_same_site
       normalized
     end
     @connection.send_message('Storage.setCookies', {
@@ -277,9 +318,7 @@ class Puppeteer::BrowserContext
   end
 
   private def normalize_cookie_hash(cookie)
-    cookie.each_with_object({}) do |(key, value), normalized|
-      normalized[key.to_s] = value
-    end
+    cookie.transform_keys(&:to_s)
   end
 
   private def hash_value(hash, *keys)
@@ -305,6 +344,15 @@ class Puppeteer::BrowserContext
     }
   end
 
+  private def convert_same_site_for_cdp(same_site)
+    case same_site
+    when 'Strict', 'Lax', 'None'
+      same_site
+    else
+      nil
+    end
+  end
+
   private def convert_partition_key_from_cdp(partition_key)
     return nil if partition_key.nil?
     return partition_key if partition_key.is_a?(String)

data/lib/puppeteer/chrome_target_manager.rb

@@ -149,11 +149,11 @@ class Puppeteer::ChromeTargetManager
     target_info = @discovered_targets_by_target_id.delete(target_id)
     finish_initialization_if_ready(target_id)
 
-    if target_info.type == 'service_worker' && @attached_targets_by_target_id.has_key?(target_id)
+    if target_info&.type == 'service_worker'
       # Special case for service workers: report TargetGone event when
       # the worker is destroyed.
       target = @attached_targets_by_target_id.delete(target_id)
-      emit_event(TargetManagerEmittedEvents::TargetGone, target)
+      emit_event(TargetManagerEmittedEvents::TargetGone, target) if target
     end
   end
 
@@ -161,11 +161,11 @@ class Puppeteer::ChromeTargetManager
     target_info = Puppeteer::Target::TargetInfo.new(event['targetInfo'])
     @discovered_targets_by_target_id[target_info.target_id] = target_info
 
-    if @ignored_targets.include?(target_info.target_id) || !@attached_targets_by_target_id.has_key?(target_info.target_id) || !target_info.attached
+    if @ignored_targets.include?(target_info.target_id) || !target_info.attached
       return
     end
     original_target = @attached_targets_by_target_id[target_info.target_id]
-    emit_event(TargetManagerEmittedEvents::TargetChanged, original_target, target_info)
+    emit_event(TargetManagerEmittedEvents::TargetChanged, original_target, target_info) if original_target
   end
 
   class SessionNotCreatedError < Puppeteer::Error ; end

data/lib/puppeteer/http_request.rb

@@ -1,5 +1,7 @@
 # rbs_inline: enabled
 
+require 'base64'
+
 class Puppeteer::HTTPRequest
   include Puppeteer::DebugPrint
   include Puppeteer::IfPresent
@@ -101,7 +103,7 @@ class Puppeteer::HTTPRequest
     resource_type = event['type'] || event['resourceType'] || 'other'
     @resource_type = resource_type.downcase
     @method = event['request']['method']
-    @post_data = event['request']['postData']
+    @post_data = parse_post_data(event)
     has_post_data = event.dig('request', 'hasPostData')
     @has_post_data = has_post_data.nil? ? !@post_data.nil? : has_post_data
     @frame = frame
@@ -160,6 +162,18 @@ class Puppeteer::HTTPRequest
     end
   end
 
+  private def parse_post_data(event)
+    post_data_entries = event.dig('request', 'postDataEntries')
+    if post_data_entries && !post_data_entries.empty?
+      post_data_entries
+        .filter_map { |entry| entry['bytes'] ? Base64.decode64(entry['bytes']) : nil }
+        .join
+        .force_encoding('UTF-8')
+    else
+      event.dig('request', 'postData')
+    end
+  end
+
   private def assert_interception_not_handled
     if @interception_handled
       raise AlreadyHandledError.new

data/lib/puppeteer/http_response.rb

@@ -113,7 +113,12 @@ class Puppeteer::HTTPResponse
   # @param text [String]
   # @rbs return: String -- Response body as text
   def text
-    buffer
+    content = buffer
+    content = content.dup.force_encoding('UTF-8')
+    unless content.valid_encoding?
+      raise Puppeteer::Error.new('Could not decode response body as UTF-8')
+    end
+    content
   end
 
   # @param json [Hash]

data/lib/puppeteer/launcher/chrome.rb

@@ -131,7 +131,7 @@ module Puppeteer::Launcher
           '--disable-dev-shm-usage',
           '--disable-extensions',
           # AcceptCHFrame disabled because of crbug.com/1348106.
-          '--disable-features=Translate,BackForwardCache,AcceptCHFrame,MediaRouter,OptimizationHints',
+          '--disable-features=Translate,BackForwardCache,AcceptCHFrame,MediaRouter,OptimizationHints,IPH_ReadingModePageActionLabel,ReadAnythingOmniboxChip',
           '--disable-hang-monitor',
           '--disable-ipc-flooding-protection',
           '--disable-popup-blocking',

data/lib/puppeteer/locators.rb

@@ -213,15 +213,16 @@ class Puppeteer::Locator
   end
 
   # @rbs value: String -- Value to fill
+  # @rbs typing_threshold: Integer -- Minimum length to switch to direct assignment
   # @rbs return: void -- No return value
-  def fill(value)
+  def fill(value, typing_threshold: 100)
     perform_action('Locator.fill',
       conditions: [
         method(:ensure_element_is_in_viewport_if_needed),
         method(:wait_for_stable_bounding_box_if_needed),
         method(:wait_for_enabled_if_needed),
       ]) do |handle, _options|
-      fill_element(handle, value)
+      fill_element(handle, value, typing_threshold: typing_threshold)
     end
   end
 
@@ -422,7 +423,7 @@ class Puppeteer::Locator
     end
   end
 
-  private def fill_element(handle, value)
+  private def fill_element(handle, value, typing_threshold: 100)
     input_type = handle.evaluate(<<~JAVASCRIPT)
       el => {
         if (el instanceof HTMLSelectElement) {
@@ -461,52 +462,70 @@ class Puppeteer::Locator
     when 'select'
       handle.select(value)
     when 'contenteditable', 'typeable-input'
-      text_to_type = handle.evaluate(<<~JAVASCRIPT, value)
-        (input, newValue) => {
-          const currentValue = input.isContentEditable
-            ? input.innerText
-            : input.value;
+      if value.length < typing_threshold
+        text_to_type = handle.evaluate(<<~JAVASCRIPT, value)
+          (input, newValue) => {
+            const currentValue = input.isContentEditable
+              ? input.innerText
+              : input.value;
+
+            if (
+              newValue.length <= currentValue.length ||
+              !newValue.startsWith(input.value)
+            ) {
+              if (input.isContentEditable) {
+                input.innerText = '';
+              } else {
+                input.value = '';
+              }
+              return newValue;
+            }
+            const originalValue = input.isContentEditable
+              ? input.innerText
+              : input.value;
 
-          if (
-            newValue.length <= currentValue.length ||
-            !newValue.startsWith(input.value)
-          ) {
             if (input.isContentEditable) {
               input.innerText = '';
+              input.innerText = originalValue;
             } else {
               input.value = '';
+              input.value = originalValue;
             }
-            return newValue;
+            return newValue.substring(originalValue.length);
           }
-          const originalValue = input.isContentEditable
-            ? input.innerText
-            : input.value;
-
-          if (input.isContentEditable) {
-            input.innerText = '';
-            input.innerText = originalValue;
-          } else {
-            input.value = '';
-            input.value = originalValue;
-          }
-          return newValue.substring(originalValue.length);
-        }
-      JAVASCRIPT
-      text_to_type = text_to_type.to_s
-      handle.type_text(text_to_type)
+        JAVASCRIPT
+        text_to_type = text_to_type.to_s
+        handle.type_text(text_to_type) unless text_to_type.empty?
+      else
+        fill_directly(handle, value)
+      end
     when 'other-input'
-      handle.focus
-      handle.evaluate(<<~JAVASCRIPT, value)
-        (input, newValue) => {
-          input.value = newValue;
-          input.dispatchEvent(new Event('input', { bubbles: true }));
-          input.dispatchEvent(new Event('change', { bubbles: true }));
-        }
-      JAVASCRIPT
+      fill_directly(handle, value)
     else
       raise Puppeteer::Error.new('Element cannot be filled out.')
     end
   end
+
+  private def fill_directly(handle, value)
+    handle.focus
+    handle.evaluate(<<~JAVASCRIPT, value)
+      (input, newValue) => {
+        const currentValue = input.isContentEditable
+          ? input.innerText
+          : input.value;
+        if (currentValue === newValue) {
+          return;
+        }
+        if (input.isContentEditable) {
+          input.innerText = newValue;
+        } else {
+          input.value = newValue;
+        }
+        input.dispatchEvent(new Event('input', { bubbles: true }));
+        input.dispatchEvent(new Event('change', { bubbles: true }));
+      }
+    JAVASCRIPT
+  end
 end
 
 class Puppeteer::FunctionLocator < Puppeteer::Locator

data/lib/puppeteer/page.rb

@@ -193,7 +193,6 @@ class Puppeteer::Page
       @workers[session.id] = worker
       emit_event(PageEmittedEvents::WorkerCreated, worker)
     end
-
   end
 
   # @rbs return: Array[untyped] -- Initialization results
@@ -560,6 +559,15 @@ class Puppeteer::Page
     raise ArgumentError.new("Each coookie must have #{requires.join(" and ")} attribute.")
   end
 
+  private def convert_same_site_for_cdp(same_site)
+    case same_site
+    when 'Strict', 'Lax', 'None'
+      same_site
+    else
+      nil
+    end
+  end
+
   # @rbs cookies: Array[Hash[Symbol | String, untyped]] -- cookies parameter
   # @rbs return: void -- No return value
   def delete_cookie(*cookies)
@@ -582,8 +590,28 @@ class Puppeteer::Page
     starts_with_http = page_url.start_with?("http")
     items = cookies.map do |cookie|
       (starts_with_http ? { url: page_url } : {}).merge(cookie).tap do |item|
-        raise ArgumentError.new("Blank page can not have cookie \"#{item[:name]}\"") if item[:url] == "about:blank"
-        raise ArgumentError.new("Data URL page can not have cookie \"#{item[:name]}\"") if item[:url]&.start_with?("data:")
+        item_name = item[:name] || item['name']
+        item_url = item[:url] || item['url']
+        raise ArgumentError.new("Blank page can not have cookie \"#{item_name}\"") if item_url == "about:blank"
+        raise ArgumentError.new("Data URL page can not have cookie \"#{item_name}\"") if item_url&.start_with?("data:")
+
+        same_site =
+          if item.key?(:sameSite)
+            item[:sameSite]
+          elsif item.key?('sameSite')
+            item['sameSite']
+          elsif item.key?(:same_site)
+            item[:same_site]
+          else
+            item['same_site']
+          end
+
+        converted_same_site = convert_same_site_for_cdp(same_site)
+        item.delete(:sameSite)
+        item.delete('sameSite')
+        item.delete(:same_site)
+        item.delete('same_site')
+        item[:sameSite] = converted_same_site if converted_same_site
       end
     end
     delete_cookie(*items)
@@ -708,6 +736,29 @@ class Puppeteer::Page
     Metrics.new(response['metrics'])
   end
 
+  # @rbs path: String -- Output path for the heap snapshot
+  # @rbs return: void -- No return value
+  def capture_heap_snapshot(path:)
+    @client.send_message('HeapProfiler.enable')
+    @client.send_message('HeapProfiler.collectGarbage')
+
+    begin
+      File.open(path, 'w') do |file|
+        listener_id = @client.add_event_listener('HeapProfiler.addHeapSnapshotChunk') do |event|
+          file.write(event['chunk'])
+        end
+
+        begin
+          @client.send_message('HeapProfiler.takeHeapSnapshot', reportProgress: false)
+        ensure
+          @client.remove_event_listener(listener_id)
+        end
+      end
+    ensure
+      @client.send_message('HeapProfiler.disable')
+    end
+  end
+
   class PageError < Puppeteer::Error ; end
 
   private def handle_exception(exception_details)

data/lib/puppeteer/version.rb

@@ -1,3 +1,4 @@
 module Puppeteer
-  VERSION = '0.50.1'
+  VERSION = '0.51.0'
+  REF_PUPPETEER_VERSION = '24.37.0'
 end

data/puppeteer-ruby.gemspec

@@ -36,7 +36,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rspec', '~> 3.13.2'
   spec.add_development_dependency 'rspec_junit_formatter' # for CircleCI.
   spec.add_development_dependency 'rbs-inline'
-  spec.add_development_dependency 'rubocop', '~> 1.82.1'
+  spec.add_development_dependency 'rubocop', '~> 1.84.0'
   spec.add_development_dependency 'rubocop-rspec', '~> 3.9.0'
   spec.add_development_dependency 'sinatra', '< 5.0.0'
   spec.add_development_dependency 'steep'

data/sig/_supplementary.rbs

@@ -134,12 +134,14 @@ class Puppeteer::BrowserContext
   def delete_cookie: (*Hash[Symbol | String, untyped] cookies) -> void
   def delete_matching_cookies: (*Hash[Symbol | String, untyped] filters) -> void
   def set_download_behavior: (Hash[Symbol | String, untyped] download_behavior) -> void
+  def set_permission: (String origin, *Hash[Symbol | String, untyped] permissions) -> void
 
   private
   def normalize_cookie_hash: (Hash[Symbol | String, untyped] cookie) -> Hash[String, untyped]
   def hash_value: (Hash[untyped, untyped]? hash, *(String | Symbol) keys) -> untyped
   def convert_partition_key_for_cdp: (untyped partition_key) -> Hash[Symbol, untyped]?
   def convert_partition_key_from_cdp: (untyped partition_key) -> (Hash[String, untyped] | String | nil)
+  def convert_same_site_for_cdp: (untyped same_site) -> String?
 end
 
 class Puppeteer::Frame

data/sig/puppeteer/browser.rbs

@@ -73,6 +73,11 @@ class Puppeteer::Browser
   # @rbs return: Puppeteer::BrowserContext -- Default browser context
   def default_browser_context: () -> Puppeteer::BrowserContext
 
+  # @rbs origin: String -- Origin URL, or '*' for all origins
+  # @rbs permissions: Array[Hash[Symbol | String, untyped]] -- Permission descriptors and states
+  # @rbs return: void -- No return value
+  def set_permission: (String origin, *untyped permissions) -> void
+
   # @rbs context_id: String? -- Browser context ID
   # @rbs return: void -- No return value
   def dispose_context: (String? context_id) -> void

data/sig/puppeteer/http_request.rbs

@@ -91,6 +91,8 @@ class Puppeteer::HTTPRequest
 
   private def assert_interception_allowed: () -> untyped
 
+  private def parse_post_data: (untyped event) -> untyped
+
   private def assert_interception_not_handled: () -> untyped
 
   private def can_be_intercepted?: () -> untyped

data/sig/puppeteer/locators.rbs

@@ -94,8 +94,9 @@ class Puppeteer::Locator
   def click: (?delay: Numeric?, ?button: String?, ?click_count: Integer?, ?count: Integer?, ?offset: Hash[Symbol, Numeric]?) -> void
 
   # @rbs value: String -- Value to fill
+  # @rbs typing_threshold: Integer -- Minimum length to switch to direct assignment
   # @rbs return: void -- No return value
-  def fill: (String value) -> void
+  def fill: (String value, ?typing_threshold: Integer) -> void
 
   # @rbs return: void -- No return value
   def hover: () -> void
@@ -133,7 +134,9 @@ class Puppeteer::Locator
 
   private def ensure_element_is_in_viewport_if_needed: (untyped handle, untyped options) -> untyped
 
-  private def fill_element: (untyped handle, untyped value) -> untyped
+  private def fill_element: (untyped handle, untyped value, ?typing_threshold: untyped) -> untyped
+
+  private def fill_directly: (untyped handle, untyped value) -> untyped
 end
 
 class Puppeteer::FunctionLocator < Puppeteer::Locator

data/sig/puppeteer/page.rbs

@@ -191,6 +191,8 @@ class Puppeteer::Page
   # check if each cookie element has required fields ('name' and 'value')
   private def assert_cookie_params: (untyped cookies, requires: untyped) -> untyped
 
+  private def convert_same_site_for_cdp: (untyped same_site) -> untyped
+
   # @rbs cookies: Array[Hash[Symbol | String, untyped]] -- cookies parameter
   # @rbs return: void -- No return value
   def delete_cookie: (*untyped cookies) -> void
@@ -239,6 +241,10 @@ class Puppeteer::Page
   # @rbs return: Puppeteer::Page::Metrics -- Page metrics
   def metrics: () -> Puppeteer::Page::Metrics
 
+  # @rbs path: String -- Output path for the heap snapshot
+  # @rbs return: void -- No return value
+  def capture_heap_snapshot: (path: String) -> void
+
   class PageError < Puppeteer::Error
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puppeteer-ruby
 version: !ruby/object:Gem::Version
-  version: 0.50.1
+  version: 0.51.0
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-28 00:00:00.000000000 Z
+date: 2026-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -216,14 +216,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.82.1
+        version: 1.84.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.82.1
+        version: 1.84.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement