🎭 Playwright client for Ruby

Docs | API

Getting Started

gem 'playwright-ruby-client'

and then 'bundle install'.

Since playwright-ruby-client doesn't include the playwright driver, we have to install playwright in advance.

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

Capture a site

require'playwright'Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright')do |playwright|
playwright.chromium.launch(headless: false)do |browser|
page=browser.new_pagepage.goto('https://github.com/YusukeIwaki')page.screenshot(path: './YusukeIwaki.png')endend

Simple scraping

require'playwright'Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright')do |playwright|
playwright.chromium.launch(headless: false)do |browser|
page=browser.new_pagepage.goto('https://github.com/')page.get_by_placeholder("Search or jump to...").clickpage.locator('input[name="query-builder-test"]').clickexpect(page.keyboard).tobe_a(::Playwright::Keyboard)page.keyboard.type("playwright")page.expect_navigation{page.keyboard.press("Enter")}list=page.get_by_test_id('results-list').locator('.search-title')# wait for item to appearlist.first.wait_for# list themlist.locator('.search-title').all.eachdo |item|
title=item.text_contentputs("==> #{title}")endendend

$ bundle exec ruby main.rb
==> microsoft/playwright
==> microsoft/playwright-python
==> microsoft/playwright-cli
==> checkly/headless-recorder
==> microsoft/playwright-sharp
==> playwright-community/jest-playwright
==> microsoft/playwright-test
==> mxschmitt/playwright-go
==> microsoft/playwright-java
==> MarketSquare/robotframework-browser

Android browser automation

require'playwright'Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright')do |playwright|
devices=playwright.android.devicesunlessdevices.empty?device=devices.lastbeginputs"Model: #{device.model}"puts"Serial: #{device.serial}"putsdevice.shell('ls /system')device.launch_browserdo |context|
page=context.pages.firstpage.goto('https://github.com/YusukeIwaki')page.click('header button')page.click('input[name="q"]')page.keyboard.type('puppeteer')page.expect_navigation{page.keyboard.press('Enter')}page.screenshot(path: 'YusukeIwaki.android.png')endensuredevice.closeendendend

Android native automation

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

(If you downloaded Playwright via npm, replace /path/to/playwright-driver/package/ with ./node_modules/playwright/ above.)

require'playwright'Playwright.create(playwright_cli_executable_path: ENV['PLAYWRIGHT_CLI_EXECUTABLE_PATH'])do |playwright|
devices=playwright.android.devicesunlessdevices.empty?device=devices.lastbegindevice.shell('input keyevent POWER')device.shell('input keyevent POWER')device.shell('input keyevent 82')sleep1device.shell('cmd statusbar expand-notifications')# pp device.tree# pp device.info(res: 'com.android.systemui:id/clock')device.tap_on(res: 'com.android.systemui:id/clock')ensuredevice.closeendendend

Communicate with Playwright server

If your environment doesn't accept installing browser or creating browser process, consider separating Ruby client and Playwright server.

For launching Playwright server, just execute:

npx playwright install && npx playwright run-server --port 8080 --path /ws

and we can connect to the server with the code like this:

require'playwright'Playwright.connect_to_browser_server('wss://example.com:8888/ws')do |browser|
page=browser.new_pagepage.goto('https://github.com/YusukeIwaki')page.screenshot(path: './YusukeIwaki.png')end

When Playwright.connect_to_browser_server is used, playwright_cli_executable_path is not required.

For more detailed instraction, refer this article: https://playwright-ruby-client.vercel.app/docs/article/guides/playwright_on_alpine_linux

Contributing

See CONTRIBUTING.md for development setup and contributing guidelines.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Playwright project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.