playwright-ruby-client 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05e5dff936dc4eda78a295d4f6935b5b92d6e82046de9a36c9f4b67aba24e89f
-  data.tar.gz: 85f30ee725facdc21d77645007cbeca689cd322dacb559146234fab1de0aab79
+  metadata.gz: 2e631604c0af31dc184fd1bfe6953be910d4f19be8613e8a2a11c83a3d5e9049
+  data.tar.gz: b320853082ae065cc09195f09e35f9a5bf18edc3105c729c9bd4a4daeb804948
 SHA512:
-  metadata.gz: 3c0fefff97e051805fb7d48aa134456d6a45ed5ab6b6818ea506251d93a1991c47bc6fc30aa1e2eae9369b1188564c08e23d083b6f8f8a896efe52d008cf6889
-  data.tar.gz: ebaf0d10fea440818cc182496b72c5ac16d192c76825db8aa271b89f891059b496ffdaaecdcfbaf7482ceb37ea868ac13feae678eee81b76c4e856f419627209
+  metadata.gz: 1ea608b469db2082b899c3b4c10cbfea703f222a79fb255a0d07d03eb46eacbd0274cb98c1c32a9241f120f5059bdb20fbc82a65a072c05e616bdbd4b76586aa
+  data.tar.gz: 50ea41552e79e96add337084c9a38961bae124dfcaf04c9fe3ab61ceb2cd5e8738f0ae6fffdb6e04157416593f351bc7177e03e0da75cf51a80e929e1bce3f42

data/documentation/docs/api/browser.md

@@ -76,6 +76,7 @@ Returns the newly created browser session.
 ```
 def new_context(
       acceptDownloads: nil,
+      baseURL: nil,
       bypassCSP: nil,
       colorScheme: nil,
       deviceScaleFactor: nil,
@@ -124,6 +125,7 @@ end
 ```
 def new_page(
       acceptDownloads: nil,
+      baseURL: nil,
       bypassCSP: nil,
       colorScheme: nil,
       deviceScaleFactor: nil,
@@ -164,7 +166,9 @@ testing frameworks should explicitly create [Browser#new_context](./browser#new_
 def start_tracing(page: nil, categories: nil, path: nil, screenshots: nil)
 ```
 
-> NOTE: Tracing is only supported on Chromium-based browsers.
+> NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
+which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be
+found [here](./tracing).
 
 You can use [Browser#start_tracing](./browser#start_tracing) and [Browser#stop_tracing](./browser#stop_tracing) to create a trace file that can be
 opened in Chrome DevTools performance panel.
@@ -185,7 +189,9 @@ end
 def stop_tracing
 ```
 
-> NOTE: Tracing is only supported on Chromium-based browsers.
+> NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
+which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be
+found [here](./tracing).
 
 Returns the buffer with trace data.
 

data/documentation/docs/api/browser_type.md

@@ -103,6 +103,7 @@ def launch_persistent_context(
       userDataDir,
       acceptDownloads: nil,
       args: nil,
+      baseURL: nil,
       bypassCSP: nil,
       channel: nil,
       chromiumSandbox: nil,

data/documentation/docs/api/experimental/android_device.md

@@ -28,6 +28,7 @@ Returns information about a widget defined by `selector`.
 ```
 def launch_browser(
       acceptDownloads: nil,
+      baseURL: nil,
       bypassCSP: nil,
       colorScheme: nil,
       command: nil,

data/documentation/docs/api/frame.md

@@ -196,6 +196,20 @@ frame.dispatch_event("#source", "dragstart", { "dataTransfer": data_transfer })
 
 
 
+## drag_and_drop
+
+```
+def drag_and_drop(
+      source,
+      target,
+      force: nil,
+      noWaitAfter: nil,
+      timeout: nil,
+      trial: nil)
+```
+
+
+
 ## eval_on_selector
 
 ```

data/documentation/docs/api/keyboard.md

@@ -12,35 +12,31 @@ to manually fire events as if they were generated from a real keyboard.
 
 An example of holding down `Shift` in order to select and delete some text:
 
-```python sync title=example_575870a45e4fe08d3e06be3420e8a11be03f85791cd8174f27198c016031ae72.py
+```ruby
 page.keyboard.type("Hello World!")
 page.keyboard.press("ArrowLeft")
 page.keyboard.down("Shift")
-for i in range(6):
-    page.keyboard.press("ArrowLeft")
+6.times { page.keyboard.press("ArrowLeft") }
 page.keyboard.up("Shift")
 page.keyboard.press("Backspace")
 # result text will end up saying "Hello!"
-
 ```
 
 An example of pressing uppercase `A`
 
-```python sync title=example_a4f00f0cd486431b7eca785304f4e9715522da45b66dda7f3a5f6899b889b9fd.py
+```ruby
 page.keyboard.press("Shift+KeyA")
 # or
 page.keyboard.press("Shift+A")
-
 ```
 
 An example to trigger select-all with the keyboard
 
-```python sync title=example_2deda0786a20a28cec9e8b438078a5fc567f7c7e5cf369419ab3c4d80a319ff6.py
+```ruby
 # on windows and linux
 page.keyboard.press("Control+A")
 # on mac_os
 page.keyboard.press("Meta+A")
-
 ```
 
 
@@ -84,9 +80,8 @@ def insert_text(text)
 
 Dispatches only `input` event, does not emit the `keydown`, `keyup` or `keypress` events.
 
-```python sync title=example_a9cc2667e9f3e3b8c619649d7e4a7f5db9463e0b76d67a5e588158093a9e9124.py
+```ruby
 page.keyboard.insert_text("嗨")
-
 ```
 
 > NOTE: Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper case.
@@ -114,17 +109,14 @@ texts.
 Shortcuts such as `key: "Control+o"` or `key: "Control+Shift+T"` are supported as well. When specified with the
 modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
-```python sync title=example_88943eb85c1ac7c261601e6edbdead07a31c2784326c496e10667ede1a853bab.py
-page = browser.new_page()
+```ruby
 page.goto("https://keycode.info")
 page.keyboard.press("a")
-page.screenshot(path="a.png")
+page.screenshot(path: "a.png")
 page.keyboard.press("ArrowLeft")
-page.screenshot(path="arrow_left.png")
+page.screenshot(path: "arrow_left.png")
 page.keyboard.press("Shift+O")
-page.screenshot(path="o.png")
-browser.close()
-
+page.screenshot(path: "o.png")
 ```
 
 Shortcut for [Keyboard#down](./keyboard#down) and [Keyboard#up](./keyboard#up).
@@ -139,10 +131,9 @@ Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in t
 
 To press a special key, like `Control` or `ArrowDown`, use [Keyboard#press](./keyboard#press).
 
-```python sync title=example_d9ced919f139961fd2b795c71375ca96f788a19c1f8e1479c5ec905fb5c02d43.py
+```ruby
 page.keyboard.type("Hello") # types instantly
-page.keyboard.type("World", delay=100) # types slower, like a user
-
+page.keyboard.type("World", delay: 100) # types slower, like a user
 ```
 
 > NOTE: Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case.

data/documentation/docs/api/page.md

@@ -253,6 +253,20 @@ page.dispatch_event("#source", "dragstart", eventInit: { dataTransfer: data_tran
 
 
 
+## drag_and_drop
+
+```
+def drag_and_drop(
+      source,
+      target,
+      force: nil,
+      noWaitAfter: nil,
+      timeout: nil,
+      trial: nil)
+```
+
+
+
 ## emulate_media
 
 ```
@@ -1320,7 +1334,7 @@ Performs action and waits for a popup [Page](./page). If predicate is provided,
 def expect_request(urlOrPredicate, timeout: nil, &block)
 ```
 
-Waits for the matching request and returns it.  See [waiting for event](https://playwright.dev/python/docs/events) for more details
+Waits for the matching request and returns it. See [waiting for event](https://playwright.dev/python/docs/events) for more details
 about events.
 
 ```ruby

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

@@ -0,0 +1,91 @@
+---
+sidebar_position: 6
+---
+
+# Playwright on Alpine Linux
+
+**NOTE: This feature is EXPERIMENTAL.**
+
+Playwright actually requires a permission for shell command execution, and many run-time dependencies for each browser.
+
+![all-in-one](https://user-images.githubusercontent.com/11763113/124934388-9c9c9100-e03f-11eb-8f13-324afac3be2a.png)
+
+This all-in-one architecture is reasonable for browser automation in our own computers.
+
+However we may have trouble with bringing Playwright into:
+
+* Docker
+  * Alpine Linux
+* Serverless computing
+  * AWS Lambda
+  * Google Cloud Functions
+* PaaS
+  * Heroku
+  * Google App Engine
+
+This article introduces a way to separate environments into client (for executing Playwright script) and server (for working with browsers). The main use-case assumes Docker (using Alpine Linux), however the way can be applied also into other use-cases.
+
+## Overview
+
+Playwrignt Ruby client is running on Alpine Linux. It just sends/receives JSON messages of Playwright-protocol via WebSocket.
+
+Playwright server is running on a container of [official Docker image](https://hub.docker.com/_/microsoft-playwright). It just operates browsers in response to the JSON messages from WebSocket.
+
+![overview](https://user-images.githubusercontent.com/11763113/124934448-ad4d0700-e03f-11eb-942e-b9f3282bb703.png)
+
+## Playwright client
+
+Many example uses `Playwright#create`, which internally uses Pipe (stdin/stdout) transport for Playwright-protocol messaging. Instead, **just use `Playwright#connect_to_playwright_server(endpoint)`** for WebSocket transport.
+
+```ruby {3}
+require 'playwright'
+
+Playwright.connect_to_playwright_server('wss://example.com:8888/ws') do |playwright|
+  playwright.chromium.launch do |browser|
+    page = browser.new_page
+    page.goto('https://github.com/microsoft/playwright')
+    page.screenshot(path: 'github-microsoft-playwright.png')
+  end
+end
+```
+
+`wss://example.com:8888/ws` is an example of endpoint URL of the Playwright server. In local development environment, it is typically `"ws://127.0.0.1:#{port}/ws"`.
+
+## Playwright server
+
+With the [official Docker image](https://hub.docker.com/_/microsoft-playwright) or in the local development environment with Node.js, just execute `npx playwright install && npx playwright run-server $PORT`. (`$PORT` is a port number of the server)
+
+If custom Docker image is preferred, build it as follows:
+
+```Dockerfile
+FROM mcr.microsoft.com/playwright:focal
+
+WORKDIR /root
+RUN npm install playwright@1.12.3 && ./node_modules/.bin/playwright install
+
+ENV PORT 8888
+CMD ["./node_modules/.bin/playwright", "run-server", "$PORT"]
+```
+
+## Debugging for connection
+
+The client and server are really quiet. This chapter shows how to check if the communication on the WebSocket works well or not.
+
+### Show JSON message on client
+
+Just set an environment variable `DEBUG=1`.
+
+```
+DEBUG=1 bundle exec ruby some-automation-with-playwright.rb
+```
+
+
+### Enable verbose logging on server
+
+Just set an environment variable `DEBUG=pw:*` or `DEBUG=pw:server`
+
+```
+DEBUG=pw:* npx playwright run-server 8888
+```
+
+See [the official documentation](https://playwright.dev/docs/debug/#verbose-api-logs) for details.

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

@@ -1,3 +1,7 @@
+---
+sidebar_position: 5
+---
+
 # Semi-automation
 
 Playwright Browser context is isolated and not persisted by default. But we can also use persistent browser context using [BrowserType#launch_persistent_context](/docs/api/browser_type#launch_persistent_context).

data/documentation/docs/include/api_coverage.md

@@ -38,7 +38,6 @@
 * abort
 * continue
 * fulfill
-* ~~intercept~~
 * request
 
 ## WebSocket
@@ -138,6 +137,7 @@
 * content
 * dblclick
 * dispatch_event
+* drag_and_drop
 * eval_on_selector
 * eval_on_selector_all
 * evaluate
@@ -218,6 +218,7 @@
 * context
 * dblclick
 * dispatch_event
+* drag_and_drop
 * emulate_media
 * eval_on_selector
 * eval_on_selector_all

data/lib/playwright/channel_owners/artifact.rb

@@ -26,5 +26,9 @@ module Playwright
     def delete
       @channel.send_message_to_server('delete')
     end
+
+    def cancel
+      @channel.send_message_to_server('cancel')
+    end
   end
 end

data/lib/playwright/channel_owners/browser_context.rb

@@ -8,7 +8,7 @@ module Playwright
 
     private def after_initialize
       @pages = Set.new
-      @routes = Set.new
+      @routes = []
       @bindings = {}
       @timeout_settings = TimeoutSettings.new
 
@@ -210,8 +210,8 @@ module Playwright
     end
 
     def route(url, handler)
-      entry = RouteHandlerEntry.new(url, handler)
-      @routes << entry
+      entry = RouteHandlerEntry.new(url, base_url, handler)
+      @routes.unshift(entry)
       if @routes.count >= 1
         @channel.send_message_to_server('setNetworkInterceptionEnabled', enabled: true)
       end
@@ -275,5 +275,9 @@ module Playwright
     private def has_record_video_option?
       @options.key?(:recordVideo)
     end
+
+    private def base_url
+      @options[:baseURL]
+    end
   end
 end

data/lib/playwright/channel_owners/frame.rb

@@ -71,7 +71,7 @@ module Playwright
 
       predicate =
         if url
-          matcher = UrlMatcher.new(url)
+          matcher = UrlMatcher.new(url, base_url: @page.context.send(:base_url))
           ->(event) { event['error'] || matcher.match?(event['url']) }
         else
           ->(_) { true }
@@ -99,7 +99,7 @@ module Playwright
     end
 
     def wait_for_url(url, timeout: nil, waitUntil: nil)
-      matcher = UrlMatcher.new(url)
+      matcher = UrlMatcher.new(url, base_url: @page.context.send(:base_url))
       if matcher.match?(@url)
         wait_for_load_state(state: waitUntil, timeout: timeout)
       else
@@ -293,6 +293,26 @@ module Playwright
       nil
     end
 
+    def drag_and_drop(
+          source,
+          target,
+          force: nil,
+          noWaitAfter: nil,
+          timeout: nil,
+          trial: nil)
+      params = {
+        source: source,
+        target: target,
+        force: force,
+        noWaitAfter: noWaitAfter,
+        timeout: timeout,
+        trial: trial,
+      }.compact
+      @channel.send_message_to_server('dragAndDrop', params)
+
+      nil
+    end
+
     def dblclick(
           selector,
           button: nil,

data/lib/playwright/channel_owners/page.rb

@@ -22,7 +22,7 @@ module Playwright
       end
       @closed = false
       @bindings = {}
-      @routes = Set.new
+      @routes = []
 
       @main_frame = ChannelOwners::Frame.from(@initializer['mainFrame'])
       @main_frame.send(:update_page_from_page, self)
@@ -184,15 +184,8 @@ module Playwright
       if name
         @frames.find { |f| f.name == name }
       elsif url
-        # ref: https://github.com/microsoft/playwright-python/blob/c4320c27cb080b385a5e45be46baa3cb7a9409ff/playwright/_impl/_helper.py#L104
-        case url
-        when String
-          @frames.find { |f| f.url == url }
-        when Regexp
-          @frames.find { |f| url.match?(f.url) }
-        else
-          raise NotImplementedError.new('Page#frame with url is not completely implemented yet')
-        end
+        matcher = UrlMatcher.new(url, base_url: @browser_context.send(:base_url))
+        @frames.find { |f| matcher.match?(f.url) }
       else
         raise ArgumentError.new('Either name or url matcher should be specified')
       end
@@ -377,8 +370,8 @@ module Playwright
     end
 
     def route(url, handler)
-      entry = RouteHandlerEntry.new(url, handler)
-      @routes << entry
+      entry = RouteHandlerEntry.new(url, @browser_context.send(:base_url), handler)
+      @routes.unshift(entry)
       if @routes.count >= 1
         @channel.send_message_to_server('setNetworkInterceptionEnabled', enabled: true)
       end
@@ -463,6 +456,23 @@ module Playwright
       )
     end
 
+    def drag_and_drop(
+          source,
+          target,
+          force: nil,
+          noWaitAfter: nil,
+          timeout: nil,
+          trial: nil)
+
+      @main_frame.drag_and_drop(
+        source,
+        target,
+        force: force,
+        noWaitAfter: noWaitAfter,
+        timeout: timeout,
+        trial: trial)
+    end
+
     def dblclick(
           selector,
           button: nil,
@@ -759,7 +769,7 @@ module Playwright
       predicate =
         case urlOrPredicate
         when String, Regexp
-          url_matcher = UrlMatcher.new(urlOrPredicate)
+          url_matcher = UrlMatcher.new(urlOrPredicate, base_url: @browser_context.send(:base_url))
           -> (req){ url_matcher.match?(req.url) }
         when Proc
           urlOrPredicate
@@ -778,7 +788,7 @@ module Playwright
       predicate =
         case urlOrPredicate
         when String, Regexp
-          url_matcher = UrlMatcher.new(urlOrPredicate)
+          url_matcher = UrlMatcher.new(urlOrPredicate, base_url: @browser_context.send(:base_url))
           -> (req){ url_matcher.match?(req.url) }
         when Proc
           urlOrPredicate

data/lib/playwright/download.rb

@@ -24,5 +24,9 @@ module Playwright
     def save_as(path)
       @artifact.save_as(path)
     end
+
+    def cancel
+      @artifact.cancel
+    end
   end
 end

data/lib/playwright/route_handler_entry.rb

@@ -1,10 +1,11 @@
 module Playwright
   class RouteHandlerEntry
     # @param url [String]
+    # @param base_url [String|nil]
     # @param handler [Proc]
-    def initialize(url, handler)
+    def initialize(url, base_url, handler)
       @url_value = url
-      @url_matcher = UrlMatcher.new(url)
+      @url_matcher = UrlMatcher.new(url, base_url: base_url)
       @handler = handler
     end
 

data/lib/playwright/url_matcher.rb

@@ -1,19 +1,29 @@
 module Playwright
   class UrlMatcher
     # @param url [String|Regexp]
-    def initialize(url)
+    # @param base_url [String|nil]
+    def initialize(url, base_url:)
       @url = url
+      @base_url = base_url
     end
 
     def match?(target_url)
       case @url
       when String
-        @url == target_url || File.fnmatch?(@url, target_url)
+        joined_url == target_url || File.fnmatch?(@url, target_url)
       when Regexp
         @url.match?(target_url)
       else
         false
       end
     end
+
+    private def joined_url
+      if @base_url && !@url.start_with?('*')
+        URI.join(@base_url, @url).to_s
+      else
+        @url
+      end
+    end
   end
 end

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '0.8.0'
+  VERSION = '0.8.1'
   COMPATIBLE_PLAYWRIGHT_VERSION = '1.13.0'
 end

data/lib/playwright_api/android_device.rb

@@ -40,6 +40,7 @@ module Playwright
     # Launches Chrome browser on the device, and returns its persistent context.
     def launch_browser(
           acceptDownloads: nil,
+          baseURL: nil,
           bypassCSP: nil,
           colorScheme: nil,
           command: nil,
@@ -65,7 +66,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.launch_browser(acceptDownloads: unwrap_impl(acceptDownloads), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), command: unwrap_impl(command), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.launch_browser(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), command: unwrap_impl(command), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     # Performs a long tap on the widget defined by `selector`.

data/lib/playwright_api/browser.rb

@@ -65,6 +65,7 @@ module Playwright
     # ```
     def new_context(
           acceptDownloads: nil,
+          baseURL: nil,
           bypassCSP: nil,
           colorScheme: nil,
           deviceScaleFactor: nil,
@@ -91,7 +92,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.new_context(acceptDownloads: unwrap_impl(acceptDownloads), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), storageState: unwrap_impl(storageState), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.new_context(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), storageState: unwrap_impl(storageState), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     # Creates a new page in a new browser context. Closing this page will close the context as well.
@@ -101,6 +102,7 @@ module Playwright
     # [`method: BrowserContext.newPage`] to control their exact life times.
     def new_page(
           acceptDownloads: nil,
+          baseURL: nil,
           bypassCSP: nil,
           colorScheme: nil,
           deviceScaleFactor: nil,
@@ -127,10 +129,12 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.new_page(acceptDownloads: unwrap_impl(acceptDownloads), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), storageState: unwrap_impl(storageState), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.new_page(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), storageState: unwrap_impl(storageState), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
-    # > NOTE: Tracing is only supported on Chromium-based browsers.
+    # > NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
+    # which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](../trace-viewer) could be
+    # found [here](./class-tracing).
     #
     # You can use [`method: Browser.startTracing`] and [`method: Browser.stopTracing`] to create a trace file that can be
     # opened in Chrome DevTools performance panel.
@@ -144,7 +148,9 @@ module Playwright
       wrap_impl(@impl.start_tracing(page: unwrap_impl(page), categories: unwrap_impl(categories), path: unwrap_impl(path), screenshots: unwrap_impl(screenshots)))
     end
 
-    # > NOTE: Tracing is only supported on Chromium-based browsers.
+    # > NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
+    # which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](../trace-viewer) could be
+    # found [here](./class-tracing).
     #
     # Returns the buffer with trace data.
     def stop_tracing

data/lib/playwright_api/browser_type.rb

@@ -96,6 +96,7 @@ module Playwright
           userDataDir,
           acceptDownloads: nil,
           args: nil,
+          baseURL: nil,
           bypassCSP: nil,
           channel: nil,
           chromiumSandbox: nil,
@@ -135,7 +136,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.launch_persistent_context(unwrap_impl(userDataDir), acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), bypassCSP: unwrap_impl(bypassCSP), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), devtools: unwrap_impl(devtools), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), hasTouch: unwrap_impl(hasTouch), headless: unwrap_impl(headless), httpCredentials: unwrap_impl(httpCredentials), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), timezoneId: unwrap_impl(timezoneId), tracesDir: unwrap_impl(tracesDir), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.launch_persistent_context(unwrap_impl(userDataDir), acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), devtools: unwrap_impl(devtools), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), hasTouch: unwrap_impl(hasTouch), headless: unwrap_impl(headless), httpCredentials: unwrap_impl(httpCredentials), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), timezoneId: unwrap_impl(timezoneId), tracesDir: unwrap_impl(tracesDir), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     # Returns browser name. For example: `'chromium'`, `'webkit'` or `'firefox'`.

data/lib/playwright_api/frame.rb

@@ -160,6 +160,16 @@ module Playwright
       wrap_impl(@impl.dispatch_event(unwrap_impl(selector), unwrap_impl(type), eventInit: unwrap_impl(eventInit), timeout: unwrap_impl(timeout)))
     end
 
+    def drag_and_drop(
+          source,
+          target,
+          force: nil,
+          noWaitAfter: nil,
+          timeout: nil,
+          trial: nil)
+      wrap_impl(@impl.drag_and_drop(unwrap_impl(source), unwrap_impl(target), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout), trial: unwrap_impl(trial)))
+    end
+
     # Returns the return value of `expression`.
     #
     # The method finds an element matching the specified selector within the frame and passes it as a first argument to

data/lib/playwright_api/page.rb

@@ -233,6 +233,16 @@ module Playwright
       wrap_impl(@impl.dispatch_event(unwrap_impl(selector), unwrap_impl(type), eventInit: unwrap_impl(eventInit), timeout: unwrap_impl(timeout)))
     end
 
+    def drag_and_drop(
+          source,
+          target,
+          force: nil,
+          noWaitAfter: nil,
+          timeout: nil,
+          trial: nil)
+      wrap_impl(@impl.drag_and_drop(unwrap_impl(source), unwrap_impl(target), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout), trial: unwrap_impl(trial)))
+    end
+
     # This method changes the `CSS media type` through the `media` argument, and/or the `'prefers-colors-scheme'` media
     # feature, using the `colorScheme` argument.
     #
@@ -1149,7 +1159,7 @@ module Playwright
       wrap_impl(@impl.expect_popup(predicate: unwrap_impl(predicate), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
     end
 
-    # Waits for the matching request and returns it.  See [waiting for event](./events.md#waiting-for-event) for more details
+    # Waits for the matching request and returns it. See [waiting for event](./events.md#waiting-for-event) for more details
     # about events.
     #
     # ```python sync

data/lib/playwright_api/route.rb

@@ -51,11 +51,6 @@ module Playwright
       wrap_impl(@impl.fulfill(body: unwrap_impl(body), contentType: unwrap_impl(contentType), headers: unwrap_impl(headers), path: unwrap_impl(path), status: unwrap_impl(status)))
     end
 
-    # Continues route's request with optional overrides and intercepts response.
-    def intercept(headers: nil, method: nil, postData: nil, url: nil)
-      raise NotImplementedError.new('intercept is not implemented yet.')
-    end
-
     # A request to be routed.
     def request
       wrap_impl(@impl.request)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-07-09 00:00:00.000000000 Z
+date: 2021-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -243,6 +243,7 @@ files:
 - documentation/docs/article/guides/_category_.yml
 - documentation/docs/article/guides/download_playwright_driver.md
 - documentation/docs/article/guides/launch_browser.md
+- documentation/docs/article/guides/playwright_on_alpine_linux.md
 - documentation/docs/article/guides/rails_integration.md
 - documentation/docs/article/guides/recording_video.md
 - documentation/docs/article/guides/semi_automation.md