playwright-ruby-client 1.61.0 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c45763ab237c198b8f2aa3afa3114ae0bf821481e57711516f5014547079f183
-  data.tar.gz: ed8d42f43cb28c8ae2a45755332582b6e51ac993a751de94fb1a25fff43f5532
+  metadata.gz: 7c78e6a1f2ee45aadb2b8a027d08a0264560172b843419e23376c80f74095ccd
+  data.tar.gz: b31e8c1c972865e68312f65ee23a821535f14592affadcc65580b10169819b81
 SHA512:
-  metadata.gz: 90ac4618f354ca98c4d5a5c7284b23d752a098bf7128a246076964381f36d93680b78c89599b15b175afdb7274e6cea1882cfab64f9d9eab6dcb1317b0f0f894
-  data.tar.gz: 91cdfb64498f4e76f0f3a6f726fd49fa3d36dd7c6b692e843455bf8a9160a94216f13e324ffe90a2472c0b9ad573bd1d1ab241590629357d01562991ea299c63
+  metadata.gz: de6ea998c746c0fa3107850695144b7204105c01daa6209f646c2a172bd59eb906e169b4b7ed7dca436e8084611496def05fc81bb23134d8475bedbc480d6fd5
+  data.tar.gz: 907612d4a87117af9d0c57ada0ec4144f7451f7a75176b2b93d3cf896ff6ce8492f7e72ff8a2c04ce1d5d2871fdf9af2f967de9e5175010574d09c276b160300

data/README.md

@@ -12,25 +12,22 @@ gem 'playwright-ruby-client'
 
 and then 'bundle install'.
 
-Since playwright-ruby-client doesn't include the playwright driver, **we have to install [playwright](https://github.com/microsoft/playwright) in advance**.
+Since playwright-ruby-client doesn't include Playwright, **we have to install Node.js and a compatible version of [playwright-core](https://www.npmjs.com/package/playwright-core) in advance**.
 
+```sh
+PLAYWRIGHT_CLI_VERSION=$(bundle exec ruby -e 'require "playwright/version"; puts Playwright::COMPATIBLE_PLAYWRIGHT_VERSION')
+npm install "playwright-core@$PLAYWRIGHT_CLI_VERSION"
+./node_modules/.bin/playwright-core install
 ```
-npm install playwright
-./node_modules/.bin/playwright install
-```
-
-And set `playwright_cli_executable_path: './node_modules/.bin/playwright'`
 
-**Prefer playwrighting without Node.js?**
-
-Instead of npm, you can also directly download playwright driver from playwright.azureedge.net/builds/. The URL can be easily detected from [here](https://github.com/microsoft/playwright-python/blob/cb5409934629adaabc0cff1891080de2052fa778/setup.py#L73-L77)
+And set `playwright_cli_executable_path: './node_modules/.bin/playwright-core'`.
 
 ### Capture a site
 
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   playwright.chromium.launch(headless: false) do |browser|
     page = browser.new_page
     page.goto('https://github.com/YusukeIwaki')
@@ -46,7 +43,7 @@ end
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   playwright.chromium.launch(headless: false) do |browser|
     page = browser.new_page
     page.goto('https://github.com/')
@@ -94,7 +91,7 @@ $ bundle exec ruby main.rb
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   devices = playwright.android.devices
   unless devices.empty?
     device = devices.last
@@ -128,12 +125,10 @@ end
 We have to download android-driver for Playwright in advance.
 
 ```
-wget https://github.com/microsoft/playwright/raw/master/bin/android-driver-target.apk -O /path/to/playwright-driver/package/bin/android-driver-target.apk
-wget https://github.com/microsoft/playwright/raw/master/bin/android-driver.apk -O /path/to/playwright-driver/package/bin/android-driver.apk
+wget https://github.com/microsoft/playwright/raw/master/bin/android-driver-target.apk -O ./node_modules/playwright-core/bin/android-driver-target.apk
+wget https://github.com/microsoft/playwright/raw/master/bin/android-driver.apk -O ./node_modules/playwright-core/bin/android-driver.apk
 ```
 
-(If you downloaded Playwright via npm, replace `/path/to/playwright-driver/package/` with `./node_modules/playwright/` above.)
-
 ```ruby
 require 'playwright'
 
@@ -168,7 +163,7 @@ If your environment doesn't accept installing browser or creating browser proces
 For launching Playwright server, just execute:
 
 ```
-npx playwright install && npx playwright run-server --port 8080 --path /ws
+./node_modules/.bin/playwright-core install && ./node_modules/.bin/playwright-core run-server --port 8080 --path /ws
 ```
 
 and we can connect to the server with the code like this:

data/documentation/docs/api/api_response.md

@@ -122,6 +122,18 @@ def text
 
 Returns the text representation of response body.
 
+## timing
+
+```
+def timing
+```
+
+
+Returns resource timing information for given response. For redirected requests, returns the information for the last
+request in the redirect chain. When the response is served [from the HAR file](https://playwright.dev/python/docs/mock#replaying-from-har), timing
+information is not available and all the values are -1. Find more information at
+[Resource Timing API](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming).
+
 ## url
 
 ```

data/documentation/docs/api/browser_context.md

@@ -434,11 +434,11 @@ alias: `offline=`
 ## storage_state
 
 ```
-def storage_state(indexedDB: nil, path: nil)
+def storage_state(credentials: nil, indexedDB: nil, path: nil)
 ```
 
 
-Returns storage state for this browser context, contains current cookies, local storage snapshot and IndexedDB snapshot.
+Returns storage state for this browser context, contains current cookies, local storage snapshot, IndexedDB snapshot and virtual WebAuthn credentials.
 
 ## set_storage_state
 
@@ -448,7 +448,9 @@ def set_storage_state(storageState)
 alias: `storage_state=`
 
 
-Clears the existing cookies, local storage and IndexedDB entries for all origins and sets the new storage state.
+Clears the existing cookies, local storage, IndexedDB entries and virtual WebAuthn credentials, and sets the new storage
+state. When the storage state contains credentials, the virtual WebAuthn authenticator is installed (equivalent to
+[Credentials#install](./credentials#install)), preventing all real authenticators from working in this context.
 
 **Usage**
 

data/documentation/docs/api/browser_type.md

@@ -59,6 +59,8 @@ The default browser context is accessible via [Browser#contexts](./browser#conte
 
 **NOTE**: This connection is significantly lower fidelity than the Playwright protocol connection via [BrowserType#connect](./browser_type#connect). If you are experiencing issues or attempting to use advanced functionality, you probably want to use [BrowserType#connect](./browser_type#connect).
 
+**NOTE**: Playwright maintains a curated list of arguments for launching the browser. If you launch the browser without Playwright and do not pass the exact same arguments, some of Playwright functionality may be broken upon connecting to the browser.
+
 **Usage**
 
 ```ruby

data/documentation/docs/api/credentials.md

@@ -9,7 +9,7 @@ sidebar_position: 10
 register passkeys and answer `navigator.credentials.create()` / `navigator.credentials.get()`
 ceremonies in the page, without a real authenticator or hardware security key.
 
-There are two common ways to use it:
+There are three common ways to use it:
 
 **Usage: seed a known credential**
 
@@ -31,7 +31,7 @@ page.goto("https://example.com/login")
 # The page's navigator.credentials.get() is answered with the seeded passkey.
 ```
 
-**Usage: capture a passkey, then reuse it**
+**Usage: capture a credential, then reuse it**
 
 ```ruby
 # setup test: let the app register a passkey, then save it.
@@ -65,6 +65,10 @@ page.goto("https://example.com/login")
 # navigator.credentials.get() resolves the captured passkey - already signed in.
 ```
 
+**Usage: save credentials in the storage state, restore later**
+
+See [authentication guide](https://playwright.dev/python/docs/auth) for examples of using saving and resotring the storage state.
+
 **Defaults**
 
 ## install

data/documentation/docs/api/element_handle.md

@@ -75,6 +75,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -103,6 +104,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -139,6 +141,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -290,6 +293,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -538,6 +542,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -578,6 +583,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -630,6 +636,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```

data/documentation/docs/api/frame.md

@@ -58,6 +58,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -95,6 +96,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -131,6 +133,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -202,6 +205,7 @@ def drag_and_drop(
       target,
       force: nil,
       noWaitAfter: nil,
+      scroll: nil,
       sourcePosition: nil,
       steps: nil,
       strict: nil,
@@ -671,6 +675,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -932,6 +937,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -987,6 +993,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1056,6 +1063,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)

data/documentation/docs/api/locator.md

@@ -179,6 +179,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -238,6 +239,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -300,6 +302,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -410,6 +413,7 @@ def drag_to(
       target,
       force: nil,
       noWaitAfter: nil,
+      scroll: nil,
       sourcePosition: nil,
       steps: nil,
       targetPosition: nil,
@@ -921,6 +925,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1367,6 +1372,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1438,6 +1444,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1496,6 +1503,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1541,3 +1549,24 @@ If target element already satisfies the condition, the method returns immediatel
 order_sent = page.locator("#order-sent")
 order_sent.wait_for
 ```
+
+## wait_for_function
+
+```
+def wait_for_function(expression, arg: nil, timeout: nil)
+```
+
+
+Returns when `expression` returns a truthy value, called with the matching element as a first argument, and `arg` as a second argument.
+
+This is a generic way to wait for an element to reach a custom condition without asserting it. The locator is re-resolved on each retry, so it tolerates the element being re-rendered while waiting.
+
+If `expression` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), this method will wait for the promise to resolve before checking its value.
+
+If `expression` throws or rejects, this method throws.
+
+**Usage**
+
+Wait for an attribute to appear:
+
+Passing argument to `expression`:

data/documentation/docs/api/locator_assertions.md

@@ -164,7 +164,7 @@ The opposite of [LocatorAssertions#to_have_accessible_name](./locator_assertions
 ## not_to_have_attribute
 
 ```ruby
-expect(locator).not_to have_attribute(name, value, ignoreCase: nil, timeout: nil)
+expect(locator).not_to have_attribute(name, value: nil, ignoreCase: nil, timeout: nil)
 ```
 
 
@@ -587,7 +587,7 @@ expect(locator).to have_accessible_name("Save to disk")
 ## to_have_attribute
 
 ```ruby
-expect(locator).to have_attribute(name, value, ignoreCase: nil, timeout: nil)
+expect(locator).to have_attribute(name, value: nil, ignoreCase: nil, timeout: nil)
 ```
 
 
@@ -598,6 +598,8 @@ Ensures the [Locator](./locator) points to an element with given attribute.
 ```ruby
 locator = page.locator("input")
 expect(locator).to have_attribute("type", "text")
+expect(locator).to have_attribute("disabled")
+expect(locator).not_to have_attribute("readonly")
 ```
 
 ## to_have_class

data/documentation/docs/api/page.md

@@ -112,6 +112,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -141,6 +142,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -201,6 +203,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -275,6 +278,7 @@ def drag_and_drop(
       target,
       force: nil,
       noWaitAfter: nil,
+      scroll: nil,
       sourcePosition: nil,
       steps: nil,
       strict: nil,
@@ -851,6 +855,9 @@ last redirect. If cannot go back, returns `null`.
 
 Navigate to the previous page in history.
 
+**NOTE**: **Testing Back/Forward Cache (BFCache) is not supported.**
+By default, Playwright disables the Back/Forward Cache across all browsers. Even if explicitly enabled, Playwright's internal state relies on network-level navigation events. Because BFCache restores unfreeze the DOM without firing these events, using `page.goBack()` or `page.goForward()` to trigger a BFCache restore will result in timeouts and a desynchronized [Page](./page) state.
+
 ## go_forward
 
 ```
@@ -863,6 +870,9 @@ last redirect. If cannot go forward, returns `null`.
 
 Navigate to the next page in history.
 
+**NOTE**: **Testing Back/Forward Cache (BFCache) is not supported.**
+By default, Playwright disables the Back/Forward Cache across all browsers. Even if explicitly enabled, Playwright's internal state relies on network-level navigation events. Because BFCache restores unfreeze the DOM without firing these events, using `page.goBack()` or `page.goForward()` to trigger a BFCache restore will result in timeouts and a desynchronized [Page](./page) state.
+
 ## goto
 
 ```
@@ -908,6 +918,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1416,6 +1427,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1546,6 +1558,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1615,6 +1628,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)

data/documentation/docs/api/playwright.md

@@ -11,7 +11,7 @@ to drive automation:
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   chromium = playwright.chromium # or "firefox" or "webkit".
   chromium.launch do |browser|
     page = browser.new_page
@@ -36,7 +36,7 @@ Returns a dictionary of devices to be used with [Browser#new_context](./browser#
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   iphone = playwright.devices["iPhone 6"]
   playwright.webkit.launch do |browser|
     context = browser.new_context(**iphone)

data/documentation/docs/article/getting_started.md

@@ -1,5 +1,6 @@
 ---
 sidebar_position: 0
+description: Install playwright-ruby-client with a compatible Playwright driver and run a first Ruby browser automation script.
 ---
 
 # Getting started
@@ -11,15 +12,17 @@ gem 'playwright-ruby-client'
 Add the line above and then `bundle install`.
 
 
-Since `playwright-ruby-client` doesn't include Playwright driver nor its downloader, **we have to install Playwright in advance**
+Since `playwright-ruby-client` doesn't include Playwright, **we have to install Node.js and a compatible `playwright-core` version in advance**.
 
 ```shell
-$ npx playwright install
+$ PLAYWRIGHT_CLI_VERSION=$(bundle exec ruby -e 'require "playwright/version"; puts Playwright::COMPATIBLE_PLAYWRIGHT_VERSION')
+$ npm install "playwright-core@$PLAYWRIGHT_CLI_VERSION"
+$ ./node_modules/.bin/playwright-core install
 ```
 
-and then set `playwright_cli_executable_path: "npx playwright"` into `Playwright.create`.
+Then set `playwright_cli_executable_path: './node_modules/.bin/playwright-core'` in `Playwright.create`.
 
-Other methods of installation are also available. See the detail in [Download Playwright driver](./guides/download_playwright_driver)
+See [Install Playwright CLI](./guides/download_playwright_driver) for details.
 
 ## Enjoy with examples
 
@@ -30,7 +33,7 @@ Navigate pages with `page.goto(url)` and save the screenshot with `page.screensh
 ```rb {6-7}
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   playwright.chromium.launch(headless: false) do |browser|
     page = browser.new_page
     page.goto('https://github.com/YusukeIwaki')
@@ -52,7 +55,7 @@ Extract data from a site.
 ```rb {12-14,17-21}
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   playwright.chromium.launch(headless: false) do |browser|
     page = browser.new_page
     page.goto('https://github.com/')
@@ -96,7 +99,7 @@ As an experimental feature, we can automate Chrome for Android.
 ```rb
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   devices = playwright.android.devices
   unless devices.empty?
     device = devices.last
@@ -130,12 +133,10 @@ end
 We have to download android-driver for Playwright in advance.
 
 ```shell
-$ wget https://github.com/microsoft/playwright/raw/master/bin/android-driver-target.apk -O /path/to/playwright-driver/package/bin/android-driver-target.apk
-$ wget https://github.com/microsoft/playwright/raw/master/bin/android-driver.apk -O /path/to/playwright-driver/package/bin/android-driver.apk
+$ wget https://github.com/microsoft/playwright/raw/master/bin/android-driver-target.apk -O ./node_modules/playwright-core/bin/android-driver-target.apk
+$ wget https://github.com/microsoft/playwright/raw/master/bin/android-driver.apk -O ./node_modules/playwright-core/bin/android-driver.apk
 ```
 
-(If you downloaded Playwright via npm, replace /path/to/playwright-driver/package/ with ./node_modules/playwright/ above.)
-
 ```rb
 require 'playwright'
 

data/documentation/docs/article/guides/download_playwright_driver.md

@@ -2,15 +2,11 @@
 sidebar_position: 1
 ---
 
-# Download Playwright driver
+# Install Playwright CLI
 
-`playwright-ruby-client` doesn't include Playwright driver nor its downloader. **We have to install Playwright in advance**, and set the proper CLI path like `Playwright.create(playwright_cli_executable_path: /path/to/playwright)`
+`playwright-ruby-client` doesn't include Playwright. Install Node.js and the compatible `playwright-core` npm package in advance, then pass its CLI path to `Playwright.create`.
 
-Choose any of the three ways as you prefer to download the driver:
-
-- `npx`: suitable for playground use, and not suitable for continuous usage.
-- `npm install`: the best choice for most use cases, with existing Node.js environment.
-- Direct download: maybe a good choice for Docker :whale: integration.
+The npm package version must match `Playwright::COMPATIBLE_PLAYWRIGHT_VERSION`. Using an unversioned `npx playwright` command can install an incompatible version.
 
 :::note
 
@@ -21,35 +17,18 @@ Also the article [Playwright on Alpine Linux](./playwright_on_alpine_linux) woul
 
 :::
 
-## Using `npx`
-
-```shell
-$ npx playwright install
-```
-
-and then set `playwright_cli_executable_path: "npx playwright"` at `Playwright.create`.
-
 ## Using `npm install`
 
-Actually `npx playwright` is a bit slow. We can also use `npm install` to setup.
-
-Instead of `npx playwright install`:
-
 ```shell
-$ export PLAYWRIGHT_CLI_VERSION=$(bundle exec ruby -e 'puts Playwright::COMPATIBLE_PLAYWRIGHT_VERSION.strip')
-$ npm install playwright@$PLAYWRIGHT_CLI_VERSION || npm install playwright@next
-$ ./node_modules/.bin/playwright install
+$ export PLAYWRIGHT_CLI_VERSION=$(bundle exec ruby -e 'require "playwright/version"; puts Playwright::COMPATIBLE_PLAYWRIGHT_VERSION')
+$ npm install "playwright-core@$PLAYWRIGHT_CLI_VERSION"
+$ ./node_modules/.bin/playwright-core install
 ```
 
-and then set `playwright_cli_executable_path: './node_modules/.bin/playwright'`
-
-## Directly download driver without Node.js installation.
+Then use the installed CLI when creating the Ruby client:
 
-Instead of npm, you can also directly download playwright driver from playwright.azureedge.net. (The URL can be easily detected from [here](https://github.com/microsoft/playwright-python/blob/cfc1030a69d1e934cac579687a680eac53d4b9ee/setup.py#L75))
-
-```shell
-$ export PLAYWRIGHT_CLI_VERSION=$(bundle exec ruby -e 'puts Playwright::COMPATIBLE_PLAYWRIGHT_VERSION.strip')
-$ wget https://playwright.azureedge.net/builds/driver/playwright-$PLAYWRIGHT_CLI_VERSION-linux.zip
+```ruby
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
+  # ...
+end
 ```
-
-and then extract it, and set `playwright_cli_executable_path: '/path/to/playwright-$PLAYWRIGHT_CLI_VERSION-linux/node /path/to/playwright-$PLAYWRIGHT_CLI_VERSION-linux/package/cli.js'`