puppeteer-ruby 0.50.0.alpha5 → 0.50.0.alpha6

data/lib/puppeteer/version.rb

@@ -1,3 +1,3 @@
 module Puppeteer
-  VERSION = '0.50.0.alpha5'
+  VERSION = '0.50.0.alpha6'
 end

data/lib/puppeteer.rb

@@ -70,6 +70,8 @@ require 'puppeteer/network_manager'
 require 'puppeteer/page'
 require 'puppeteer/protocol_stream_reader'
 require 'puppeteer/puppeteer'
+require 'puppeteer/p_selector_parser'
+require 'puppeteer/p_query_handler'
 require 'puppeteer/query_handler_manager'
 require 'puppeteer/remote_object'
 require 'puppeteer/target'
@@ -86,6 +88,7 @@ require 'puppeteer/web_socket_transport'
 
 # subclasses
 require 'puppeteer/element_handle'
+require 'puppeteer/locators'
 
 # ref: https://github.com/puppeteer/puppeteer/blob/master/lib/Puppeteer.js
 module Puppeteer

data/sig/puppeteer/element_handle.rbs

@@ -112,6 +112,9 @@ class Puppeteer::ElementHandle < Puppeteer::JSHandle
   # @rbs return: Puppeteer::ElementHandle -- Element handle
   def as_element: () -> Puppeteer::ElementHandle
 
+  # @rbs return: Puppeteer::Locator -- Locator for this element
+  def as_locator: () -> Puppeteer::Locator
+
   # @rbs return: bool -- Whether element is visible
   def visible?: () -> bool
 

data/sig/puppeteer/frame.rbs

@@ -19,6 +19,13 @@ class Puppeteer::Frame
   # @rbs return: Puppeteer::Page -- Owning page
   def page: () -> Puppeteer::Page
 
+  # @rbs return: Numeric -- Default timeout in milliseconds
+  def default_timeout: () -> Numeric
+
+  # @rbs selector_or_function: String -- Selector or JS function
+  # @rbs return: Puppeteer::Locator -- Locator for selector or function
+  def locator: (String selector_or_function) -> Puppeteer::Locator
+
   # @rbs return: bool -- Whether this is an OOPIF frame
   def oop_frame?: () -> bool
 

data/sig/puppeteer/locators.rbs

@@ -0,0 +1,222 @@
+# Generated from lib/puppeteer/locators.rb with RBS::Inline
+
+module Puppeteer
+  module LocatorEvent
+    Action: ::String
+  end
+end
+
+class Puppeteer::Locator
+  include Puppeteer::EventCallbackable
+
+  RETRY_DELAY_SECONDS: ::Float
+
+  class TimeoutController
+    def initialize: (untyped timeout) -> untyped
+
+    attr_reader timeout: untyped
+
+    def remaining_timeout: () -> untyped
+
+    def exceeded?: () -> untyped
+
+    def check!: (?untyped cause) -> untyped
+  end
+
+  def initialize: () -> untyped
+
+  # @rbs locators: Array[Puppeteer::Locator] -- Locator candidates
+  # @rbs return: Puppeteer::Locator -- Locator that races candidates
+  def self.race: (Array[Puppeteer::Locator] locators) -> Puppeteer::Locator
+
+  # @rbs input: String -- Input string to check
+  # @rbs return: bool -- Whether string looks like a JS function
+  def self.function_string?: (String input) -> bool
+
+  # @rbs return: Numeric -- Timeout in milliseconds
+  def timeout: () -> Numeric
+
+  # @rbs timeout: Numeric -- Timeout in milliseconds
+  # @rbs return: Puppeteer::Locator -- Updated locator
+  def set_timeout: (Numeric timeout) -> Puppeteer::Locator
+
+  # @rbs visibility: String? -- 'visible', 'hidden', or nil
+  # @rbs return: Puppeteer::Locator -- Updated locator
+  def set_visibility: (String? visibility) -> Puppeteer::Locator
+
+  # @rbs value: bool -- Whether to wait for enabled state
+  # @rbs return: Puppeteer::Locator -- Updated locator
+  def set_wait_for_enabled: (bool value) -> Puppeteer::Locator
+
+  # @rbs value: bool -- Whether to ensure element is in viewport
+  # @rbs return: Puppeteer::Locator -- Updated locator
+  def set_ensure_element_is_in_the_viewport: (bool value) -> Puppeteer::Locator
+
+  # @rbs value: bool -- Whether to wait for stable bounding box
+  # @rbs return: Puppeteer::Locator -- Updated locator
+  def set_wait_for_stable_bounding_box: (bool value) -> Puppeteer::Locator
+
+  # @rbs locator: Puppeteer::Locator -- Locator to copy options from
+  # @rbs return: self -- Locator with copied options
+  def copy_options: (Puppeteer::Locator locator) -> self
+
+  # @rbs return: Puppeteer::Locator -- Cloned locator
+  def clone: (?freeze: untyped) -> Puppeteer::Locator
+
+  # @rbs return: Puppeteer::JSHandle -- Handle for located value
+  def wait_handle: () -> Puppeteer::JSHandle
+
+  # @rbs return: untyped -- JSON-serializable value
+  def wait: () -> untyped
+
+  # @rbs mapper: String -- JS mapper function
+  # @rbs return: Puppeteer::Locator -- Mapped locator
+  def map: (String mapper) -> Puppeteer::Locator
+
+  # @rbs predicate: String -- JS predicate function
+  # @rbs return: Puppeteer::Locator -- Filtered locator
+  def filter: (String predicate) -> Puppeteer::Locator
+
+  # @rbs predicate: Proc -- Handle predicate
+  # @rbs return: Puppeteer::Locator -- Filtered locator
+  def filter_handle: (Proc predicate) -> Puppeteer::Locator
+
+  # @rbs mapper: Proc -- Handle mapper
+  # @rbs return: Puppeteer::Locator -- Mapped locator
+  def map_handle: (Proc mapper) -> Puppeteer::Locator
+
+  # @rbs delay: Numeric? -- Delay between down and up (ms)
+  # @rbs button: String? -- Mouse button
+  # @rbs click_count: Integer? -- Deprecated click count
+  # @rbs count: Integer? -- Number of clicks
+  # @rbs offset: Hash[Symbol, Numeric]? -- Click offset
+  # @rbs return: void -- No return value
+  def click: (?delay: Numeric?, ?button: String?, ?click_count: Integer?, ?count: Integer?, ?offset: Hash[Symbol, Numeric]?) -> void
+
+  # @rbs value: String -- Value to fill
+  # @rbs return: void -- No return value
+  def fill: (String value) -> void
+
+  # @rbs return: void -- No return value
+  def hover: () -> void
+
+  # @rbs scroll_top: Numeric? -- Scroll top position
+  # @rbs scroll_left: Numeric? -- Scroll left position
+  # @rbs return: void -- No return value
+  def scroll: (?scroll_top: Numeric?, ?scroll_left: Numeric?) -> void
+
+  # @rbs event_name: String -- Event name
+  # @rbs block: Proc -- Event handler
+  # @rbs return: Puppeteer::Locator -- Locator for chaining
+  def on: (String event_name) ?{ (?) -> untyped } -> Puppeteer::Locator
+
+  # @rbs event_name: String -- Event name
+  # @rbs block: Proc -- Event handler
+  # @rbs return: Puppeteer::Locator -- Locator for chaining
+  def once: (String event_name) ?{ (?) -> untyped } -> Puppeteer::Locator
+
+  def _clone: () -> untyped
+
+  def _wait: (untyped _options) -> untyped
+
+  private def perform_action: (untyped name, conditions: untyped) ?{ (?) -> untyped } -> untyped
+
+  private def with_retry: (untyped _name) ?{ (?) -> untyped } -> untyped
+
+  private def build_action_options: (untyped timeout_controller) -> untyped
+
+  private def run_conditions: (untyped handle, untyped options, untyped conditions) -> untyped
+
+  private def wait_for_enabled_if_needed: (untyped handle, untyped options) -> untyped
+
+  private def wait_for_stable_bounding_box_if_needed: (untyped handle, untyped options) -> untyped
+
+  private def ensure_element_is_in_viewport_if_needed: (untyped handle, untyped options) -> untyped
+
+  private def fill_element: (untyped handle, untyped value) -> untyped
+end
+
+class Puppeteer::FunctionLocator < Puppeteer::Locator
+  # @rbs page_or_frame: Puppeteer::Page | Puppeteer::Frame -- Page or frame
+  # @rbs func: String -- JS function to evaluate
+  # @rbs return: Puppeteer::Locator -- Function locator
+  def self.create: (Puppeteer::Page | Puppeteer::Frame page_or_frame, String func) -> Puppeteer::Locator
+
+  def initialize: (untyped page_or_frame, untyped func) -> untyped
+
+  def _clone: () -> untyped
+
+  def _wait: (untyped options) -> untyped
+
+  def self.default_timeout_for: (untyped page_or_frame) -> untyped
+end
+
+class Puppeteer::DelegatedLocator < Puppeteer::Locator
+  def initialize: (untyped delegate) -> untyped
+
+  def delegate: () -> untyped
+
+  def set_timeout: (untyped timeout) -> untyped
+
+  def set_visibility: (untyped visibility) -> untyped
+
+  def set_wait_for_enabled: (untyped value) -> untyped
+
+  def set_ensure_element_is_in_the_viewport: (untyped value) -> untyped
+
+  def set_wait_for_stable_bounding_box: (untyped value) -> untyped
+
+  def _clone: () -> untyped
+
+  def _wait: (untyped _options) -> untyped
+end
+
+class Puppeteer::FilteredLocator < Puppeteer::DelegatedLocator
+  def initialize: (untyped base, untyped predicate) -> untyped
+
+  def _clone: () -> untyped
+
+  def _wait: (untyped options) -> untyped
+end
+
+class Puppeteer::MappedLocator < Puppeteer::DelegatedLocator
+  def initialize: (untyped base, untyped mapper) -> untyped
+
+  def _clone: () -> untyped
+
+  def _wait: (untyped options) -> untyped
+end
+
+class Puppeteer::NodeLocator < Puppeteer::Locator
+  # @rbs page_or_frame: Puppeteer::Page | Puppeteer::Frame -- Page or frame
+  # @rbs selector: String -- Selector
+  # @rbs return: Puppeteer::Locator -- Node locator
+  def self.create: (Puppeteer::Page | Puppeteer::Frame page_or_frame, String selector) -> Puppeteer::Locator
+
+  # @rbs page_or_frame: Puppeteer::Page | Puppeteer::Frame -- Page or frame
+  # @rbs handle: Puppeteer::ElementHandle -- Element handle
+  # @rbs return: Puppeteer::Locator -- Node locator
+  def self.create_from_handle: (Puppeteer::Page | Puppeteer::Frame page_or_frame, Puppeteer::ElementHandle handle) -> Puppeteer::Locator
+
+  def initialize: (untyped page_or_frame, untyped selector_or_handle) -> untyped
+
+  def _clone: () -> untyped
+
+  def _wait: (untyped options) -> untyped
+
+  private def wait_for_visibility_if_needed: (untyped handle, untyped options) -> untyped
+
+  def self.default_timeout_for: (untyped page_or_frame) -> untyped
+end
+
+class Puppeteer::RaceLocator < Puppeteer::Locator
+  def self.create: (untyped locators) -> untyped
+
+  def initialize: (untyped locators) -> untyped
+
+  def _clone: () -> untyped
+
+  def _wait: (untyped options) -> untyped
+
+  def self.check_locator_array: (untyped locators) -> untyped
+end

data/sig/puppeteer/p_query_handler.rbs

@@ -0,0 +1,73 @@
+# Generated from lib/puppeteer/p_query_handler.rb with RBS::Inline
+
+class Puppeteer::PQueryHandler
+  POLLING_DEFAULT_SECONDS: ::Float
+
+  CSS_QUERY_SELECTOR_JS: ::String
+
+  PIERCE_JS: ::String
+
+  PIERCE_ALL_JS: ::String
+
+  DOM_SORT_JS: ::String
+
+  # @rbs query_handler_manager: untyped -- Query handler manager
+  # @rbs return: void -- No return value
+  def initialize: (?query_handler_manager: untyped) -> void
+
+  # @rbs element: Puppeteer::ElementHandle -- Root element
+  # @rbs selector: String -- PSelector string
+  # @rbs return: Puppeteer::ElementHandle? -- First matching element
+  def query_one: (Puppeteer::ElementHandle element, String selector) -> Puppeteer::ElementHandle?
+
+  # @rbs element: Puppeteer::ElementHandle -- Root element
+  # @rbs selector: String -- PSelector string
+  # @rbs return: Array[Puppeteer::ElementHandle] -- Matching elements
+  def query_all: (Puppeteer::ElementHandle element, String selector) -> Array[Puppeteer::ElementHandle]
+
+  # @rbs element: Puppeteer::ElementHandle -- Root element
+  # @rbs selector: String -- PSelector string
+  # @rbs return: Puppeteer::JSHandle -- Handle to array of elements
+  def query_all_array: (Puppeteer::ElementHandle element, String selector) -> Puppeteer::JSHandle
+
+  # @rbs element_or_frame: Puppeteer::ElementHandle | Puppeteer::Frame -- Root element or frame
+  # @rbs selector: String -- PSelector string
+  # @rbs visible: bool? -- Wait for element to be visible
+  # @rbs hidden: bool? -- Wait for element to be hidden
+  # @rbs timeout: Numeric? -- Timeout in milliseconds
+  # @rbs polling: (String | Numeric | nil) -- Polling strategy
+  # @rbs return: Puppeteer::ElementHandle? -- Matching element
+  def wait_for: (Puppeteer::ElementHandle | Puppeteer::Frame element_or_frame, String selector, visible: bool?, hidden: bool?, timeout: Numeric?, ?polling: String | Numeric | nil) -> Puppeteer::ElementHandle?
+
+  private
+
+  def run_complex_selector: (untyped root, untyped complex) -> untyped
+
+  def apply_compound: (untyped elements, untyped compound) -> untyped
+
+  def apply_css_selector: (untyped elements, untyped selector) -> untyped
+
+  def query_css_selector: (untyped element, untyped selector) -> untyped
+
+  def apply_pseudo_selector: (untyped elements, untyped pseudo) -> untyped
+
+  def query_handler_for_pseudo: (untyped name) -> untyped
+
+  def pierce: (untyped elements) -> untyped
+
+  def pierce_all: (untyped elements) -> untyped
+
+  def dom_sort: (untyped elements) -> untyped
+
+  def array_handle_to_elements: (untyped array_handle) -> untyped
+
+  def ensure_context: (untyped handle, untyped context) -> untyped
+
+  def transfer_handle: (untyped frame, untyped handle) -> untyped
+
+  def polling_interval_seconds: (untyped polling, visible: untyped, hidden: untyped) -> untyped
+
+  def monotonic_time: () -> untyped
+
+  def raise_timeout: (untyped selector) -> untyped
+end

data/sig/puppeteer/p_selector_parser.rbs

@@ -0,0 +1,31 @@
+# Generated from lib/puppeteer/p_selector_parser.rb with RBS::Inline
+
+module Puppeteer
+  module PSelectorParser
+    class PseudoSelector
+      attr_reader name: untyped
+
+      attr_reader value: untyped
+
+      def initialize: (name: untyped, value: untyped) -> untyped
+    end
+
+    PSEUDO_PREFIX: ::String
+
+    # @rbs selector: String -- Selector to parse
+    # @rbs return: [Array[untyped], bool, bool, bool] -- Parsed selectors and flags
+    def self.parse: (String selector) -> [ Array[untyped], bool, bool, bool ]
+
+    def self.flush_storage: (untyped storage, untyped compound) -> untyped
+
+    def self.parse_name: (untyped selector, untyped index) -> untyped
+
+    def self.skip_spaces: (untyped selector, untyped index) -> untyped
+
+    def self.parse_argument: (untyped selector, untyped index) -> untyped
+
+    def self.starts_with_at?: (untyped selector, untyped index, untyped token) -> untyped
+
+    def self.unquote: (untyped text) -> untyped
+  end
+end

data/sig/puppeteer/page.rbs

@@ -138,6 +138,13 @@ class Puppeteer::Page
   # @rbs return: void -- No return value
   def default_timeout=: (Numeric? timeout) -> void
 
+  # @rbs return: Numeric -- Default timeout in milliseconds
+  def default_timeout: () -> Numeric
+
+  # @rbs selector_or_function: String -- Selector or JS function
+  # @rbs return: Puppeteer::Locator -- Locator for selector or function
+  def locator: (String selector_or_function) -> Puppeteer::Locator
+
   # `$()` in JavaScript.
   # @rbs selector: String -- CSS selector
   # @rbs return: Puppeteer::ElementHandle? -- Matching element or nil

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puppeteer-ruby
 version: !ruby/object:Gem::Version
-  version: 0.50.0.alpha5
+  version: 0.50.0.alpha6
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-22 00:00:00.000000000 Z
+date: 2026-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -360,11 +360,14 @@ files:
 - lib/puppeteer/launcher/chrome_arg_options.rb
 - lib/puppeteer/launcher/launch_options.rb
 - lib/puppeteer/lifecycle_watcher.rb
+- lib/puppeteer/locators.rb
 - lib/puppeteer/mouse.rb
 - lib/puppeteer/network_condition.rb
 - lib/puppeteer/network_conditions.rb
 - lib/puppeteer/network_event_manager.rb
 - lib/puppeteer/network_manager.rb
+- lib/puppeteer/p_query_handler.rb
+- lib/puppeteer/p_selector_parser.rb
 - lib/puppeteer/page.rb
 - lib/puppeteer/page/metrics.rb
 - lib/puppeteer/page/pdf_options.rb
@@ -402,7 +405,10 @@ files:
 - sig/puppeteer/http_response.rbs
 - sig/puppeteer/js_handle.rbs
 - sig/puppeteer/keyboard.rbs
+- sig/puppeteer/locators.rbs
 - sig/puppeteer/mouse.rbs
+- sig/puppeteer/p_query_handler.rbs
+- sig/puppeteer/p_selector_parser.rbs
 - sig/puppeteer/page.rbs
 - sig/puppeteer/puppeteer.rbs
 - sig/puppeteer/remote_object.rbs