playwright-ruby-client 1.44.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c83d71803d132d79217392a22bcbad5de47673f738badf76692ff178e4ddd27
-  data.tar.gz: 4d25cd84f28d6028f6335b89e4c0324847b3077004e6b21ffb6ed9740cd6ec91
+  metadata.gz: 61d1fe5862b1d039cee887b00ac4f561c4d1158d21e582262738bcabe6c5614b
+  data.tar.gz: 5041a590c2d79d0b6885b140be6ef581e7d50f52ca44cb7b975999cb70c4eacb
 SHA512:
-  metadata.gz: 899c0d792c8021c4560240d9b61ca57b300519f5b2786f58406d65fcb44eb70301d474217c85ec710036c3eeff3119388bbe7255d5f3e6bdbe3debcc0ef425a0
-  data.tar.gz: 0ca7408e7e43818d7afb4660fb6c8df219eeb386f244c9cde5895cad7fa2c3f9ef26d90f99b86c7c937071cb7c66be6db631ecd883186c43064be6501e793fe6
+  metadata.gz: c4bed1453a41a06716fa4df121cdbbec291bd9a0338993c90a2961745fdebb0c3ba09a160179a4b649b8342adbd83f95193639764ac75600cf0dc7be11ff833b
+  data.tar.gz: f2ed6829ad907d3a9862ba0be498348e834c46fa7ab352b50da81ef29d68ce6a2ecac7f6e003b20a58abae6d69e14a2391d7825326ad17c614032f118b7a8410

data/documentation/docs/api/api_request_context.md

@@ -81,7 +81,7 @@ context cookies from the response. The method will automatically follow redirect
 ## dispose
 
 ```
-def dispose
+def dispose(reason: nil)
 ```
 
 

data/documentation/docs/api/browser_context.md

@@ -185,29 +185,6 @@ HTML
 page.get_by_role("button").click
 ```
 
-An example of passing an element handle:
-
-```ruby
-def print_text(source, element)
-  element.text_content
-end
-
-browser_context.expose_binding("clicked", method(:print_text), handle: true)
-page = browser_context.new_page
-
-page.content = <<~HTML
-<script>
-  document.addEventListener('click', async (event) => {
-    alert(await window.clicked(event.target));
-  })
-</script>
-<div>Click me</div>
-<div>Or click me</div>
-HTML
-
-page.locator('div').first.click
-```
-
 ## expose_function
 
 ```
@@ -510,6 +487,11 @@ Performs action and waits for a new [Page](./page) to be created in the context.
 [Page](./page) value into the `predicate` function and waits for `predicate(event)` to return a truthy value.
 Will throw an error if the context closes before new [Page](./page) is created.
 
+## clock
+
+
+Playwright has ability to mock clock and passage of time.
+
 ## request
 
 

data/documentation/docs/api/clock.md

@@ -0,0 +1,142 @@
+---
+sidebar_position: 10
+---
+
+# Clock
+
+
+Accurately simulating time-dependent behavior is essential for verifying the correctness of applications. Learn more about [clock emulation](https://playwright.dev/python/docs/clock).
+
+Note that clock is installed for the entire [BrowserContext](./browser_context), so the time
+in all the pages and iframes is controlled by the same clock.
+
+## fast_forward
+
+```
+def fast_forward(ticks)
+```
+
+
+Advance the clock by jumping forward in time. Only fires due timers at most once. This is equivalent to user closing the laptop lid for a while and
+reopening it later, after given time.
+
+**Usage**
+
+```ruby
+page.clock.fast_forward(1000)
+page.clock.fast_forward("30:00")
+```
+
+## install
+
+```
+def install(time: nil)
+```
+
+
+Install fake implementations for the following time-related functions:
+- `Date`
+- `setTimeout`
+- `clearTimeout`
+- `setInterval`
+- `clearInterval`
+- `requestAnimationFrame`
+- `cancelAnimationFrame`
+- `requestIdleCallback`
+- `cancelIdleCallback`
+- `performance`
+
+Fake timers are used to manually control the flow of time in tests. They allow you to advance time, fire timers, and control the behavior of time-dependent functions. See [Clock#run_for](./clock#run_for) and [Clock#fast_forward](./clock#fast_forward) for more information.
+
+## run_for
+
+```
+def run_for(ticks)
+```
+
+
+Advance the clock, firing all the time-related callbacks.
+
+**Usage**
+
+```ruby
+page.clock.run_for(1000)
+page.clock.run_for("30:00")
+```
+
+## pause_at
+
+```
+def pause_at(time)
+```
+
+
+Advance the clock by jumping forward in time and pause the time. Once this method is called, no timers
+are fired unless [Clock#run_for](./clock#run_for), [Clock#fast_forward](./clock#fast_forward), [Clock#pause_at](./clock#pause_at) or [Clock#resume](./clock#resume) is called.
+
+Only fires due timers at most once.
+This is equivalent to user closing the laptop lid for a while and reopening it at the specified time and
+pausing.
+
+**Usage**
+
+```ruby
+page.clock.pause_at(Time.parse("2020-02-02"))
+page.clock.pause_at("2020-02-02")
+```
+
+## resume
+
+```
+def resume
+```
+
+
+Resumes timers. Once this method is called, time resumes flowing, timers are fired as usual.
+
+## set_fixed_time
+
+```
+def set_fixed_time(time)
+```
+alias: `fixed_time=`
+
+
+Makes `Date.now` and `new Date()` return fixed fake time at all times,
+keeps all the timers running.
+
+**Usage**
+
+```ruby
+page.clock.set_fixed_time(Time.now)
+page.clock.set_fixed_time(Time.parse("2020-02-02"))
+page.clock.set_fixed_time("2020-02-02")
+
+# or we can use the alias
+page.clock.fixed_time = Time.now
+page.clock.fixed_time = Time.parse("2020-02-02")
+page.clock.fixed_time = "2020-02-02"
+```
+
+## set_system_time
+
+```
+def set_system_time(time)
+```
+alias: `system_time=`
+
+
+Sets current system time but does not trigger any timers.
+
+**Usage**
+
+```ruby
+page.clock.set_system_time(Time.now)
+page.clock.set_system_time(Time.parse("2020-02-02"))
+page.clock.set_system_time("2020-02-02")
+
+# or we can use the alias
+page.clock.system_time = Time.now
+page.clock.system_time = Time.parse("2020-02-02")
+page.clock.system_time = "2020-02-02"
+```

data/documentation/docs/api/console_message.md

@@ -6,7 +6,7 @@ sidebar_position: 10
 
 
 [ConsoleMessage](./console_message) objects are dispatched by page via the [`event: Page.console`] event.
-For each console messages logged in the page there will be corresponding event in the Playwright
+For each console message logged in the page there will be corresponding event in the Playwright
 context.
 
 ```ruby

data/documentation/docs/api/element_handle.md

@@ -485,6 +485,8 @@ completely visible as defined by
 Throws when `elementHandle` does not point to an element
 [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
 
+See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
+
 ## select_option
 
 ```
@@ -566,6 +568,7 @@ alias: `input_files=`
 
 Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
 are resolved relative to the current working directory. For empty array, clears the selected files.
+For inputs with a `[webkitdirectory]` attribute, only a single directory path is supported.
 
 This method expects [ElementHandle](./element_handle) to point to an
 [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the `<label>` element that has an associated [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.

data/documentation/docs/api/locator.md

@@ -1162,6 +1162,8 @@ This method waits for [actionability](https://playwright.dev/python/docs/actiona
 completely visible as defined by
 [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
 
+See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
+
 ## select_option
 
 ```
@@ -1265,6 +1267,7 @@ alias: `input_files=`
 
 
 Upload file or multiple files into `<input type=file>`.
+For inputs with a `[webkitdirectory]` attribute, only a single directory path is supported.
 
 **Usage**
 
@@ -1275,6 +1278,9 @@ page.get_by_label("Upload file").set_input_files('myfile.pdf')
 # Select multiple files
 page.get_by_label("Upload files").set_input_files(['file1.txt', 'file2.txt'])
 
+# Select a directory
+page.get_by_label("Upload directory").set_input_files('mydir')
+
 # Remove all the selected files
 page.get_by_label("Upload file").set_input_files([])
 ```

data/documentation/docs/api/locator_assertions.md

@@ -200,7 +200,7 @@ The opposite of [LocatorAssertions#to_have_js_property](./locator_assertions#to_
 ## not_to_have_role
 
 ```ruby
-expect(locator).not_to have_role(name, timeout: nil)
+expect(locator).not_to have_role(role, timeout: nil)
 ```
 
 

data/documentation/docs/api/mouse.md

@@ -78,7 +78,7 @@ def wheel(deltaX, deltaY)
 ```
 
 
-Dispatches a `wheel` event.
+Dispatches a `wheel` event. This method is usually used to manually scroll the page. See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
 
 **NOTE**: Wheel events may cause scrolling if they are not handled, and this method does not
 wait for the scrolling to finish before returning.

data/documentation/docs/api/page.md

@@ -479,27 +479,6 @@ HTML
 page.click("button")
 ```
 
-An example of passing an element handle:
-
-```ruby
-def print_text(source, element)
-  element.text_content
-end
-
-page.expose_binding("clicked", method(:print_text), handle: true)
-page.content = <<~HTML
-<script>
-  document.addEventListener('click', async (event) => {
-    alert(await window.clicked(event.target));
-  })
-</script>
-<div>Click me</div>
-<div>Or click me</div>
-HTML
-
-page.locator('div').first.click
-```
-
 ## expose_function
 
 ```
@@ -1438,6 +1417,7 @@ def set_input_files(
 
 Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
 are resolved relative to the current working directory. For empty array, clears the selected files.
+For inputs with a `[webkitdirectory]` attribute, only a single directory path is supported.
 
 This method expects `selector` to point to an
 [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the `<label>` element that has an associated [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
@@ -1910,6 +1890,11 @@ associated with the page.
 
 **NOTE**: This does not contain ServiceWorkers
 
+## clock
+
+
+Playwright has ability to mock clock and passage of time.
+
 ## accessibility
 
 ## keyboard

data/documentation/docs/api/page_assertions.md

@@ -28,7 +28,7 @@ The opposite of [PageAssertions#to_have_title](./page_assertions#to_have_title).
 ## not_to_have_url
 
 ```
-def not_to_have_url(urlOrRegExp, timeout: nil)
+def not_to_have_url(urlOrRegExp, ignoreCase: nil, timeout: nil)
 ```
 
 

data/documentation/docs/include/api_coverage.md

@@ -214,6 +214,16 @@
 * register
 * ~~set_test_id_attribute~~
 
+## Clock
+
+* fast_forward
+* install
+* run_for
+* pause_at
+* resume
+* set_fixed_time
+* set_system_time
+
 ## ConsoleMessage
 
 * args
@@ -340,6 +350,7 @@
 * expect_worker
 * workers
 * ~~wait_for_event~~
+* clock
 * accessibility
 * keyboard
 * mouse
@@ -377,6 +388,7 @@
 * expect_event
 * expect_page
 * ~~wait_for_event~~
+* clock
 * request
 * tracing
 

data/lib/playwright/channel_owners/api_request_context.rb

@@ -6,7 +6,8 @@ module Playwright
       @tracing = ChannelOwners::Tracing.from(@initializer['tracing'])
     end
 
-    def dispose
+    def dispose(reason: nil)
+      @close_reason = reason
       @channel.send_message_to_server('dispose')
     end
 
@@ -92,6 +93,9 @@ module Playwright
           multipart: nil,
           params: nil,
           timeout: nil)
+      if @close_reason
+        raise TargetClosedError.new(message: @close_reason)
+      end
       if [data, form, multipart].compact.count > 1
         raise ArgumentError.new("Only one of 'data', 'form' or 'multipart' can be specified")
       end

data/lib/playwright/channel_owners/browser_context.rb

@@ -5,7 +5,7 @@ module Playwright
 
     attr_accessor :browser
     attr_writer :owner_page, :options
-    attr_reader :tracing, :request
+    attr_reader :clock, :tracing, :request
 
     private def after_initialize
       if @parent.is_a?(ChannelOwners::Browser)
@@ -22,6 +22,7 @@ module Playwright
 
       @tracing = ChannelOwners::Tracing.from(@initializer['tracing'])
       @request = ChannelOwners::APIRequestContext.from(@initializer['requestContext'])
+      @clock = ClockImpl.new(self)
       @har_recorders = {}
 
       @channel.on('bindingCall', ->(params) { on_binding(ChannelOwners::BindingCall.from(params['binding'])) })
@@ -441,7 +442,7 @@ module Playwright
       return if @close_was_called
       @close_was_called = true
       @close_reason = reason
-
+      @request.dispose(reason: reason)
       inner_close
       @channel.send_message_to_server('close', { reason: reason }.compact)
       @closed_promise.value!
@@ -553,14 +554,65 @@ module Playwright
 
     # called from InputFiles
     # @param filepath [string]
-    # @return [WritableStream]
-    private def create_temp_file(filepath)
-      result = @channel.send_message_to_server(
-        'createTempFile',
-        name: File.basename(filepath),
-        lastModifiedMs: File.mtime(filepath).to_i * 1000,
-      )
-      ChannelOwners::WritableStream.from(result)
+    # @return [WritableStream, Array<WritableStream>]
+    private def create_temp_files(local_directory, files)
+      if local_directory
+        params = {
+          rootDirName: File.basename(local_directory),
+          items: files.map do |filepath|
+            {
+              name: Pathname.new(filepath).relative_path_from(Pathname.new(local_directory)).to_s,
+              lastModifiedMs: File.mtime(filepath).to_i * 1000,
+            }
+          end
+        }
+      else
+        params = {
+          items: files.map do |filepath|
+            {
+              name: File.basename(filepath),
+              lastModifiedMs: File.mtime(filepath).to_i * 1000,
+            }
+          end
+        }
+      end
+
+      result = @channel.send_message_to_server_result('createTempFiles', params)
+
+      [
+        ChannelOwners::WritableStream.from_nullable(result['rootDir']),
+        result['writableStreams'].map do |s|
+          ChannelOwners::WritableStream.from(s)
+        end,
+      ]
+    end
+
+    private def clock_fast_forward(ticks_params)
+      @channel.send_message_to_server('clockFastForward', ticks_params)
+    end
+
+    private def clock_install(time_params)
+      @channel.send_message_to_server('clockInstall', time_params)
+    end
+
+    private def clock_pause_at(time_params)
+      @channel.send_message_to_server('clockPauseAt', time_params)
+    end
+
+    private def clock_resume
+      @channel.send_message_to_server('clockResume')
+    end
+
+    private def clock_run_for(ticks_params)
+      @channel.send_message_to_server('clockRunFor', ticks_params)
+    end
+
+    private def clock_set_fixed_time(time_params)
+      @channel.send_message_to_server('clockSetFixedTime', time_params)
+    end
+
+    private def clock_set_system_time(time_params)
+      @channel.send_message_to_server('clockSetSystemTime', time_params)
     end
   end
 end

data/lib/playwright/channel_owners/page.rb

@@ -8,7 +8,6 @@ module Playwright
     include LocatorUtils
     attr_writer :owned_context
 
-
     private def after_initialize
       @browser_context = @parent
       @timeout_settings = TimeoutSettings.new(@browser_context.send(:_timeout_settings))
@@ -196,6 +195,10 @@ module Playwright
       @browser_context
     end
 
+    def clock
+      @browser_context.clock
+    end
+
     def opener
       if @opener&.closed?
         nil

data/lib/playwright/clock_impl.rb

@@ -0,0 +1,65 @@
+module Playwright
+  define_api_implementation :ClockImpl do
+    def initialize(browser_context)
+      @browser_context = browser_context
+    end
+
+    def install(time: nil)
+      if time
+        @browser_context.send(:clock_install, parse_time(time))
+      else
+        @browser_context.send(:clock_install, {})
+      end
+    end
+
+    def fast_forward(ticks)
+      @browser_context.send(:clock_fast_forward, parse_ticks(ticks))
+    end
+
+    def pause_at(time)
+      @browser_context.send(:clock_pause_at, parse_time(time))
+    end
+
+    def resume
+      @browser_context.send(:clock_resume)
+    end
+
+    def run_for(ticks)
+      @browser_context.send(:clock_run_for, parse_ticks(ticks))
+    end
+
+    def set_fixed_time(time)
+      @browser_context.send(:clock_set_fixed_time, parse_time(time))
+    end
+
+    def set_system_time(time)
+      @browser_context.send(:clock_set_system_time, parse_time(time))
+    end
+
+    private def parse_time(time)
+      case time
+      when Integer
+        { timeNumber: time }
+      when String
+        { timeString: time }
+      else
+        if time.respond_to?(:utc)
+          { timeNumber: time.utc.to_i }
+        else
+          raise ArgumentError.new('time must be either integer, string or a Time object')
+        end
+      end
+    end
+
+    private def parse_ticks(ticks)
+      case ticks
+      when Integer
+        { ticksNumber: ticks }
+      when String
+        { ticksString: ticks }
+      else
+        raise ArgumentError.new('ticks must be either integer or string')
+      end
+    end
+  end
+end

data/lib/playwright/input_files.rb

@@ -5,16 +5,17 @@ module Playwright
     def initialize(context, files)
       @context = context
       if files.is_a?(File)
-        @files = [files]
+        files_to_resolve = [files]
       elsif files.is_a?(Enumerable)
-        @files = files
+        files_to_resolve = files
       else
-        @files = [files]
+        files_to_resolve = [files]
       end
+      resolve_paths_and_directory_for_input_files(files_to_resolve)
     end
 
     def as_method_and_params
-      if has_large_file?
+      if @local_directory || has_large_file?
         ['setInputFiles', params_for_set_input_file_paths]
       else
         ['setInputFiles', params_for_set_input_files]
@@ -24,44 +25,86 @@ module Playwright
     private def has_large_file?
       max_bufsize = 1024 * 1024 # 1MB
 
-      @files.any? do |file|
+      @local_files.any? do |file|
         case file
         when String
           File::Stat.new(file).size > max_bufsize
         when File
           file.stat.size > max_bufsize
-        else
-          raise_argument_error
         end
       end
     end
 
-    private def params_for_set_input_file_paths
-      writable_streams = @files.map do |file|
-        case file
+    private def resolve_paths_and_directory_for_input_files(files)
+      # filter_map is not available in Ruby < 2.7
+      @local_files = files.map do |item|
+        case item
         when String
-          writable_stream = @context.send(:create_temp_file, file)
-
-          File.open(file, 'rb') do |file|
-            writable_stream.write(file)
+          if File.directory?(item)
+            raise ArgumentError.new('Multiple directories are not supported') if @local_directory
+            @local_directory = item
+            next
           end
 
-          writable_stream.channel
+          item
         when File
-          writable_stream = @context.send(:create_temp_file, file.path)
-          writable_stream.write(file)
+          if File.directory?(item.path)
+            raise ArgumentError.new('Multiple directories are not supported') if @local_directory
+            @local_directory = item
+            next
+          end
 
-          writable_stream.channel
+          item
         else
-          raise_argument_error
+          raise ArgumentError.new('file must be a String or File or Directory.')
         end
+      end.compact
+
+      if @local_directory && !@local_files.empty?
+        raise ArgumentError.new('File paths must be all files or a single directory')
       end
+    end
+
+    private def params_for_set_input_file_paths
+      if @local_directory
+        filenames = Dir["#{@local_directory}/**/*"].reject { |file| File.directory?(file) }
+        directory_stream, writable_streams = @context.send(:create_temp_files, @local_directory, filenames)
+
+        filenames.zip(writable_streams).each do |filename, writable_stream|
+          File.open(filename, 'rb') do |file|
+            writable_stream.write(file)
+          end
+        end
+
+        { directoryStream: directory_stream.channel }
+      else
+        filenames = @local_files.map do |file|
+          case file
+          when String
+            file
+          when File
+            file.path
+          end
+        end
 
-      { streams: writable_streams }
+        _, writable_streams = @context.send(:create_temp_files, nil, filenames)
+        @local_files.zip(writable_streams).each do |file, writable_stream|
+          case file
+          when String
+            File.open(file, 'rb') do |file|
+              writable_stream.write(file)
+            end
+          when File
+            writable_stream.write(file)
+          end
+        end
+
+        { streams: writable_streams.map(&:channel) }
+      end
     end
 
     private def params_for_set_input_files
-      file_payloads = @files.map do |file|
+      file_payloads = @local_files.map do |file|
         case file
         when String
           {
@@ -73,8 +116,6 @@ module Playwright
             name: File.basename(file.path),
             buffer: Base64.strict_encode64(file.read),
           }
-        else
-          raise_argument_error
         end
       end
 

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '1.44.0'
-  COMPATIBLE_PLAYWRIGHT_VERSION = '1.44.0'
+  VERSION = '1.45.0'
+  COMPATIBLE_PLAYWRIGHT_VERSION = '1.45.0'
 end

data/lib/playwright_api/api_request_context.rb

@@ -87,8 +87,8 @@ module Playwright
 
     #
     # All responses returned by [`method: APIRequestContext.get`] and similar methods are stored in the memory, so that you can later call [`method: APIResponse.body`].This method discards all its resources, calling any method on disposed `APIRequestContext` will throw an exception.
-    def dispose
-      wrap_impl(@impl.dispose)
+    def dispose(reason: nil)
+      wrap_impl(@impl.dispose(reason: unwrap_impl(reason)))
     end
 
     #

data/lib/playwright_api/browser.rb

@@ -45,9 +45,9 @@ module Playwright
     #
     # ```python sync
     # browser = pw.webkit.launch()
-    # print(len(browser.contexts())) # prints `0`
+    # print(len(browser.contexts)) # prints `0`
     # context = browser.new_context()
-    # print(len(browser.contexts())) # prints `1`
+    # print(len(browser.contexts)) # prints `1`
     # ```
     def contexts
       wrap_impl(@impl.contexts)

data/lib/playwright_api/browser_context.rb

@@ -20,6 +20,12 @@ module Playwright
   # ```
   class BrowserContext < PlaywrightApi
 
+    #
+    # Playwright has ability to mock clock and passage of time.
+    def clock # property
+      wrap_impl(@impl.clock)
+    end
+
     #
     # API testing helper associated with this context. Requests made with this API will use context cookies.
     def request # property
@@ -163,22 +169,6 @@ module Playwright
     # with sync_playwright() as playwright:
     #     run(playwright)
     # ```
-    #
-    # An example of passing an element handle:
-    #
-    # ```python sync
-    # def print(source, element):
-    #     print(element.text_content())
-    #
-    # context.expose_binding("clicked", print, handle=true)
-    # page.set_content("""
-    #   <script>
-    #     document.addEventListener('click', event => window.clicked(event.target));
-    #   </script>
-    #   <div>Click me</div>
-    #   <div>Or click me</div>
-    # """)
-    # ```
     def expose_binding(name, callback, handle: nil)
       wrap_impl(@impl.expose_binding(unwrap_impl(name), unwrap_impl(callback), handle: unwrap_impl(handle)))
     end

data/lib/playwright_api/clock.rb

@@ -0,0 +1,109 @@
+module Playwright
+  #
+  # Accurately simulating time-dependent behavior is essential for verifying the correctness of applications. Learn more about [clock emulation](../clock.md).
+  #
+  # Note that clock is installed for the entire `BrowserContext`, so the time
+  # in all the pages and iframes is controlled by the same clock.
+  class Clock < PlaywrightApi
+
+    #
+    # Advance the clock by jumping forward in time. Only fires due timers at most once. This is equivalent to user closing the laptop lid for a while and
+    # reopening it later, after given time.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # page.clock.fast_forward(1000)
+    # page.clock.fast_forward("30:00")
+    # ```
+    def fast_forward(ticks)
+      wrap_impl(@impl.fast_forward(unwrap_impl(ticks)))
+    end
+
+    #
+    # Install fake implementations for the following time-related functions:
+    # - `Date`
+    # - `setTimeout`
+    # - `clearTimeout`
+    # - `setInterval`
+    # - `clearInterval`
+    # - `requestAnimationFrame`
+    # - `cancelAnimationFrame`
+    # - `requestIdleCallback`
+    # - `cancelIdleCallback`
+    # - `performance`
+    #
+    # Fake timers are used to manually control the flow of time in tests. They allow you to advance time, fire timers, and control the behavior of time-dependent functions. See [`method: Clock.runFor`] and [`method: Clock.fastForward`] for more information.
+    def install(time: nil)
+      wrap_impl(@impl.install(time: unwrap_impl(time)))
+    end
+
+    #
+    # Advance the clock, firing all the time-related callbacks.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # page.clock.run_for(1000);
+    # page.clock.run_for("30:00")
+    # ```
+    def run_for(ticks)
+      wrap_impl(@impl.run_for(unwrap_impl(ticks)))
+    end
+
+    #
+    # Advance the clock by jumping forward in time and pause the time. Once this method is called, no timers
+    # are fired unless [`method: Clock.runFor`], [`method: Clock.fastForward`], [`method: Clock.pauseAt`] or [`method: Clock.resume`] is called.
+    #
+    # Only fires due timers at most once.
+    # This is equivalent to user closing the laptop lid for a while and reopening it at the specified time and
+    # pausing.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # page.clock.pause_at(datetime.datetime(2020, 2, 2))
+    # page.clock.pause_at("2020-02-02")
+    # ```
+    def pause_at(time)
+      wrap_impl(@impl.pause_at(unwrap_impl(time)))
+    end
+
+    #
+    # Resumes timers. Once this method is called, time resumes flowing, timers are fired as usual.
+    def resume
+      wrap_impl(@impl.resume)
+    end
+
+    #
+    # Makes `Date.now` and `new Date()` return fixed fake time at all times,
+    # keeps all the timers running.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # page.clock.set_fixed_time(datetime.datetime.now())
+    # page.clock.set_fixed_time(datetime.datetime(2020, 2, 2))
+    # page.clock.set_fixed_time("2020-02-02")
+    # ```
+    def set_fixed_time(time)
+      wrap_impl(@impl.set_fixed_time(unwrap_impl(time)))
+    end
+    alias_method :fixed_time=, :set_fixed_time
+
+    #
+    # Sets current system time but does not trigger any timers.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # page.clock.set_system_time(datetime.datetime.now())
+    # page.clock.set_system_time(datetime.datetime(2020, 2, 2))
+    # page.clock.set_system_time("2020-02-02")
+    # ```
+    def set_system_time(time)
+      wrap_impl(@impl.set_system_time(unwrap_impl(time)))
+    end
+    alias_method :system_time=, :set_system_time
+  end
+end

data/lib/playwright_api/console_message.rb

@@ -1,7 +1,7 @@
 module Playwright
   #
   # `ConsoleMessage` objects are dispatched by page via the [`event: Page.console`] event.
-  # For each console messages logged in the page there will be corresponding event in the Playwright
+  # For each console message logged in the page there will be corresponding event in the Playwright
   # context.
   #
   # ```python sync

data/lib/playwright_api/element_handle.rb

@@ -395,6 +395,8 @@ module Playwright
     #
     # Throws when `elementHandle` does not point to an element
     # [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
+    #
+    # See [scrolling](../input.md#scrolling) for alternative ways to scroll.
     def scroll_into_view_if_needed(timeout: nil)
       wrap_impl(@impl.scroll_into_view_if_needed(timeout: unwrap_impl(timeout)))
     end
@@ -464,6 +466,7 @@ module Playwright
     #
     # Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
     # are resolved relative to the current working directory. For empty array, clears the selected files.
+    # For inputs with a `[webkitdirectory]` attribute, only a single directory path is supported.
     #
     # This method expects `ElementHandle` to point to an
     # [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the `<label>` element that has an associated [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.

data/lib/playwright_api/locator.rb

@@ -983,6 +983,8 @@ module Playwright
     # This method waits for [actionability](../actionability.md) checks, then tries to scroll element into view, unless it is
     # completely visible as defined by
     # [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
+    #
+    # See [scrolling](../input.md#scrolling) for alternative ways to scroll.
     def scroll_into_view_if_needed(timeout: nil)
       wrap_impl(@impl.scroll_into_view_if_needed(timeout: unwrap_impl(timeout)))
     end
@@ -1073,6 +1075,7 @@ module Playwright
 
     #
     # Upload file or multiple files into `<input type=file>`.
+    # For inputs with a `[webkitdirectory]` attribute, only a single directory path is supported.
     #
     # **Usage**
     #
@@ -1083,6 +1086,9 @@ module Playwright
     # # Select multiple files
     # page.get_by_label("Upload files").set_input_files(['file1.txt', 'file2.txt'])
     #
+    # # Select a directory
+    # page.get_by_label("Upload directory").set_input_files('mydir')
+    #
     # # Remove all the selected files
     # page.get_by_label("Upload file").set_input_files([])
     #

data/lib/playwright_api/locator_assertions.rb

@@ -128,8 +128,8 @@ module Playwright
 
     #
     # The opposite of [`method: LocatorAssertions.toHaveRole`].
-    def not_to_have_role(name, timeout: nil)
-      wrap_impl(@impl.not_to_have_role(unwrap_impl(name), timeout: unwrap_impl(timeout)))
+    def not_to_have_role(role, timeout: nil)
+      wrap_impl(@impl.not_to_have_role(unwrap_impl(role), timeout: unwrap_impl(timeout)))
     end
 
     #

data/lib/playwright_api/mouse.rb

@@ -53,7 +53,7 @@ module Playwright
     end
 
     #
-    # Dispatches a `wheel` event.
+    # Dispatches a `wheel` event. This method is usually used to manually scroll the page. See [scrolling](../input.md#scrolling) for alternative ways to scroll.
     #
     # **NOTE**: Wheel events may cause scrolling if they are not handled, and this method does not
     # wait for the scrolling to finish before returning.

data/lib/playwright_api/page.rb

@@ -44,6 +44,12 @@ module Playwright
   # ```
   class Page < PlaywrightApi
 
+    #
+    # Playwright has ability to mock clock and passage of time.
+    def clock # property
+      wrap_impl(@impl.clock)
+    end
+
     def accessibility # property
       wrap_impl(@impl.accessibility)
     end
@@ -463,22 +469,6 @@ module Playwright
     # with sync_playwright() as playwright:
     #     run(playwright)
     # ```
-    #
-    # An example of passing an element handle:
-    #
-    # ```python sync
-    # def print(source, element):
-    #     print(element.text_content())
-    #
-    # page.expose_binding("clicked", print, handle=true)
-    # page.set_content("""
-    #   <script>
-    #     document.addEventListener('click', event => window.clicked(event.target));
-    #   </script>
-    #   <div>Click me</div>
-    #   <div>Or click me</div>
-    # """)
-    # ```
     def expose_binding(name, callback, handle: nil)
       wrap_impl(@impl.expose_binding(unwrap_impl(name), unwrap_impl(callback), handle: unwrap_impl(handle)))
     end
@@ -1353,6 +1343,7 @@ module Playwright
     #
     # Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
     # are resolved relative to the current working directory. For empty array, clears the selected files.
+    # For inputs with a `[webkitdirectory]` attribute, only a single directory path is supported.
     #
     # This method expects `selector` to point to an
     # [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the `<label>` element that has an associated [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
@@ -1656,7 +1647,7 @@ module Playwright
     # return response.ok
     #
     # # or with a lambda
-    # with page.expect_response(lambda response: response.url == "https://example.com" and response.status == 200) as response_info:
+    # with page.expect_response(lambda response: response.url == "https://example.com" and response.status == 200 and response.request.method == "get") as response_info:
     #     page.get_by_text("trigger response").click()
     # response = response_info.value
     # return response.ok

data/lib/playwright_api/page_assertions.rb

@@ -21,8 +21,8 @@ module Playwright
 
     #
     # The opposite of [`method: PageAssertions.toHaveURL`].
-    def not_to_have_url(urlOrRegExp, timeout: nil)
-      wrap_impl(@impl.not_to_have_url(unwrap_impl(urlOrRegExp), timeout: unwrap_impl(timeout)))
+    def not_to_have_url(urlOrRegExp, ignoreCase: nil, timeout: nil)
+      wrap_impl(@impl.not_to_have_url(unwrap_impl(urlOrRegExp), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout)))
     end
 
     #

data/lib/playwright_api/playwright.rb

@@ -94,13 +94,13 @@ module Playwright
     end
 
     # @nodoc
-    def electron
-      wrap_impl(@impl.electron)
+    def android
+      wrap_impl(@impl.android)
     end
 
     # @nodoc
-    def android
-      wrap_impl(@impl.android)
+    def electron
+      wrap_impl(@impl.electron)
     end
 
     # -- inherited from EventEmitter --

data/lib/playwright_api/worker.rb

@@ -47,13 +47,13 @@ module Playwright
     end
 
     # @nodoc
-    def page=(req)
-      wrap_impl(@impl.page=(unwrap_impl(req)))
+    def context=(req)
+      wrap_impl(@impl.context=(unwrap_impl(req)))
     end
 
     # @nodoc
-    def context=(req)
-      wrap_impl(@impl.context=(unwrap_impl(req)))
+    def page=(req)
+      wrap_impl(@impl.page=(unwrap_impl(req)))
     end
 
     # -- inherited from EventEmitter --

data/sig/playwright.rbs

@@ -220,6 +220,18 @@ module Playwright
     def register: (String name, ?script: String, ?contentScript: bool, ?path: (String | File)) -> void
   end
 
+  class Clock
+    def fast_forward: ((Integer | String) ticks) -> void
+    def install: (?time: (Integer | String | Time)) -> void
+    def run_for: ((Integer | String) ticks) -> void
+    def pause_at: ((Integer | String | Time) time) -> void
+    def resume: -> void
+    def set_fixed_time: ((Integer | String | Time) time) -> void
+    def fixed_time=: ((Integer | String | Time) time) -> void
+    def set_system_time: ((Integer | String | Time) time) -> void
+    def system_time=: ((Integer | String | Time) time) -> void
+  end
+
   class ConsoleMessage
     def args: -> Array[untyped]
     def location: -> Hash[untyped, untyped]
@@ -348,6 +360,7 @@ module Playwright
     def expect_worker: (?predicate: function, ?timeout: Float) { () -> void } -> Worker
     def workers: -> Array[untyped]
 
+    attr_reader clock: Clock
     attr_reader accessibility: Accessibility
     attr_reader keyboard: Keyboard
     attr_reader mouse: Mouse
@@ -390,6 +403,7 @@ module Playwright
     def expect_event: (String event, ?predicate: function, ?timeout: Float) { () -> void } -> untyped
     def expect_page: (?predicate: function, ?timeout: Float) { () -> void } -> Page
 
+    attr_reader clock: Clock
     attr_reader request: APIRequestContext
     attr_reader tracing: Tracing
   end
@@ -533,7 +547,7 @@ module Playwright
 
   class APIRequestContext
     def delete: (String url, ?data: (String | String | untyped), ?failOnStatusCode: bool, ?form: Hash[untyped, untyped], ?headers: Hash[untyped, untyped], ?ignoreHTTPSErrors: bool, ?maxRedirects: Integer, ?multipart: Hash[untyped, untyped], ?params: Hash[untyped, untyped], ?timeout: Float) -> APIResponse
-    def dispose: -> void
+    def dispose: (?reason: String) -> void
     def fetch: ((String | Request) urlOrRequest, ?data: (String | String | untyped), ?failOnStatusCode: bool, ?form: Hash[untyped, untyped], ?headers: Hash[untyped, untyped], ?ignoreHTTPSErrors: bool, ?maxRedirects: Integer, ?method: String, ?multipart: Hash[untyped, untyped], ?params: Hash[untyped, untyped], ?timeout: Float) -> APIResponse
     def get: (String url, ?data: (String | String | untyped), ?failOnStatusCode: bool, ?form: Hash[untyped, untyped], ?headers: Hash[untyped, untyped], ?ignoreHTTPSErrors: bool, ?maxRedirects: Integer, ?multipart: Hash[untyped, untyped], ?params: Hash[untyped, untyped], ?timeout: Float) -> APIResponse
     def head: (String url, ?data: (String | String | untyped), ?failOnStatusCode: bool, ?form: Hash[untyped, untyped], ?headers: Hash[untyped, untyped], ?ignoreHTTPSErrors: bool, ?maxRedirects: Integer, ?multipart: Hash[untyped, untyped], ?params: Hash[untyped, untyped], ?timeout: Float) -> APIResponse
@@ -562,7 +576,7 @@ module Playwright
     def not_to_have_css: (String name, (String | Regexp) value, ?timeout: Float) -> void
     def not_to_have_id: ((String | Regexp) id, ?timeout: Float) -> void
     def not_to_have_js_property: (String name, untyped value, ?timeout: Float) -> void
-    def not_to_have_role: ((String | Regexp) name, ?timeout: Float) -> void
+    def not_to_have_role: (("alert" | "alertdialog" | "application" | "article" | "banner" | "blockquote" | "button" | "caption" | "cell" | "checkbox" | "code" | "columnheader" | "combobox" | "complementary" | "contentinfo" | "definition" | "deletion" | "dialog" | "directory" | "document" | "emphasis" | "feed" | "figure" | "form" | "generic" | "grid" | "gridcell" | "group" | "heading" | "img" | "insertion" | "link" | "list" | "listbox" | "listitem" | "log" | "main" | "marquee" | "math" | "meter" | "menu" | "menubar" | "menuitem" | "menuitemcheckbox" | "menuitemradio" | "navigation" | "none" | "note" | "option" | "paragraph" | "presentation" | "progressbar" | "radio" | "radiogroup" | "region" | "row" | "rowgroup" | "rowheader" | "scrollbar" | "search" | "searchbox" | "separator" | "slider" | "spinbutton" | "status" | "strong" | "subscript" | "superscript" | "switch" | "tab" | "table" | "tablist" | "tabpanel" | "term" | "textbox" | "time" | "timer" | "toolbar" | "tooltip" | "tree" | "treegrid" | "treeitem") role, ?timeout: Float) -> void
     def not_to_have_text: ((String | Regexp | Array[untyped] | Array[untyped] | Array[untyped]) expected, ?ignoreCase: bool, ?timeout: Float, ?useInnerText: bool) -> void
     def not_to_have_value: ((String | Regexp) value, ?timeout: Float) -> void
     def not_to_have_values: ((Array[untyped] | Array[untyped] | Array[untyped]) values, ?timeout: Float) -> void
@@ -593,7 +607,7 @@ module Playwright
 
   class PageAssertions
     def not_to_have_title: ((String | Regexp) titleOrRegExp, ?timeout: Float) -> void
-    def not_to_have_url: ((String | Regexp) urlOrRegExp, ?timeout: Float) -> void
+    def not_to_have_url: ((String | Regexp) urlOrRegExp, ?ignoreCase: bool, ?timeout: Float) -> void
     def to_have_title: ((String | Regexp) titleOrRegExp, ?timeout: Float) -> void
     def to_have_url: ((String | Regexp) urlOrRegExp, ?ignoreCase: bool, ?timeout: Float) -> void
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 1.44.0
+  version: 1.45.0
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-05-20 00:00:00.000000000 Z
+date: 2024-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -217,6 +217,7 @@ files:
 - documentation/docs/api/browser_context.md
 - documentation/docs/api/browser_type.md
 - documentation/docs/api/cdp_session.md
+- documentation/docs/api/clock.md
 - documentation/docs/api/console_message.md
 - documentation/docs/api/dialog.md
 - documentation/docs/api/download.md
@@ -310,6 +311,7 @@ files:
 - lib/playwright/channel_owners/web_socket.rb
 - lib/playwright/channel_owners/worker.rb
 - lib/playwright/channel_owners/writable_stream.rb
+- lib/playwright/clock_impl.rb
 - lib/playwright/connection.rb
 - lib/playwright/console_message_impl.rb
 - lib/playwright/download_impl.rb
@@ -363,6 +365,7 @@ files:
 - lib/playwright_api/browser_context.rb
 - lib/playwright_api/browser_type.rb
 - lib/playwright_api/cdp_session.rb
+- lib/playwright_api/clock.rb
 - lib/playwright_api/console_message.rb
 - lib/playwright_api/dialog.rb
 - lib/playwright_api/download.rb
@@ -410,5 +413,5 @@ requirements: []
 rubygems_version: 3.3.27
 signing_key: 
 specification_version: 4
-summary: The Ruby binding of playwright driver 1.44.0
+summary: The Ruby binding of playwright driver 1.45.0
 test_files: []