playwright-ruby-client 1.15.beta1 → 1.15.1

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

@@ -2,9 +2,11 @@
 sidebar_position: 3
 ---
 
-# Integration into Ruby on Rails application
+# Capybara driver for Ruby on Rails application
 
-`playwright-ruby-client` is a client library just for browser automation. `capybara-playwright-driver` provides the [Capybara](https://github.com/teamcapybara/capybara) driver based on playwright-ruby-client and makes it easy to integrate into Ruby on Rails applications.
+`playwright-ruby-client` is a client library just for browser automation, while Rails uses [Capybara](https://github.com/teamcapybara/capybara) for system testing.
+
+`capybara-playwright-driver` provides a [Capybara](https://github.com/teamcapybara/capybara) driver based on playwright-ruby-client and makes it easy to integrate into Ruby on Rails applications.
 
 ## Installation
 

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

@@ -0,0 +1,86 @@
+---
+sidebar_position: 4
+---
+
+# Use Capybara without DSL
+
+:::note
+
+This article shows advanced-level configuration of Capybara and RSpec for more accurate automation/testing.
+If you want to just integrate Playwright into Rails application, refer the basic [configuration guide](./rails_integration)
+:::
+
+## Background
+
+[capybara-playwright-driver](./rails_integration) is easy to configure and migrate from Selenium or another Capybara driver, however it is a little **inaccurate** and would sometimes cause 'flaky test' problem originated from the internal implementation of Capybara DSL.
+
+Also **we cannot use most of useful Playwright features in Capybara driver**, such as auto-waiting, various kind of selectors, and some users would want to use Playwright features as it is without Capybara DSL.
+
+This article shows how to use playwright-ruby-client without Capybara DSL in Rails and RSpec.
+
+## Configure Capybara driver just for launching Rails server
+
+Capybara prepares the test server only when the configured driver returns true on `needs_server?` method. So we have to implement minimum driver like this:
+
+```ruby {5-7} title=spec/support/capybara_null_driver.rb
+RSpec.configure do |config|
+  require 'capybara'
+
+  class CapybaraNullDriver < Capybara::Driver::Base
+    def needs_server?
+      true
+    end
+  end
+
+  Capybara.register_driver(:null) { CapybaraNullDriver.new }
+
+  ...
+end
+```
+
+## Launch browser on each test
+
+Now Capybara DSL is unavailable with CapybaraNullDriver, we have to manually launch browsers using playwright-ruby-client.
+
+```rb
+RSpec.configure do |config|
+  require 'capybara'
+
+  ...
+
+  require 'playwright'
+
+  config.around(driver: :null) do |example|
+    Capybara.current_driver = :null
+
+    # Rails server is launched here, at the first time of accessing Capybara.current_session.server
+    base_url = Capybara.current_session.server.base_url
+
+    Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright') do |playwright|
+      # pass any option for Playwright#launch and Browser#new_page as you prefer.
+      playwright.chromium.launch(headless: false) do |browser|
+        @playwright_page = browser.new_page(baseURL: base_url)
+        example.run
+      end
+    end
+  end
+end
+```
+
+With the configuration above, we can describe system-test codes with native Playwright methods like below:
+
+```rb
+require 'rails_helper'
+
+describe 'example', driver: :null do
+  let!(:user) { FactoryBot.create(:user) }
+  let(:page) { @playwright_page }
+
+  it 'can browse' do
+    page.goto("/tests/#{user.id}")
+    page.wait_for_selector('input').type('hoge')
+    page.keyboard.press('Enter')
+    expect(page.text_content('#content')).to include('hoge')
+  end
+end
+```

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

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 10
 ---
 
 # Recording video

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

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 5
+sidebar_position: 20
 ---
 
 # Semi-automation

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

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 6
+sidebar_position: 21
 ---
 
 # Reuse Cookie and LocalStorage

data/documentation/docs/include/api_coverage.md

@@ -2,9 +2,12 @@
 
 ## Request
 
+* all_headers
 * failure
 * frame
 * headers
+* headers_array
+* header_value
 * navigation_request?
 * method
 * post_data
@@ -14,15 +17,20 @@
 * redirected_to
 * resource_type
 * response
+* sizes
 * timing
 * url
 
 ## Response
 
+* all_headers
 * body
 * finished
 * frame
 * headers
+* headers_array
+* header_value
+* header_values
 * json
 * ok
 * request
@@ -40,6 +48,13 @@
 * fulfill
 * request
 
+## FetchRequest
+
+* ~~dispose~~
+* ~~fetch~~
+* ~~get~~
+* ~~post~~
+
 ## WebSocket
 
 * closed?
@@ -62,6 +77,7 @@
 * down
 * move
 * up
+* wheel
 
 ## Touchscreen
 
@@ -108,6 +124,7 @@
 * scroll_into_view_if_needed
 * select_option
 * select_text
+* set_checked
 * set_input_files
 * tap_point
 * text_content
@@ -166,6 +183,7 @@
 * query_selector
 * query_selector_all
 * select_option
+* set_checked
 * set_content
 * set_input_files
 * tap_point
@@ -269,6 +287,7 @@
 * route
 * screenshot
 * select_option
+* set_checked
 * set_content
 * set_default_navigation_timeout
 * set_default_timeout
@@ -375,7 +394,9 @@
 ## Tracing
 
 * start
+* start_chunk
 * stop
+* stop_chunk
 
 ## Locator
 
@@ -414,6 +435,7 @@
 * scroll_into_view_if_needed
 * select_option
 * select_text
+* set_checked
 * set_input_files
 * tap_point
 * text_content

data/documentation/docusaurus.config.js

@@ -10,6 +10,7 @@ module.exports = {
   organizationName: 'YusukeIwaki', // Usually your GitHub org/user name.
   projectName: 'playwright-ruby-client', // Usually your repo name.
   themeConfig: {
+    image: 'img/playwright-ruby-client.png',
     navbar: {
       title: 'playwright-ruby-client',
       logo: {

data/documentation/package.json

@@ -14,8 +14,8 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.0",
-    "@docusaurus/preset-classic": "2.0.0-beta.0",
+    "@docusaurus/core": "^2.0.0-beta.5",
+    "@docusaurus/preset-classic": "^2.0.0-beta.5",
     "@mdx-js/react": "^1.6.21",
     "@svgr/webpack": "^5.5.0",
     "clsx": "^1.1.1",

data/documentation/src/pages/index.js

@@ -39,7 +39,6 @@ export default function Home() {
   const { siteConfig } = useDocusaurusContext();
   return (
     <Layout
-      title={siteConfig.title}
       description="Cross-browser end-to-end testing for modern web apps">
       <HomepageHeader />
       <main>