playwright-ruby-client 1.25.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d7e01f93c5fa8ffd804062e0414e9de40204674ef1b070f296c0108259ca015
-  data.tar.gz: 75bdb822a5c3cc8ffe7e8dc011d8697c2cb00aa95895e7486068c09839a9c667
+  metadata.gz: 9944a15cd23ff09a56c09f396ff276ec366670740f4c79cb553a9dedec346ff8
+  data.tar.gz: 33807cddbf67539e40d8659fd565827a1c0127ccc65c7b6a2864b8e80184053b
 SHA512:
-  metadata.gz: 9499d48e15c5201718f8e4569f1e28b5f66d2bd14c11b4c3a1c98c4e4ca2c39ababc74b3af1db1e2bcabbc4234fd6034eaa0c71b09b925654c468fdf65dd0547
-  data.tar.gz: 622a2e2bd96af9e65255b1abdb52f5768091af4cc8d5a6368b60237e363a8cd3bdbc1673ef1d745d017583206b6d8011f92300228b27a14e69bdc6558392de30
+  metadata.gz: ece68b2c84a789d011b00dd17f27a280e26b23349cc474ec04ca00eab18df2a813a1ebda61143603de02f3abec0fc988818122a09a35d57aa101fbb5429c2beb
+  data.tar.gz: 5070dd01c89f50580c98e196e1d97b5ffcc34ab1fc7856ac9943a6bfc4743e418cac2b3632566a88c24f99ed7fad1c0c3f1c7f66f873a76c02b993eb0baf74bc

data/documentation/docs/api/api_request_context.md

@@ -66,6 +66,7 @@ def delete(
       form: nil,
       headers: nil,
       ignoreHTTPSErrors: nil,
+      maxRedirects: nil,
       multipart: nil,
       params: nil,
       timeout: nil)
@@ -95,6 +96,7 @@ def fetch(
       form: nil,
       headers: nil,
       ignoreHTTPSErrors: nil,
+      maxRedirects: nil,
       method: nil,
       multipart: nil,
       params: nil,
@@ -104,14 +106,47 @@ def fetch(
 Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
 context cookies from the response. The method will automatically follow redirects.
 
+JSON objects can be passed directly to the request:
+
+```ruby
+data = {
+  title: "Book Title",
+  body: "John Doe",
+}
+api_request_context.fetch("https://example.com/api/create_book", method: 'post', data: data)
+```
+
+The common way to send file(s) in the body of a request is to encode it as form fields with `multipart/form-data`
+encoding. You can achieve that with Playwright API like this:
+
+```ruby
+api_request_context.fetch(
+  "https://example.com/api/upload_script",
+  method: 'post',
+  multipart: {
+    fileField: {
+      name: "f.js",
+      mimeType: "text/javascript",
+      buffer: "console.log(2022);",
+    },
+  },
+)
+```
+
+
+
 ## get
 
 ```
 def get(
       url,
+      data: nil,
       failOnStatusCode: nil,
+      form: nil,
       headers: nil,
       ignoreHTTPSErrors: nil,
+      maxRedirects: nil,
+      multipart: nil,
       params: nil,
       timeout: nil)
 ```
@@ -120,14 +155,30 @@ Sends HTTP(S) [GET](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GE
 method will populate request cookies from the context and update context cookies from the response. The method will
 automatically follow redirects.
 
+Request parameters can be configured with `params` option, they will be serialized into the URL search parameters:
+
+```ruby
+query_params = {
+  isbn: "1234",
+  page: "23"
+}
+api_request_context.get("https://example.com/api/get_text", params: query_params)
+```
+
+
+
 ## head
 
 ```
 def head(
       url,
+      data: nil,
       failOnStatusCode: nil,
+      form: nil,
       headers: nil,
       ignoreHTTPSErrors: nil,
+      maxRedirects: nil,
+      multipart: nil,
       params: nil,
       timeout: nil)
 ```
@@ -146,6 +197,7 @@ def patch(
       form: nil,
       headers: nil,
       ignoreHTTPSErrors: nil,
+      maxRedirects: nil,
       multipart: nil,
       params: nil,
       timeout: nil)
@@ -165,6 +217,7 @@ def post(
       form: nil,
       headers: nil,
       ignoreHTTPSErrors: nil,
+      maxRedirects: nil,
       multipart: nil,
       params: nil,
       timeout: nil)
@@ -174,6 +227,45 @@ Sends HTTP(S) [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/P
 The method will populate request cookies from the context and update context cookies from the response. The method will
 automatically follow redirects.
 
+JSON objects can be passed directly to the request:
+
+```ruby
+data = {
+  title: "Book Title",
+  body: "John Doe",
+}
+api_request_context.post("https://example.com/api/create_book", data: data)
+```
+
+To send form data to the server use `form` option. Its value will be encoded into the request body with
+`application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send files):
+
+```ruby
+form_data = {
+  title: "Book Title",
+  body: "John Doe",
+}
+api_request_context.post("https://example.com/api/find_book", form: form_data)
+```
+
+The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
+encoding. You can achieve that with Playwright API like this:
+
+```ruby
+api_request_context.post(
+  "https://example.com/api/upload_script",
+  multipart: {
+    fileField: {
+      name: "f.js",
+      mimeType: "text/javascript",
+      buffer: "console.log(2022);",
+    },
+  },
+)
+```
+
+
+
 ## put
 
 ```
@@ -184,6 +276,7 @@ def put(
       form: nil,
       headers: nil,
       ignoreHTTPSErrors: nil,
+      maxRedirects: nil,
       multipart: nil,
       params: nil,
       timeout: nil)

data/documentation/docs/api/browser_context.md

@@ -161,7 +161,7 @@ page.content = <<~HTML
 <div></div>
 HTML
 
-page.locator("button").click
+page.get_by_role("button").click
 ```
 
 An example of passing an element handle:
@@ -222,7 +222,7 @@ page.content = <<~HTML
 <button onclick="onClick()">Click me</button>
 <div></div>
 HTML
-page.locator("button").click
+page.get_by_role("button").click
 ```
 
 
@@ -434,7 +434,7 @@ value. Will throw an error if the context closes before the event is fired. Retu
 
 ```ruby
 new_page = browser_context.expect_event('page') do
-  page.locator('button').click
+  page.get_by_role("button").click
 end
 ```
 

data/documentation/docs/api/browser_type.md

@@ -37,6 +37,14 @@ The default browser context is accessible via [Browser#contexts](./browser#conte
 
 > NOTE: Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
 
+```ruby
+browser = playwright.chromium.connect_over_cdp("http://localhost:9222")
+default_context = browser.contexts.first
+page = default_context.pages.first
+```
+
+
+
 ## executable_path
 
 ```

data/documentation/docs/api/download.md

@@ -12,7 +12,7 @@ Download event is emitted once the download starts. Download path becomes availa
 
 ```ruby
 download = page.expect_download do
-  page.locator('a').click
+  page.get_by_text("Download file").click
 end
 
 # wait for download to complete

data/documentation/docs/api/element_handle.md

@@ -39,7 +39,7 @@ With the locator, every time the `element` is used, up-to-date DOM element is lo
 in the snippet below, underlying DOM element is going to be located twice.
 
 ```ruby
-locator = page.locator("text=Submit")
+locator = page.get_by_text("Submit")
 locator.hover
 locator.click
 ```

data/documentation/docs/api/file_chooser.md

@@ -8,7 +8,7 @@ sidebar_position: 10
 
 ```ruby
 file_chooser = page.expect_file_chooser do
-  page.locator("upload").click # action to trigger file uploading
+  page.get_by_text("Upload").click # action to trigger file uploading
 end
 file_chooser.set_files("myfile.pdf")
 ```

data/documentation/docs/api/frame.md

@@ -401,7 +401,7 @@ that iframe. Following snippet locates element with text "Submit" in the iframe
 id="my-frame">`:
 
 ```ruby
-locator = frame.frame_locator("#my-iframe").locator("text=Submit")
+locator = frame.frame_locator("#my-iframe").get_by_text("Submit")
 locator.click
 ```
 
@@ -415,6 +415,103 @@ def get_attribute(selector, name, strict: nil, timeout: nil)
 
 Returns element attribute value.
 
+## get_by_alt_text
+
+```
+def get_by_alt_text(text, exact: nil)
+```
+
+Allows locating elements by their alt text. For example, this method will find the image by alt text "Castle":
+
+```html
+<img alt='Castle'>
+```
+
+
+## get_by_label
+
+```
+def get_by_label(text, exact: nil)
+```
+
+Allows locating input elements by the text of the associated label. For example, this method will find the input by
+label text Password in the following DOM:
+
+```html
+<label for="password-input">Password:</label>
+<input id="password-input">
+```
+
+
+## get_by_placeholder
+
+```
+def get_by_placeholder(text, exact: nil)
+```
+
+Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+"Country":
+
+```html
+<input placeholder="Country">
+```
+
+
+## get_by_role
+
+```
+def get_by_role(
+      role,
+      checked: nil,
+      disabled: nil,
+      expanded: nil,
+      includeHidden: nil,
+      level: nil,
+      name: nil,
+      pressed: nil,
+      selected: nil)
+```
+
+Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+[ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+[accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+Note that many html elements have an implicitly
+[defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+## get_by_test_id
+
+```
+def get_by_test_id(testId)
+```
+
+Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+[Selectors#set_test_id_attribute](./selectors#set_test_id_attribute) to configure a different test id attribute if necessary.
+
+## get_by_text
+
+```
+def get_by_text(text, exact: nil)
+```
+
+Allows locating elements that contain given text.
+
+## get_by_title
+
+```
+def get_by_title(text, exact: nil)
+```
+
+Allows locating elements by their title. For example, this method will find the button by its title "Submit":
+
+```html
+<button title='Place the order'>Order Now</button>
+```
+
+
 ## goto
 
 ```
@@ -555,9 +652,11 @@ considered not visible.
 def locator(selector, has: nil, hasText: nil)
 ```
 
-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.
+The method returns an element locator that can be used to perform actions on this page / 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.
+
+[Learn more about locators](https://playwright.dev/python/docs/locators).
 
 [Learn more about locators](https://playwright.dev/python/docs/locators).
 

data/documentation/docs/api/frame_locator.md

@@ -9,21 +9,21 @@ and locate elements in that iframe. FrameLocator can be created with either [Pag
 [Locator#frame_locator](./locator#frame_locator) method.
 
 ```ruby
-locator = page.frame_locator("my-frame").locator("text=Submit")
+locator = page.frame_locator("my-frame").get_by_text("Submit")
 locator.click
 ```
 
 **Strictness**
 
 Frame locators are strict. This means that all operations on frame locators will throw if more than one element matches
-given selector.
+a given selector.
 
 ```ruby
 # Throws if there are several frames in DOM:
-page.frame_locator('.result-frame').locator('button').click
+page.frame_locator('.result-frame').get_by_role('button').click
 
 # Works because we explicitly tell locator to pick the first frame:
-page.frame_locator('.result-frame').first.locator('button').click
+page.frame_locator('.result-frame').first.get_by_role('button').click
 ```
 
 **Converting Locator to FrameLocator**
@@ -54,6 +54,103 @@ def frame_locator(selector)
 When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
 that iframe.
 
+## get_by_alt_text
+
+```
+def get_by_alt_text(text, exact: nil)
+```
+
+Allows locating elements by their alt text. For example, this method will find the image by alt text "Castle":
+
+```html
+<img alt='Castle'>
+```
+
+
+## get_by_label
+
+```
+def get_by_label(text, exact: nil)
+```
+
+Allows locating input elements by the text of the associated label. For example, this method will find the input by
+label text Password in the following DOM:
+
+```html
+<label for="password-input">Password:</label>
+<input id="password-input">
+```
+
+
+## get_by_placeholder
+
+```
+def get_by_placeholder(text, exact: nil)
+```
+
+Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+"Country":
+
+```html
+<input placeholder="Country">
+```
+
+
+## get_by_role
+
+```
+def get_by_role(
+      role,
+      checked: nil,
+      disabled: nil,
+      expanded: nil,
+      includeHidden: nil,
+      level: nil,
+      name: nil,
+      pressed: nil,
+      selected: nil)
+```
+
+Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+[ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+[accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+Note that many html elements have an implicitly
+[defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+## get_by_test_id
+
+```
+def get_by_test_id(testId)
+```
+
+Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+[Selectors#set_test_id_attribute](./selectors#set_test_id_attribute) to configure a different test id attribute if necessary.
+
+## get_by_text
+
+```
+def get_by_text(text, exact: nil)
+```
+
+Allows locating elements that contain given text.
+
+## get_by_title
+
+```
+def get_by_title(text, exact: nil)
+```
+
+Allows locating elements by their title. For example, this method will find the button by its title "Submit":
+
+```html
+<button title='Place the order'>Order Now</button>
+```
+
+
 ## last
 
 ```
@@ -68,7 +165,10 @@ Returns locator to the last matching frame.
 def locator(selector, has: nil, hasText: nil)
 ```
 
-The method finds an element matching the specified selector in the FrameLocator's subtree.
+The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
+similar to [Locator#filter](./locator#filter) method.
+
+[Learn more about locators](https://playwright.dev/python/docs/locators).
 
 ## nth
 

data/documentation/docs/api/locator.md

@@ -190,6 +190,22 @@ def drag_to(
       trial: nil)
 ```
 
+This method drags the locator to another target locator or target position. It will first move to the source element,
+perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
+
+```ruby
+source = page.locator("#source")
+target = page.locator("#target")
+
+source.drag_to(target)
+# or specify exact positions relative to the top-left corners of the elements:
+source.drag_to(
+  target,
+  sourcePosition: { x: 34, y: 7 },
+  targetPosition: { x: 10, y: 20 },
+)
+```
+
 
 
 ## element_handle
@@ -298,8 +314,8 @@ multiple times.
 row_locator = page.locator("tr")
 # ...
 row_locator.
-    filter(has_text="text in column 1").
-    filter(has=page.locator("tr", has_text="column 2 button")).
+    filter(hasText: "text in column 1").
+    filter(has: page.get_by_role("button", name: "column 2 button")).
     screenshot
 ```
 
@@ -331,7 +347,7 @@ When working with iframes, you can create a frame locator that will enter the if
 that iframe:
 
 ```ruby
-locator = page.frame_locator("iframe").locator("text=Submit")
+locator = page.frame_locator("iframe").get_by_text("Submit")
 locator.click
 ```
 
@@ -346,6 +362,103 @@ alias: `[]`
 
 Returns element attribute value.
 
+## get_by_alt_text
+
+```
+def get_by_alt_text(text, exact: nil)
+```
+
+Allows locating elements by their alt text. For example, this method will find the image by alt text "Castle":
+
+```html
+<img alt='Castle'>
+```
+
+
+## get_by_label
+
+```
+def get_by_label(text, exact: nil)
+```
+
+Allows locating input elements by the text of the associated label. For example, this method will find the input by
+label text Password in the following DOM:
+
+```html
+<label for="password-input">Password:</label>
+<input id="password-input">
+```
+
+
+## get_by_placeholder
+
+```
+def get_by_placeholder(text, exact: nil)
+```
+
+Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+"Country":
+
+```html
+<input placeholder="Country">
+```
+
+
+## get_by_role
+
+```
+def get_by_role(
+      role,
+      checked: nil,
+      disabled: nil,
+      expanded: nil,
+      includeHidden: nil,
+      level: nil,
+      name: nil,
+      pressed: nil,
+      selected: nil)
+```
+
+Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+[ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+[accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+Note that many html elements have an implicitly
+[defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+## get_by_test_id
+
+```
+def get_by_test_id(testId)
+```
+
+Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+[Selectors#set_test_id_attribute](./selectors#set_test_id_attribute) to configure a different test id attribute if necessary.
+
+## get_by_text
+
+```
+def get_by_text(text, exact: nil)
+```
+
+Allows locating elements that contain given text.
+
+## get_by_title
+
+```
+def get_by_title(text, exact: nil)
+```
+
+Allows locating elements by their title. For example, this method will find the button by its title "Submit":
+
+```html
+<button title='Place the order'>Order Now</button>
+```
+
+
 ## highlight
 
 ```
@@ -466,9 +579,11 @@ Returns locator to the last matching element.
 def locator(selector, has: nil, hasText: nil)
 ```
 
-The method finds an element matching the specified selector in the [Locator](./locator)'s subtree. It also accepts filter options,
+The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
 similar to [Locator#filter](./locator#filter) method.
 
+[Learn more about locators](https://playwright.dev/python/docs/locators).
+
 ## nth
 
 ```
@@ -684,8 +799,8 @@ element.type("world", delay: 100) # types slower, like a user
 An example of typing into a text field and then submitting the form:
 
 ```ruby
-element = page.locator("input")
-element.type("some text")
+element = page.get_by_label("Password")
+element.type("my password")
 element.press("Enter")
 ```