playwright-ruby-client 1.17.1 → 1.18.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9407fc7093bb4cdb7539eec09b879e4bfd665626801594c764798ae41d3c7823
-  data.tar.gz: e6047ebe532d15fa5600986ae3fc9f42a23ea670923e1ec8fac6f6ecbb7f01c4
+  metadata.gz: cea05a1d92148b300982f6ada4ae56aa99c9b9fff9c7a9ac40dae957682b716e
+  data.tar.gz: dc053db008d37c2194bbaa6f34c80e8b8a174370d0afdc9b23777063519c4318
 SHA512:
-  metadata.gz: 70b935777666f43236ec9df9b8462ebebf7fb883cde2d57e167d3342a18280a86e286e99e206f47e6ee2c739f23f6afe43daa2def9ea0a322b5e09f3b36bfc81
-  data.tar.gz: 3392ad01696c2c22ba411d7e4821e0bf0a2f641526481201927ff6510d7bb077c9fb6b20fcafabd55e5067ff7b1153b950d6b3c532c0bd14d77b9a0b3ac7c4c0
+  metadata.gz: 560c79143101d7ad7ff31e8eda70d7300e335bd40b9a6a87824a0e6e329658a7c45d7e5ee0979822092dda8008c4e83342e1abd4332db57dbb806ccd9bff1c8e
+  data.tar.gz: f8c49313b8b3f5561d8e64cdbf262eb5967a8eb421d5761fa0b0182d3cef634f276b095fc4520d26957f8b6d72fb5aefd0fbc18236e94e725aeb6c0025ad1545

data/documentation/docs/api/api_request_context.md

@@ -9,6 +9,30 @@ environment or the service to your e2e test. When used on [Page](./page) or a [B
 the cookies from the corresponding [BrowserContext](./browser_context). This means that if you log in using this API, your e2e test will be
 logged in and vice versa.
 
+```ruby
+playwright.chromium.launch do |browser|
+  # This will launch a new browser, create a context and page. When making HTTP
+  # requests with the internal APIRequestContext (e.g. `context.request` or `page.request`)
+  # it will automatically set the cookies to the browser page and vise versa.
+  context = browser.new_context(base_url: 'https://api.github,com')
+  api_request_context = context.request
+
+
+  # Create a repository.
+  response = api_request_context.post(
+    "/user/repos",
+    headers: {
+      "Accept": "application/vnd.github.v3+json",
+      "Authorization": "Bearer #{API_TOKEN}",
+    },
+    data: { name: 'test-repo-1' },
+  )
+  response.ok? # => true
+  response.json['name'] # => "tes≈-repo-1"
+end
+```
+
+
 ## delete
 
 ```

data/documentation/docs/api/api_response.md

@@ -6,6 +6,20 @@ sidebar_position: 10
 
 [APIResponse](./api_response) class represents responses returned by [APIRequestContext#get](./api_request_context#get) and similar methods.
 
+```ruby
+playwright.chromium.launch do |browser|
+  context = browser.new_context
+  response = context.request.get("https://example.com/user/repos")
+
+  response.ok? # => true
+  response.status # => 200
+  response.headers["content-type"] # => "application/json; charset=utf-8"
+  response.json # => { "name" => "Foo" }
+  response.body # => "{ \"name\" => \"Foo\" }"
+end
+```
+
+
 ## body
 
 ```

data/documentation/docs/api/download.md

@@ -19,9 +19,7 @@ end
 path = download.path
 ```
 
-> NOTE: Browser context **must** be created with the `acceptDownloads` set to `true` when user needs access to the
-downloaded content. If `acceptDownloads` is not set, download events are emitted, but the actual download is not
-performed and user has no access to the downloaded files.
+
 
 ## cancel
 

data/documentation/docs/api/frame.md

@@ -549,7 +549,7 @@ considered not visible.
 ## locator
 
 ```
-def locator(selector)
+def locator(selector, hasText: nil)
 ```
 
 The method returns an element locator that can be used to perform actions in the frame. Locator is resolved to the

data/documentation/docs/api/frame_locator.md

@@ -26,6 +26,15 @@ page.frame_locator('.result-frame').locator('button').click
 page.frame_locator('.result-frame').first.locator('button').click
 ```
 
+**Converting Locator to FrameLocator**
+
+If you have a [Locator](./locator) object pointing to an `iframe` it can be converted to [FrameLocator](./frame_locator) using
+[`:scope`](https://developer.mozilla.org/en-US/docs/Web/CSS/:scope) CSS selector:
+
+```ruby
+frame_locator = locator.frame_locator(':scope')
+```
+
 
 
 ## first
@@ -56,7 +65,7 @@ Returns locator to the last matching frame.
 ## locator
 
 ```
-def locator(selector)
+def locator(selector, hasText: nil)
 ```
 
 The method finds an element matching the specified selector in the FrameLocator's subtree.

data/documentation/docs/api/locator.md

@@ -4,53 +4,10 @@ sidebar_position: 10
 
 # Locator
 
-Locator represents a view to the element(s) on the page. It captures the logic sufficient to retrieve the element at any
-given moment. Locator can be created with the [Page#locator](./page#locator) method.
-
-```ruby
-locator = page.locator("text=Submit")
-locator.click
-```
-
-The difference between the Locator and [ElementHandle](./element_handle) is that the latter points to a particular element, while Locator
-captures the logic of how to retrieve that element.
-
-In the example below, handle points to a particular DOM element on page. If that element changes text or is used by
-React to render an entirely different component, handle is still pointing to that very DOM element. This can lead to
-unexpected behaviors.
-
-```ruby
-handle = page.query_selector("text=Submit")
-handle.hover
-handle.click
-```
-
-With the locator, every time the `element` is used, up-to-date DOM element is located in the page using the selector. So
-in the snippet below, underlying DOM element is going to be located twice.
-
-```ruby
-locator = page.locator("text=Submit")
-locator.hover
-locator.click
-```
-
-**Strictness**
-
-Locators are strict. This means that all operations on locators that imply some target DOM element will throw if more
-than one element matches given selector.
-
-```ruby
-# Throws if there are several buttons in DOM:
-page.locator('button').click
-
-# Works because we explicitly tell locator to pick the first element:
-page.locator('button').first.click
-
-# Works because count knows what to do with multiple matches:
-page.locator('button').count
-```
-
+Locators are the central piece of Playwright's auto-waiting and retry-ability. In a nutshell, locators represent a way
+to find element(s) on the page at any moment. Locator can be created with the [Page#locator](./page#locator) method.
 
+[Learn more about locators](https://playwright.dev/python/docs/locators).
 
 ## all_inner_texts
 
@@ -220,6 +177,21 @@ element.dispatch_event("dragstart", eventInit: { dataTransfer: data_transfer })
 
 
 
+## drag_to
+
+```
+def drag_to(
+      target,
+      force: nil,
+      noWaitAfter: nil,
+      sourcePosition: nil,
+      targetPosition: nil,
+      timeout: nil,
+      trial: nil)
+```
+
+
+
 ## element_handle
 
 ```
@@ -458,7 +430,7 @@ Returns locator to the last matching element.
 ## locator
 
 ```
-def locator(selector)
+def locator(selector, hasText: nil)
 ```
 
 The method finds an element matching the specified selector in the [Locator](./locator)'s subtree.

data/documentation/docs/api/page.md

@@ -774,7 +774,7 @@ considered not visible.
 ## locator
 
 ```
-def locator(selector)
+def locator(selector, hasText: nil)
 ```
 
 The method returns an element locator that can be used to perform actions on the page. Locator is resolved to the
@@ -1597,4 +1597,8 @@ associated with the page.
 
 ## mouse
 
+## request
+
+API testing helper associated with this page. Requests made with this API will use page cookies.
+
 ## touchscreen

data/documentation/docs/include/api_coverage.md

@@ -319,6 +319,7 @@
 * accessibility
 * keyboard
 * mouse
+* request
 * touchscreen
 
 ## BrowserContext
@@ -405,6 +406,7 @@
 * count
 * dblclick
 * dispatch_event
+* drag_to
 * element_handle
 * element_handles
 * evaluate
@@ -449,6 +451,9 @@
 * locator
 * nth
 
+## LocalUtils
+
+
 ## APIResponse
 
 * body

data/lib/playwright/channel_owners/browser_context.rb

@@ -360,5 +360,10 @@ module Playwright
     private def base_url
       @options[:baseURL]
     end
+
+    # called from Tracing
+    private def remote_connection?
+      @connection.remote?
+    end
   end
 end

data/lib/playwright/channel_owners/frame.rb

@@ -400,8 +400,8 @@ module Playwright
       nil
     end
 
-    def locator(selector)
-      LocatorImpl.new(frame: self, timeout_settings: @page.send(:timeout_settings), selector: selector)
+    def locator(selector, hasText: nil)
+      LocatorImpl.new(frame: self, timeout_settings: @page.send(:timeout_settings), selector: selector, hasText: hasText)
     end
 
     def frame_locator(selector)

data/lib/playwright/channel_owners/local_utils.rb

@@ -0,0 +1,14 @@
+module Playwright
+  define_channel_owner :LocalUtils do
+    # @param zip_file [String]
+    # @param name_value_array [Array<Hash<{name: string, value: string}>>]
+    def zip(zip_file, name_value_array)
+      params = {
+        zipFile: zip_file,
+        entries: name_value_array,
+      }
+      @channel.send_message_to_server('zip', params)
+      nil
+    end
+  end
+end

data/lib/playwright/channel_owners/page.rb

@@ -558,8 +558,8 @@ module Playwright
         timeout: timeout)
     end
 
-    def locator(selector)
-      @main_frame.locator(selector)
+    def locator(selector, hasText: nil)
+      @main_frame.locator(selector, hasText: hasText)
     end
 
     def frame_locator(selector)

data/lib/playwright/frame_locator_impl.rb

@@ -6,11 +6,12 @@ module Playwright
       @frame_selector = frame_selector
     end
 
-    def locator(selector)
+    def locator(selector, hasText: nil)
       LocatorImpl.new(
         frame: @frame,
         timeout_settings: @timeout_settings,
         selector: "#{@frame_selector} >> control=enter-frame >> #{selector}",
+        hasText: hasText,
       )
     end
 

data/lib/playwright/locator_impl.rb

@@ -1,9 +1,46 @@
+require 'json'
+
 module Playwright
+  class EscapeWithQuotes
+    def initialize(text, char = "'")
+      stringified = text.to_json
+      escaped_text = stringified[1...-1].gsub(/\\"/, '"')
+
+      case char
+      when '"'
+        text = escaped_text.gsub(/["]/, '\\"')
+        @text = "\"#{text}\""
+      when "'"
+        text = escaped_text.gsub(/[']/, '\\\'')
+        @text = "'#{text}'"
+      else
+        raise ArgumentError.new('Invalid escape char')
+      end
+    end
+
+    def to_s
+      @text
+    end
+  end
+
   define_api_implementation :LocatorImpl do
-    def initialize(frame:, timeout_settings:, selector:)
+    def initialize(frame:, timeout_settings:, selector:, hasText: nil)
       @frame = frame
       @timeout_settings = timeout_settings
-      @selector = selector
+      @selector =
+        case hasText
+        when Regexp
+          source = EscapeWithQuotes.new(hasText.source, '"')
+          flags = []
+          flags << 'ms' if (hasText.options & Regexp::MULTILINE) != 0
+          flags << 'i' if (hasText.options & Regexp::IGNORECASE) != 0
+          "#{selector} >> :scope:text-matches(#{source}, \"#{flags.join('')}\")"
+        when String
+          text = EscapeWithQuotes.new(hasText, '"')
+          "#{selector} >> :scope:has-text(#{text})"
+        else
+          selector
+        end
     end
 
     def to_s
@@ -102,6 +139,27 @@ module Playwright
       @frame.dispatch_event(@selector, type, strict: true, eventInit: eventInit, timeout: timeout)
     end
 
+    def drag_to(target,
+          force: nil,
+          noWaitAfter: nil,
+          sourcePosition: nil,
+          targetPosition: nil,
+          timeout: nil,
+          trial: nil)
+
+      @frame.drag_and_drop(
+        @selector,
+        target.instance_variable_get(:@selector),
+        force: force,
+        noWaitAfter: noWaitAfter,
+        sourcePosition: sourcePosition,
+        targetPosition: targetPosition,
+        timeout: timeout,
+        trial: trial,
+        strict: true,
+      )
+    end
+
     def evaluate(expression, arg: nil, timeout: nil)
       with_element(timeout: timeout) do |handle|
         handle.evaluate(expression, arg: arg)
@@ -122,11 +180,12 @@ module Playwright
       @frame.fill(@selector, value, strict: true, force: force, noWaitAfter: noWaitAfter, timeout: timeout)
     end
 
-    def locator(selector)
+    def locator(selector, hasText: nil)
       LocatorImpl.new(
         frame: @frame,
         timeout_settings: @timeout_settings,
         selector: "#{@selector} >> #{selector}",
+        hasText: hasText,
       )
     end
 

data/lib/playwright/tracing_impl.rb

@@ -20,21 +20,35 @@ module Playwright
     end
 
     def stop_chunk(path: nil)
-      do_stop_chunk(path: path)
+      do_stop_chunk(file_path: path)
     end
 
     def stop(path: nil)
-      do_stop_chunk(path: path)
+      do_stop_chunk(file_path: path)
       @channel.send_message_to_server('tracingStop')
     end
 
-    private def do_stop_chunk(path:)
-      result = @channel.send_message_to_server_result('tracingStopChunk', save: !path.nil?, skipCompress: false)
-      artifact = ChannelOwners::Artifact.from_nullable(result['artifact'])
-      return unless artifact
+    private def do_stop_chunk(file_path:)
+      mode = 'doNotSave'
+      if file_path
+        if @context.send(:remote_connection?)
+          mode = 'compressTrace'
+        else
+          mode = 'compressTraceAndSources'
+        end
+      end
 
-      artifact.save_as(path)
+      result = @channel.send_message_to_server_result('tracingStopChunk', mode: mode)
+      return unless file_path # Not interested in artifacts.
+      return unless result['artifact'] # The artifact may be missing if the browser closed while stopping tracing.
+
+      artifact = ChannelOwners::Artifact.from(result['artifact'])
+      artifact.save_as(file_path)
       artifact.delete
+
+      # // Add local sources to the remote trace if necessary.
+      # if (result.sourceEntries?.length)
+      #   await this._context._localUtils.zip(filePath, result.sourceEntries);
     end
   end
 end

data/lib/playwright/transport.rb

@@ -46,7 +46,7 @@ module Playwright
     #
     # @note This method blocks until playwright-cli exited. Consider using Thread or Future.
     def async_run
-      @stdin, @stdout, @stderr, @thread = Open3.popen3("#{@driver_executable_path} run-driver")
+      @stdin, @stdout, @stderr, @thread = Open3.popen3("#{@driver_executable_path} run-driver", { pgroup: true })
       @stdin.binmode  # Ensure Strings are written 1:1 without encoding conversion, necessary for integer values
 
       Thread.new { handle_stdout }

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '1.17.1'
-  COMPATIBLE_PLAYWRIGHT_VERSION = '1.17.2'
+  VERSION = '1.18.2'
+  COMPATIBLE_PLAYWRIGHT_VERSION = '1.18.1'
 end

data/lib/playwright_api/api_request.rb

@@ -1,5 +1,7 @@
 module Playwright
-  # Exposes API that can be used for the Web API testing.
+  # Exposes API that can be used for the Web API testing. Each Playwright browser context has a APIRequestContext instance
+  # attached which shares cookies with the page context. Its also possible to create a new APIRequestContext instance
+  # manually. For more information see [here](./class-apirequestcontext).
   class APIRequest < PlaywrightApi
 
     # Creates new instances of `APIRequestContext`.

data/lib/playwright_api/api_request_context.rb

@@ -3,6 +3,53 @@ module Playwright
   # environment or the service to your e2e test. When used on `Page` or a `BrowserContext`, this API will automatically use
   # the cookies from the corresponding `BrowserContext`. This means that if you log in using this API, your e2e test will be
   # logged in and vice versa.
+  #
+  # ```python sync
+  # import os
+  # from playwright.sync_api import sync_playwright
+  #
+  # REPO = "test-repo-1"
+  # USER = "github-username"
+  # API_TOKEN = os.getenv("GITHUB_API_TOKEN")
+  #
+  # with sync_playwright() as p:
+  #     # This will launch a new browser, create a context and page. When making HTTP
+  #     # requests with the internal APIRequestContext (e.g. `context.request` or `page.request`)
+  #     # it will automatically set the cookies to the browser page and vise versa.
+  #     browser = playwright.chromium.launch()
+  #     context = browser.new_context(base_url="https://api.github.com")
+  #     api_request_context = context.request
+  #     page = context.new_page()
+  #
+  #     # Alternatively you can create a APIRequestContext manually without having a browser context attached:
+  #     # api_request_context = playwright.request.new_context(base_url="https://api.github.com")
+  #
+  #
+  #     # Create a repository.
+  #     response = api_request_context.post(
+  #         "/user/repos",
+  #         headers={
+  #             "Accept": "application/vnd.github.v3+json",
+  #             # Add GitHub personal access token.
+  #             "Authorization": f"token {API_TOKEN}",
+  #         },
+  #         data={"name": REPO},
+  #     )
+  #     assert response.ok
+  #     assert response.json()["name"] == REPO
+  #
+  #     # Delete a repository.
+  #     response = api_request_context.delete(
+  #         f"/repos/{USER}/{REPO}",
+  #         headers={
+  #             "Accept": "application/vnd.github.v3+json",
+  #             # Add GitHub personal access token.
+  #             "Authorization": f"token {API_TOKEN}",
+  #         },
+  #     )
+  #     assert response.ok
+  #     assert await response.body() == '{"status": "ok"}'
+  # ```
   class APIRequestContext < PlaywrightApi
 
     # Sends HTTP(S) [DELETE](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE) request and returns its

data/lib/playwright_api/api_response.rb

@@ -1,5 +1,18 @@
 module Playwright
   # `APIResponse` class represents responses returned by [`method: APIRequestContext.get`] and similar methods.
+  #
+  # ```python sync
+  # from playwright.sync_api import sync_playwright
+  #
+  # with sync_playwright() as p:
+  #     context = playwright.request.new_context()
+  #     response = context.get("https://example.com/user/repos")
+  #     assert response.ok
+  #     assert response.status == 200
+  #     assert response.headers["content-type"] == "application/json; charset=utf-8"
+  #     assert response.json()["name"] == "foobar"
+  #     assert response.body() == '{"status": "ok"}'
+  # ```
   class APIResponse < PlaywrightApi
 
     # Returns the buffer with response body.

data/lib/playwright_api/download.rb

@@ -12,10 +12,6 @@ module Playwright
   # # wait for download to complete
   # path = download.path()
   # ```
-  #
-  # > NOTE: Browser context **must** be created with the `acceptDownloads` set to `true` when user needs access to the
-  # downloaded content. If `acceptDownloads` is not set, download events are emitted, but the actual download is not
-  # performed and user has no access to the downloaded files.
   class Download < PlaywrightApi
 
     # Cancels a download. Will not fail if the download is already finished or canceled. Upon successful cancellations,

data/lib/playwright_api/frame.rb

@@ -445,8 +445,8 @@ module Playwright
     # The method returns an element locator that can be used to perform actions in the frame. Locator is resolved to the
     # element immediately before performing an action, so a series of actions on the same locator can in fact be performed on
     # different DOM elements. That would happen if the DOM structure between those actions has changed.
-    def locator(selector)
-      wrap_impl(@impl.locator(unwrap_impl(selector)))
+    def locator(selector, hasText: nil)
+      wrap_impl(@impl.locator(unwrap_impl(selector), hasText: unwrap_impl(hasText)))
     end
 
     # Returns frame's name attribute as specified in the tag.

data/lib/playwright_api/frame_locator.rb

@@ -20,6 +20,15 @@ module Playwright
   # # Works because we explicitly tell locator to pick the first frame:
   # page.frame_locator('.result-frame').first.locator('button').click()
   # ```
+  #
+  # **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:
+  #
+  # ```python sync
+  # frameLocator = locator.frame_locator(":scope");
+  # ```
   class FrameLocator < PlaywrightApi
 
     # Returns locator to the first matching frame.
@@ -39,8 +48,8 @@ module Playwright
     end
 
     # The method finds an element matching the specified selector in the FrameLocator's subtree.
-    def locator(selector)
-      wrap_impl(@impl.locator(unwrap_impl(selector)))
+    def locator(selector, hasText: nil)
+      wrap_impl(@impl.locator(unwrap_impl(selector), hasText: unwrap_impl(hasText)))
     end
 
     # Returns locator to the n-th matching frame.

data/lib/playwright_api/local_utils.rb

@@ -0,0 +1,9 @@
+module Playwright
+  class LocalUtils < PlaywrightApi
+
+    # @nodoc
+    def zip(zip_file, name_value_array)
+      wrap_impl(@impl.zip(unwrap_impl(zip_file), unwrap_impl(name_value_array)))
+    end
+  end
+end

data/lib/playwright_api/locator.rb

@@ -1,49 +1,8 @@
 module Playwright
-  # Locator represents a view to the element(s) on the page. It captures the logic sufficient to retrieve the element at any
-  # given moment. Locator can be created with the [`method: Page.locator`] method.
+  # Locators are the central piece of Playwright's auto-waiting and retry-ability. In a nutshell, locators represent a way
+  # to find element(s) on the page at any moment. Locator can be created with the [`method: Page.locator`] method.
   #
-  # ```python sync
-  # locator = page.locator("text=Submit")
-  # locator.click()
-  # ```
-  #
-  # The difference between the Locator and `ElementHandle` is that the latter points to a particular element, while Locator
-  # captures the logic of how to retrieve that element.
-  #
-  # In the example below, handle points to a particular DOM element on page. If that element changes text or is used by
-  # React to render an entirely different component, handle is still pointing to that very DOM element. This can lead to
-  # unexpected behaviors.
-  #
-  # ```python sync
-  # handle = page.query_selector("text=Submit")
-  # handle.hover()
-  # handle.click()
-  # ```
-  #
-  # With the locator, every time the `element` is used, up-to-date DOM element is located in the page using the selector. So
-  # in the snippet below, underlying DOM element is going to be located twice.
-  #
-  # ```python sync
-  # locator = page.locator("text=Submit")
-  # locator.hover()
-  # locator.click()
-  # ```
-  #
-  # **Strictness**
-  #
-  # Locators are strict. This means that all operations on locators that imply some target DOM element will throw if more
-  # than one element matches given selector.
-  #
-  # ```python sync
-  # # Throws if there are several buttons in DOM:
-  # page.locator('button').click()
-  #
-  # # Works because we explicitly tell locator to pick the first element:
-  # page.locator('button').first.click()
-  #
-  # # Works because count knows what to do with multiple matches:
-  # page.locator('button').count()
-  # ```
+  # [Learn more about locators](./locators.md).
   class Locator < PlaywrightApi
 
     # Returns an array of `node.innerText` values for all matching nodes.
@@ -183,6 +142,17 @@ module Playwright
       wrap_impl(@impl.dispatch_event(unwrap_impl(type), eventInit: unwrap_impl(eventInit), timeout: unwrap_impl(timeout)))
     end
 
+    def drag_to(
+          target,
+          force: nil,
+          noWaitAfter: nil,
+          sourcePosition: nil,
+          targetPosition: nil,
+          timeout: nil,
+          trial: nil)
+      wrap_impl(@impl.drag_to(unwrap_impl(target), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), sourcePosition: unwrap_impl(sourcePosition), targetPosition: unwrap_impl(targetPosition), timeout: unwrap_impl(timeout), trial: unwrap_impl(trial)))
+    end
+
     # Resolves given locator to the first matching DOM element. If no elements matching the query are visible, waits for them
     # up to a given timeout. If multiple elements match the selector, throws.
     def element_handle(timeout: nil)
@@ -350,8 +320,8 @@ module Playwright
     end
 
     # The method finds an element matching the specified selector in the `Locator`'s subtree.
-    def locator(selector)
-      wrap_impl(@impl.locator(unwrap_impl(selector)))
+    def locator(selector, hasText: nil)
+      wrap_impl(@impl.locator(unwrap_impl(selector), hasText: unwrap_impl(hasText)))
     end
 
     # Returns locator to the n-th matching element.

data/lib/playwright_api/page.rb

@@ -56,6 +56,11 @@ module Playwright
       wrap_impl(@impl.mouse)
     end
 
+    # API testing helper associated with this page. Requests made with this API will use page cookies.
+    def request # property
+      wrap_impl(@impl.request)
+    end
+
     def touchscreen # property
       wrap_impl(@impl.touchscreen)
     end
@@ -681,8 +686,8 @@ module Playwright
     # different DOM elements. That would happen if the DOM structure between those actions has changed.
     #
     # Shortcut for main frame's [`method: Frame.locator`].
-    def locator(selector)
-      wrap_impl(@impl.locator(unwrap_impl(selector)))
+    def locator(selector, hasText: nil)
+      wrap_impl(@impl.locator(unwrap_impl(selector), hasText: unwrap_impl(hasText)))
     end
 
     # The page's main frame. Page is guaranteed to have a main frame which persists during navigations.
@@ -1381,21 +1386,11 @@ module Playwright
       wrap_impl(@impl.owned_context=(unwrap_impl(req)))
     end
 
-    # @nodoc
-    def request
-      wrap_impl(@impl.request)
-    end
-
     # @nodoc
     def start_js_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
       wrap_impl(@impl.start_js_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
     end
 
-    # @nodoc
-    def stop_js_coverage
-      wrap_impl(@impl.stop_js_coverage)
-    end
-
     # @nodoc
     def start_css_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
       wrap_impl(@impl.start_css_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
@@ -1406,6 +1401,11 @@ module Playwright
       wrap_impl(@impl.stop_css_coverage)
     end
 
+    # @nodoc
+    def stop_js_coverage
+      wrap_impl(@impl.stop_js_coverage)
+    end
+
     # @nodoc
     def guid
       wrap_impl(@impl.guid)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 1.17.1
+  version: 1.18.2
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-02-05 00:00:00.000000000 Z
+date: 2022-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -296,6 +296,7 @@ files:
 - lib/playwright/channel_owners/fetch_request.rb
 - lib/playwright/channel_owners/frame.rb
 - lib/playwright/channel_owners/js_handle.rb
+- lib/playwright/channel_owners/local_utils.rb
 - lib/playwright/channel_owners/page.rb
 - lib/playwright/channel_owners/playwright.rb
 - lib/playwright/channel_owners/request.rb
@@ -359,6 +360,7 @@ files:
 - lib/playwright_api/frame_locator.rb
 - lib/playwright_api/js_handle.rb
 - lib/playwright_api/keyboard.rb
+- lib/playwright_api/local_utils.rb
 - lib/playwright_api/locator.rb
 - lib/playwright_api/mouse.rb
 - lib/playwright_api/page.rb
@@ -394,5 +396,5 @@ requirements: []
 rubygems_version: 3.3.3
 signing_key: 
 specification_version: 4
-summary: The Ruby binding of playwright driver 1.17.2
+summary: The Ruby binding of playwright driver 1.18.1
 test_files: []