playwright-ruby-client 1.42.0 → 1.43.0

data/lib/playwright/channel_owners/browser_context.rb

@@ -267,8 +267,37 @@ module Playwright
       @channel.send_message_to_server('addCookies', cookies: cookies)
     end
 
-    def clear_cookies
-      @channel.send_message_to_server('clearCookies')
+    def clear_cookies(domain: nil, name: nil, path: nil)
+      params = {}
+
+      case name
+      when String
+        params[:name] = name
+      when Regexp
+        regex = JavaScript::Regex.new(name)
+        params[:nameRegexSource] = regex.source
+        params[:nameRegexFlags] = regex.flag
+      end
+
+      case domain
+      when String
+        params[:domain] = domain
+      when Regexp
+        regex = JavaScript::Regex.new(domain)
+        params[:domainRegexSource] = regex.source
+        params[:domainRegexFlags] = regex.flag
+      end
+
+      case path
+      when String
+        params[:path] = path
+      when Regexp
+        regex = JavaScript::Regex.new(path)
+        params[:pathRegexSource] = regex.source
+        params[:pathRegexFlags] = regex.flag
+      end
+
+      @channel.send_message_to_server('clearCookies', params)
     end
 
     def grant_permissions(permissions, origin: nil)

data/lib/playwright/channel_owners/js_handle.rb

@@ -1,5 +1,7 @@
 module Playwright
   define_channel_owner :JSHandle do
+    include Utils::Errors::TargetClosedErrorMethods
+
     private def after_initialize
       @preview = @initializer['preview']
       @channel.on('previewUpdated', method(:on_preview_updated))
@@ -37,6 +39,8 @@ module Playwright
 
     def dispose
       @channel.send_message_to_server('dispose')
+    rescue => err
+      raise if !target_closed_error?(err)
     end
 
     def json_value

data/lib/playwright/channel_owners/request.rb

@@ -62,7 +62,7 @@ module Playwright
       content_type = headers['content-type']
       return unless content_type
 
-      if content_type == "application/x-www-form-urlencoded"
+      if content_type.include?("application/x-www-form-urlencoded")
         URI.decode_www_form(data).to_h
       else
         JSON.parse(data)

data/lib/playwright/connection.rb

@@ -16,6 +16,9 @@ module Playwright
         end
         raise ::Playwright::DriverCrashedError.new
       end
+      @transport.on_driver_closed do
+        cleanup
+      end
 
       @objects = {} # Hash[ guid => ChannelOwner ]
       @waiting_for_object = {} # Hash[ guid => Promise<ChannelOwner> ]

data/lib/playwright/frame_locator_impl.rb

@@ -26,6 +26,14 @@ module Playwright
         hasText: hasText)
     end
 
+    def owner
+      LocatorImpl.new(
+        frame: @frame,
+        timeout_settings: @timeout_settings,
+        selector: @frame_selector,
+      )
+    end
+
     def frame_locator(selector)
       FrameLocatorImpl.new(
         frame: @frame,

data/lib/playwright/locator_impl.rb

@@ -233,6 +233,14 @@ module Playwright
       @frame.query_selector_all(@selector)
     end
 
+    def content_frame
+      FrameLocatorImpl.new(
+        frame: @frame,
+        timeout_settings: @timeout_settings,
+        frame_selector: @selector,
+      )
+    end
+
     def filter(has: nil, hasNot: nil, hasNotText: nil, hasText: nil)
       LocatorImpl.new(
         frame: @frame,

data/lib/playwright/transport.rb

@@ -18,6 +18,10 @@ module Playwright
       @on_message = block
     end
 
+    def on_driver_closed(&block)
+      @on_driver_closed = block
+    end
+
     def on_driver_crashed(&block)
       @on_driver_crashed = block
     end
@@ -83,6 +87,7 @@ module Playwright
       end
     rescue IOError
       # disconnected by remote.
+      @on_driver_closed&.call
     end
 
     def handle_stderr
@@ -106,6 +111,7 @@ module Playwright
       end
     rescue IOError
       # disconnected by remote.
+      @on_driver_closed&.call
     end
 
     def debug_send_message(message)

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '1.42.0'
-  COMPATIBLE_PLAYWRIGHT_VERSION = '1.42.0'
+  VERSION = '1.43.0'
+  COMPATIBLE_PLAYWRIGHT_VERSION = '1.43.1'
 end

data/lib/playwright/waiter.rb

@@ -81,19 +81,17 @@ module Playwright
 
     private def fulfill(result)
       cleanup
-      unless @result.resolved?
-        @result.fulfill(result)
-      end
+      return if @result.resolved?
+      @result.fulfill(result)
       wait_for_event_info_after
     end
 
     private def reject(error)
       cleanup
+      return if @result.resolved?
       klass = error.is_a?(TimeoutError) ? TimeoutError : Error
       ex = klass.new(message: "#{error.message}#{format_log_recording(@logs)}")
-      unless @result.resolved?
-        @result.reject(ex)
-      end
+      @result.reject(ex)
       wait_for_event_info_after(error: ex)
     end
 

data/lib/playwright/web_socket_transport.rb

@@ -15,6 +15,10 @@ module Playwright
       @on_message = block
     end
 
+    def on_driver_closed(&block)
+      @on_driver_closed = block
+    end
+
     def on_driver_crashed(&block)
       @on_driver_crashed = block
     end
@@ -76,6 +80,10 @@ module Playwright
 
       ws.start
       @ws = promise.value!
+      @ws.on_close do |reason, code|
+        puts "[WebSocketTransport] closed with code: #{code}, reason: #{reason}"
+        @on_driver_closed&.call(reason, code)
+      end
       @ws.on_error do |error|
         puts "[WebSocketTransport] error: #{error}"
         @on_driver_crashed&.call

data/lib/playwright.rb

@@ -181,7 +181,7 @@ module Playwright
 
     # Connects to Playwright server, launched by `npx playwright launch-server chromium` or `playwright.chromium.launchServer()`
   #
-  # Playwright.connect_to_browser_server('ws://....') do |browser|
+  # Playwright.connect_to_android_server('ws://....') do |browser|
   #   page = browser.new_page
   #   ...
   # end

data/lib/playwright_api/android.rb

@@ -40,20 +40,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/android_device.rb

@@ -205,20 +205,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/api_request_context.rb

@@ -280,20 +280,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/browser.rb

@@ -202,20 +202,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/browser_context.rb

@@ -81,9 +81,19 @@ module Playwright
     end
 
     #
-    # Clears context cookies.
-    def clear_cookies
-      wrap_impl(@impl.clear_cookies)
+    # Removes cookies from context. Accepts optional filter.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # context.clear_cookies()
+    # context.clear_cookies(name="session-id")
+    # context.clear_cookies(domain="my-origin.com")
+    # context.clear_cookies(path="/api/v1")
+    # context.clear_cookies(name="session-id", domain="my-origin.com")
+    # ```
+    def clear_cookies(domain: nil, name: nil, path: nil)
+      wrap_impl(@impl.clear_cookies(domain: unwrap_impl(domain), name: unwrap_impl(name), path: unwrap_impl(path)))
     end
 
     #
@@ -438,6 +448,11 @@ module Playwright
       raise NotImplementedError.new('wait_for_event is not implemented yet.')
     end
 
+    # @nodoc
+    def owner_page=(req)
+      wrap_impl(@impl.owner_page=(unwrap_impl(req)))
+    end
+
     # @nodoc
     def pause
       wrap_impl(@impl.pause)
@@ -448,11 +463,6 @@ module Playwright
       wrap_impl(@impl.options=(unwrap_impl(req)))
     end
 
-    # @nodoc
-    def owner_page=(req)
-      wrap_impl(@impl.owner_page=(unwrap_impl(req)))
-    end
-
     # @nodoc
     def enable_debug_console!
       wrap_impl(@impl.enable_debug_console!)
@@ -465,20 +475,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/browser_type.rb

@@ -176,20 +176,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/cdp_session.rb

@@ -34,20 +34,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/dialog.rb

@@ -70,20 +70,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/element_handle.rb

@@ -575,20 +575,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/frame.rb

@@ -1049,20 +1049,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/frame_locator.rb

@@ -21,11 +21,11 @@ module Playwright
   #
   # **Converting Locator to FrameLocator**
   #
-  # If you have a `Locator` object pointing to an `iframe` it can be converted to `FrameLocator` using [`:scope`](https://developer.mozilla.org/en-US/docs/Web/CSS/:scope) CSS selector:
+  # If you have a `Locator` object pointing to an `iframe` it can be converted to `FrameLocator` using [`method: Locator.contentFrame`].
   #
-  # ```python sync
-  # frameLocator = locator.frame_locator(":scope")
-  # ```
+  # **Converting FrameLocator to Locator**
+  #
+  # If you have a `FrameLocator` object it can be converted to `Locator` pointing to the same `iframe` using [`method: FrameLocator.owner`].
   class FrameLocator < PlaywrightApi
 
     #
@@ -255,5 +255,24 @@ module Playwright
     def nth(index)
       wrap_impl(@impl.nth(unwrap_impl(index)))
     end
+
+    #
+    # Returns a `Locator` object pointing to the same `iframe` as this frame locator.
+    #
+    # Useful when you have a `FrameLocator` object obtained somewhere, and later on would like to interact with the `iframe` element.
+    #
+    # For a reverse operation, use [`method: Locator.contentFrame`].
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # frame_locator = page.frame_locator("iframe[name=\"embedded\"]")
+    # # ...
+    # locator = frame_locator.owner
+    # expect(locator).to_be_visible()
+    # ```
+    def owner
+      wrap_impl(@impl.owner)
+    end
   end
 end

data/lib/playwright_api/js_handle.rb

@@ -100,20 +100,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/locator.rb

@@ -325,6 +325,25 @@ module Playwright
       wrap_impl(@impl.element_handles)
     end
 
+    #
+    # Returns a `FrameLocator` object pointing to the same `iframe` as this locator.
+    #
+    # Useful when you have a `Locator` object obtained somewhere, and later on would like to interact with the content inside the frame.
+    #
+    # For a reverse operation, use [`method: FrameLocator.owner`].
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # locator = page.locator("iframe[name=\"embedded\"]")
+    # # ...
+    # frame_locator = locator.content_frame
+    # frame_locator.get_by_role("button").click()
+    # ```
+    def content_frame
+      wrap_impl(@impl.content_frame)
+    end
+
     #
     # Execute JavaScript code in the page, taking the matching element as an argument.
     #