playwright-ruby-client 1.19.0 → 1.20.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfbbc528927aa551597f30f0abb057a13609726f473cfd6c625a97d135d0b705
-  data.tar.gz: f3f8dda3439bfaa0d3a8796ee8ed6eb453ae9934e9bf0b1768a8a0c9a62d5e4f
+  metadata.gz: a0ac92a21e56cb8136a67c37b4f0a7f5edd5668124c8f54a7d676fd384568fd6
+  data.tar.gz: 8d1f15d0f9c3dfc190d0cc0976814ab6bf90a927af722d4164861e57c93564a2
 SHA512:
-  metadata.gz: 14e62113089e96e77fd11dabdda86582ac5c4004465a4007396b71a954927396e1a77c5abf2c10199e43b41b119a5879bbdf491400ec8de5d9f1bd2b3da19ef8
-  data.tar.gz: 6ee4b4854cf14ba4cd1cad9dd4c847cea5dea58c892298e15daecce174754b35beccfaff8386f9c97ca103d500aeea476f82c232fa88291741d075685d2fc789
+  metadata.gz: 746dcb1563f9777c374572d2b7ecfbde7833a3ce1b546933958ae920a417d1e474e27c8b569b3fc25cc117735e07bdb420dec838baadebe6375ab83d13c959bd
+  data.tar.gz: a9dca767fdfec65ba0ef854677e600ef00fabfbdd60ad534fb5182e292c603eb4cbb1b1eb77440f85415d5189bce902d3899389033c591f6e1d1d925de67afc4

data/README.md

@@ -162,7 +162,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 8080
+npx playwright install && npx playwright run-server --port 8080
 ```
 
 and we can connect to the server with the code like this:

data/documentation/docs/api/element_handle.md

@@ -435,6 +435,8 @@ The method finds all elements matching the specified selector in the [ElementHan
 
 ```
 def screenshot(
+      animations: nil,
+      mask: nil,
       omitBackground: nil,
       path: nil,
       quality: nil,

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

@@ -33,7 +33,7 @@ PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm i -D playwright
 ## devices
 
 ```
-def devices
+def devices(port: nil)
 ```
 
 Returns the list of detected Android devices.

data/documentation/docs/api/locator.md

@@ -325,6 +325,15 @@ def get_attribute(name, timeout: nil)
 
 Returns element attribute value.
 
+## highlight
+
+```
+def highlight
+```
+
+Highlight the corresponding element(s) on the screen. Useful for debugging, don't commit the code that uses
+[Locator#highlight](./locator#highlight).
+
 ## hover
 
 ```
@@ -480,6 +489,8 @@ modifier, modifier is pressed and being held while the subsequent key is being p
 
 ```
 def screenshot(
+      animations: nil,
+      mask: nil,
       omitBackground: nil,
       path: nil,
       quality: nil,

data/documentation/docs/api/page.md

@@ -1012,8 +1012,10 @@ To remove a route with its handler you can use [Page#unroute](./page#unroute).
 
 ```
 def screenshot(
+      animations: nil,
       clip: nil,
       fullPage: nil,
+      mask: nil,
       omitBackground: nil,
       path: nil,
       quality: nil,
@@ -1167,9 +1169,10 @@ alias: `viewport_size=`
 In the case of multiple pages in a single browser, each page can have its own viewport size. However,
 [Browser#new_context](./browser#new_context) allows to set viewport size (and more) for all pages in the context at once.
 
-`page.setViewportSize` will resize the page. A lot of websites don't expect phones to change size, so you should set the
-viewport size before navigating to the page. [Page#set_viewport_size](./page#set_viewport_size) will also reset `screen` size, use
-[Browser#new_context](./browser#new_context) with `screen` and `viewport` parameters if you need better control of these properties.
+[Page#set_viewport_size](./page#set_viewport_size) will resize the page. A lot of websites don't expect phones to change size, so you
+should set the viewport size before navigating to the page. [Page#set_viewport_size](./page#set_viewport_size) will also reset `screen`
+size, use [Browser#new_context](./browser#new_context) with `screen` and `viewport` parameters if you need better control of these
+properties.
 
 ```ruby
 page.viewport_size = { width: 640, height: 480 }

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

@@ -27,7 +27,7 @@ This article introduces a way to separate environments into client (for executin
 
 ## Overview
 
-Playwrignt Ruby client is running on Alpine Linux. It just sends/receives JSON messages of Playwright-protocol via WebSocket.
+Playwright 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.
 
@@ -69,7 +69,7 @@ end
 
 ### Server code
 
-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)
+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 --path /ws`. (`$PORT` is a port number of the server)
 
 If custom Docker image is preferred, build it as follows:
 
@@ -80,7 +80,7 @@ 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"]
+CMD ["./node_modules/.bin/playwright", "run-server", "--port", "$PORT", "--path", "/ws"]
 ```
 
 ## Browser server/client
@@ -100,7 +100,7 @@ end
 
 ### Server code
 
-For instant use, `npx playwright launch-server chromium` generates a WebSocket endpoint URL with a random path.
+For instant use, `npx playwright launch-server --browser chromium` generates a WebSocket endpoint URL with a random path.
 
 More customization can be done by implementing JavaScript server like below:
 
@@ -138,7 +138,7 @@ DEBUG=1 bundle exec ruby some-automation-with-playwright.rb
 Just set an environment variable `DEBUG=pw:*` or `DEBUG=pw:server`
 
 ```
-DEBUG=pw:* npx playwright run-server 8888
+DEBUG=pw:* npx playwright run-server --port 8888 --path /ws
 ```
 
 See [the official documentation](https://playwright.dev/docs/debug/#verbose-api-logs) for details.

data/documentation/docs/include/api_coverage.md

@@ -417,6 +417,7 @@
 * focus
 * frame_locator
 * get_attribute
+* highlight
 * hover
 * inner_html
 * inner_text

data/lib/playwright/channel_owners/android.rb

@@ -4,8 +4,8 @@ module Playwright
       @timeout_settings = TimeoutSettings.new
     end
 
-    def devices
-      resp = @channel.send_message_to_server('devices')
+    def devices(port: nil)
+      resp = @channel.send_message_to_server('devices', port: port)
       resp.map { |device| ChannelOwners::AndroidDevice.from(device) }
     end
   end

data/lib/playwright/channel_owners/browser_context.rb

@@ -13,6 +13,7 @@ module Playwright
       @timeout_settings = TimeoutSettings.new
       @service_workers = Set.new
       @background_pages = Set.new
+      @owner_page = nil
 
       @tracing = ChannelOwners::Tracing.from(@initializer['tracing'])
       @request = ChannelOwners::APIRequestContext.from(@initializer['APIRequestContext'])

data/lib/playwright/channel_owners/element_handle.rb

@@ -281,6 +281,8 @@ module Playwright
       end
 
       def screenshot(
+        animations: nil,
+        mask: nil,
         omitBackground: nil,
         path: nil,
         quality: nil,
@@ -288,12 +290,18 @@ module Playwright
         type: nil)
 
         params = {
+          animations: animations,
           omitBackground: omitBackground,
           path: path,
           quality: quality,
           timeout: timeout,
           type: type,
         }.compact
+        if mask.is_a?(Enumerable)
+          params[:mask] = mask.map do |locator|
+            locator.send(:to_protocol)
+          end
+        end
         encoded_binary = @channel.send_message_to_server('screenshot', params)
         decoded_binary = Base64.strict_decode64(encoded_binary)
         if path

data/lib/playwright/channel_owners/frame.rb

@@ -615,6 +615,10 @@ module Playwright
       @channel.send_message_to_server('title')
     end
 
+    def highlight(selector)
+      @channel.send_message_to_server('highlight', selector: selector)
+    end
+
     # @param page [Page]
     # @note This method should be used internally. Accessed via .send method, so keep private!
     private def update_page_from_page(page)

data/lib/playwright/channel_owners/page.rb

@@ -414,6 +414,8 @@ module Playwright
       fullPage: nil,
       clip: nil,
       omitBackground: nil,
+      animations: nil,
+      mask: nil,
       timeout: nil)
 
       params = {
@@ -422,8 +424,14 @@ module Playwright
         fullPage: fullPage,
         clip: clip,
         omitBackground: omitBackground,
+        animations: animations,
         timeout: timeout,
       }.compact
+      if mask.is_a?(Enumerable)
+        params[:mask] = mask.map do |locator|
+          locator.send(:to_protocol)
+        end
+      end
       encoded_binary = @channel.send_message_to_server('screenshot', params)
       decoded_binary = Base64.strict_decode64(encoded_binary)
       if path

data/lib/playwright/locator_impl.rb

@@ -55,6 +55,13 @@ module Playwright
       "Locator@#{@selector}"
     end
 
+    private def to_protocol
+      {
+        frame: @frame.channel,
+        selector: @selector,
+      }
+    end
+
     class DifferentFrameError < StandardError
       def initialize
         super('Inner "has" locator must belong to the same frame.')
@@ -306,6 +313,8 @@ module Playwright
     end
 
     def screenshot(
+          animations: nil,
+          mask: nil,
           omitBackground: nil,
           path: nil,
           quality: nil,
@@ -313,6 +322,8 @@ module Playwright
           type: nil)
       with_element(timeout: timeout) do |handle, options|
         handle.screenshot(
+          animations: animations,
+          mask: mask,
           omitBackground: omitBackground,
           path: path,
           quality: quality,
@@ -416,5 +427,9 @@ module Playwright
     def all_text_contents
       @frame.eval_on_selector_all(@selector, "ee => ee.map(e => e.textContent || '')")
     end
+
+    def highlight
+      @frame.highlight(@selector)
+    end
   end
 end

data/lib/playwright/route_handler.rb

@@ -51,9 +51,11 @@ module Playwright
       @counter.increment
 
       Concurrent::Promises.future do
-        @handler.call(route, request)
-      rescue => err
-        puts err, err.backtrace
+        begin
+          @handler.call(route, request)
+        rescue => err
+          puts err, err.backtrace
+        end
       end
     end
 

data/lib/playwright/transport.rb

@@ -46,7 +46,8 @@ module Playwright
     #
     # @note This method blocks until playwright-cli exited. Consider using Thread or Future.
     def async_run
-      @stdin, @stdout, @stderr, @thread = Open3.popen3("#{@driver_executable_path} run-driver", { pgroup: true })
+      popen3_args = {}
+      @stdin, @stdout, @stderr, @thread = run_driver_with_open3
       @stdin.binmode  # Ensure Strings are written 1:1 without encoding conversion, necessary for integer values
 
       Thread.new { handle_stdout }
@@ -55,6 +56,18 @@ module Playwright
 
     private
 
+    def run_driver_with_open3
+      Open3.popen3("#{@driver_executable_path} run-driver", { pgroup: true })
+    rescue ArgumentError => err
+      # Windows doesn't accept pgroup parameter.
+      # ArgumentError: wrong exec option symbol: pgroup
+      if err.message =~ /pgroup/
+        Open3.popen3("#{@driver_executable_path} run-driver")
+      else
+        raise
+      end
+    end
+
     def handle_stdout(packet_size: 32_768)
       while chunk = @stdout.read(4)
         length = chunk.unpack1('V') # unsigned 32bit, little endian

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '1.19.0'
-  COMPATIBLE_PLAYWRIGHT_VERSION = '1.19.0'
+  VERSION = '1.20.1'
+  COMPATIBLE_PLAYWRIGHT_VERSION = '1.20.1'
 end

data/lib/playwright_api/android.rb

@@ -26,8 +26,8 @@ module Playwright
   class Android < PlaywrightApi
 
     # Returns the list of detected Android devices.
-    def devices
-      wrap_impl(@impl.devices)
+    def devices(port: nil)
+      wrap_impl(@impl.devices(port: unwrap_impl(port)))
     end
 
     # This setting will change the default maximum time for all the methods accepting `timeout` option.

data/lib/playwright_api/element_handle.rb

@@ -346,12 +346,14 @@ module Playwright
     # This method waits for the [actionability](./actionability.md) checks, then scrolls element into view before taking a
     # screenshot. If the element is detached from DOM, the method throws an error.
     def screenshot(
+          animations: nil,
+          mask: nil,
           omitBackground: nil,
           path: nil,
           quality: nil,
           timeout: nil,
           type: nil)
-      wrap_impl(@impl.screenshot(omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
+      wrap_impl(@impl.screenshot(animations: unwrap_impl(animations), mask: unwrap_impl(mask), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
     end
 
     # This method waits for [actionability](./actionability.md) checks, then tries to scroll element into view, unless it is

data/lib/playwright_api/frame.rb

@@ -788,6 +788,11 @@ module Playwright
       wrap_impl(@impl.detached=(unwrap_impl(req)))
     end
 
+    # @nodoc
+    def highlight(selector)
+      wrap_impl(@impl.highlight(unwrap_impl(selector)))
+    end
+
     # -- inherited from EventEmitter --
     # @nodoc
     def off(event, callback)

data/lib/playwright_api/locator.rb

@@ -250,6 +250,12 @@ module Playwright
       wrap_impl(@impl.get_attribute(unwrap_impl(name), timeout: unwrap_impl(timeout)))
     end
 
+    # Highlight the corresponding element(s) on the screen. Useful for debugging, don't commit the code that uses
+    # [`method: Locator.highlight`].
+    def highlight
+      wrap_impl(@impl.highlight)
+    end
+
     # This method hovers over the element by performing the following steps:
     # 1. Wait for [actionability](./actionability.md) checks on the element, unless `force` option is set.
     # 1. Scroll the element into view if needed.
@@ -361,12 +367,14 @@ module Playwright
     # This method waits for the [actionability](./actionability.md) checks, then scrolls element into view before taking a
     # screenshot. If the element is detached from DOM, the method throws an error.
     def screenshot(
+          animations: nil,
+          mask: nil,
           omitBackground: nil,
           path: nil,
           quality: nil,
           timeout: nil,
           type: nil)
-      wrap_impl(@impl.screenshot(omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
+      wrap_impl(@impl.screenshot(animations: unwrap_impl(animations), mask: unwrap_impl(mask), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
     end
 
     # This method waits for [actionability](./actionability.md) checks, then tries to scroll element into view, unless it is

data/lib/playwright_api/page.rb

@@ -891,14 +891,16 @@ module Playwright
 
     # Returns the buffer with the captured screenshot.
     def screenshot(
+          animations: nil,
           clip: nil,
           fullPage: nil,
+          mask: nil,
           omitBackground: nil,
           path: nil,
           quality: nil,
           timeout: nil,
           type: nil)
-      wrap_impl(@impl.screenshot(clip: unwrap_impl(clip), fullPage: unwrap_impl(fullPage), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
+      wrap_impl(@impl.screenshot(animations: unwrap_impl(animations), clip: unwrap_impl(clip), fullPage: unwrap_impl(fullPage), mask: unwrap_impl(mask), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
     end
 
     # This method waits for an element matching `selector`, waits for [actionability](./actionability.md) checks, waits until
@@ -1016,9 +1018,10 @@ module Playwright
     # In the case of multiple pages in a single browser, each page can have its own viewport size. However,
     # [`method: Browser.newContext`] allows to set viewport size (and more) for all pages in the context at once.
     #
-    # `page.setViewportSize` will resize the page. A lot of websites don't expect phones to change size, so you should set the
-    # viewport size before navigating to the page. [`method: Page.setViewportSize`] will also reset `screen` size, use
-    # [`method: Browser.newContext`] with `screen` and `viewport` parameters if you need better control of these properties.
+    # [`method: Page.setViewportSize`] will resize the page. A lot of websites don't expect phones to change size, so you
+    # should set the viewport size before navigating to the page. [`method: Page.setViewportSize`] will also reset `screen`
+    # size, use [`method: Browser.newContext`] with `screen` and `viewport` parameters if you need better control of these
+    # properties.
     #
     # ```python sync
     # page = browser.new_page()
@@ -1387,13 +1390,13 @@ module Playwright
     end
 
     # @nodoc
-    def start_css_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
-      wrap_impl(@impl.start_css_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
+    def start_js_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
+      wrap_impl(@impl.start_js_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
     end
 
     # @nodoc
-    def stop_css_coverage
-      wrap_impl(@impl.stop_css_coverage)
+    def start_css_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
+      wrap_impl(@impl.start_css_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
     end
 
     # @nodoc
@@ -1402,8 +1405,8 @@ module Playwright
     end
 
     # @nodoc
-    def start_js_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
-      wrap_impl(@impl.start_js_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
+    def stop_css_coverage
+      wrap_impl(@impl.stop_css_coverage)
     end
 
     # @nodoc

data/lib/playwright_api/playwright.rb

@@ -87,13 +87,13 @@ module Playwright
     end
 
     # @nodoc
-    def electron
-      wrap_impl(@impl.electron)
+    def android
+      wrap_impl(@impl.android)
     end
 
     # @nodoc
-    def android
-      wrap_impl(@impl.android)
+    def electron
+      wrap_impl(@impl.electron)
     end
 
     # -- inherited from EventEmitter --

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.1
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-02-23 00:00:00.000000000 Z
+date: 2022-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -396,5 +396,5 @@ requirements: []
 rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
-summary: The Ruby binding of playwright driver 1.19.0
+summary: The Ruby binding of playwright driver 1.20.1
 test_files: []