playwright-ruby-client 0.5.7 → 0.6.1

data/lib/playwright_api/selectors.rb

@@ -4,73 +4,7 @@ module Playwright
   class Selectors < PlaywrightApi
 
     # An example of registering selector engine that queries elements based on a tag name:
-    # 
     #
-    # ```js
-    # const { selectors, firefox } = require('playwright');  // Or 'chromium' or 'webkit'.
-    # 
-    # (async () => {
-    #   // Must be a function that evaluates to a selector engine instance.
-    #   const createTagNameEngine = () => ({
-    #     // Returns the first element matching given selector in the root's subtree.
-    #     query(root, selector) {
-    #       return root.querySelector(selector);
-    #     },
-    # 
-    #     // Returns all elements matching given selector in the root's subtree.
-    #     queryAll(root, selector) {
-    #       return Array.from(root.querySelectorAll(selector));
-    #     }
-    #   });
-    # 
-    #   // Register the engine. Selectors will be prefixed with "tag=".
-    #   await selectors.register('tag', createTagNameEngine);
-    # 
-    #   const browser = await firefox.launch();
-    #   const page = await browser.newPage();
-    #   await page.setContent(`<div><button>Click me</button></div>`);
-    # 
-    #   // Use the selector prefixed with its name.
-    #   const button = await page.$('tag=button');
-    #   // Combine it with other selector engines.
-    #   await page.click('tag=div >> text="Click me"');
-    #   // Can use it in any methods supporting selectors.
-    #   const buttonCount = await page.$$eval('tag=button', buttons => buttons.length);
-    # 
-    #   await browser.close();
-    # })();
-    # ```
-    # 
-    # ```java
-    # // Script that evaluates to a selector engine instance.
-    # String createTagNameEngine = "{\n" +
-    #   "  // Returns the first element matching given selector in the root's subtree.\n" +
-    #   "  query(root, selector) {\n" +
-    #   "    return root.querySelector(selector);\n" +
-    #   "  },\n" +
-    #   "  // Returns all elements matching given selector in the root's subtree.\n" +
-    #   "  queryAll(root, selector) {\n" +
-    #   "    return Array.from(root.querySelectorAll(selector));\n" +
-    #   "  }\n" +
-    #   "}";
-    # // Register the engine. Selectors will be prefixed with "tag=".
-    # playwright.selectors().register("tag", createTagNameEngine);
-    # Browser browser = playwright.firefox().launch();
-    # Page page = browser.newPage();
-    # page.setContent("<div><button>Click me</button></div>");
-    # // Use the selector prefixed with its name.
-    # ElementHandle button = page.querySelector("tag=button");
-    # // Combine it with other selector engines.
-    # page.click("tag=div >> text=\"Click me\"");
-    # // Can use it in any methods supporting selectors.
-    # int buttonCount = (int) page.evalOnSelectorAll("tag=button", "buttons => buttons.length");
-    # browser.close();
-    # ```
-    # 
-    # ```python async
-    # # FIXME: add snippet
-    # ```
-    # 
     # ```python sync
     # # FIXME: add snippet
     # ```
@@ -78,12 +12,6 @@ module Playwright
       wrap_impl(@impl.register(unwrap_impl(name), contentScript: unwrap_impl(contentScript), path: unwrap_impl(path), script: unwrap_impl(script)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -96,6 +24,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/tracing.rb

@@ -0,0 +1,39 @@
+module Playwright
+  # API for collecting and saving Playwright traces. Playwright traces can be opened using the Playwright CLI after
+  # Playwright script runs.
+  #
+  # Start with specifying the folder traces will be stored in:
+  #
+  # ```python sync
+  # browser = chromium.launch(traceDir='traces')
+  # context = browser.new_context()
+  # context.tracing.start(name="trace", screenshots=True, snapshots=True)
+  # page.goto("https://playwright.dev")
+  # context.tracing.stop()
+  # context.tracing.export("trace.zip")
+  # ```
+  class Tracing < PlaywrightApi
+
+    # Export trace into the file with the given name. Should be called after the tracing has stopped.
+    def export(path)
+      wrap_impl(@impl.export(unwrap_impl(path)))
+    end
+
+    # Start tracing.
+    #
+    # ```python sync
+    # context.tracing.start(name="trace", screenshots=True, snapshots=True)
+    # page.goto("https://playwright.dev")
+    # context.tracing.stop()
+    # context.tracing.export("trace.zip")
+    # ```
+    def start(name: nil, screenshots: nil, snapshots: nil)
+      wrap_impl(@impl.start(name: unwrap_impl(name), screenshots: unwrap_impl(screenshots), snapshots: unwrap_impl(snapshots)))
+    end
+
+    # Stop tracing.
+    def stop
+      wrap_impl(@impl.stop)
+    end
+  end
+end

data/lib/playwright_api/web_socket.rb

@@ -19,7 +19,7 @@ module Playwright
     end
 
     # > NOTE: In most cases, you should use [`method: WebSocket.waitForEvent`].
-    # 
+    #
     # Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
     # waits for `predicate(event)` to return a truthy value. Will throw an error if the socket is closed before the `event` is
     # fired.

data/lib/playwright_api/worker.rb

@@ -2,61 +2,25 @@ module Playwright
   # The Worker class represents a [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API). `worker`
   # event is emitted on the page object to signal a worker creation. `close` event is emitted on the worker object when the
   # worker is gone.
-  # 
   #
-  # ```js
-  # page.on('worker', worker => {
-  #   console.log('Worker created: ' + worker.url());
-  #   worker.on('close', worker => console.log('Worker destroyed: ' + worker.url()));
-  # });
-  # 
-  # console.log('Current workers:');
-  # for (const worker of page.workers())
-  #   console.log('  ' + worker.url());
-  # ```
-  # 
-  # ```java
-  # page.onWorker(worker -> {
-  #   System.out.println("Worker created: " + worker.url());
-  #   worker.onClose(worker1 -> System.out.println("Worker destroyed: " + worker1.url()));
-  # });
-  # System.out.println("Current workers:");
-  # for (Worker worker : page.workers())
-  #   System.out.println("  " + worker.url());
-  # ```
-  # 
   # ```py
   # def handle_worker(worker):
   #     print("worker created: " + worker.url)
   #     worker.on("close", lambda: print("worker destroyed: " + worker.url))
-  # 
+  #
   # page.on('worker', handle_worker)
-  # 
+  #
   # print("current workers:")
   # for worker in page.workers:
   #     print("    " + worker.url)
   # ```
-  # 
-  # ```csharp
-  # Page.Worker += (_, worker) =>
-  # {
-  #     Console.WriteLine($"Worker created: {worker.Url}");
-  #     worker.Close += (_, _) => Console.WriteLine($"Worker closed {worker.Url}");
-  # };
-  # 
-  # Console.WriteLine("Current Workers:");
-  # foreach(var pageWorker in Page.Workers)
-  # {
-  #     Console.WriteLine($"\tWorker: {pageWorker.Url}");
-  # }
-  # ```
   class Worker < PlaywrightApi
 
     # Returns the return value of `expression`.
-    # 
+    #
     # If the function passed to the [`method: Worker.evaluate`] returns a [Promise], then [`method: Worker.evaluate`] would
     # wait for the promise to resolve and return its value.
-    # 
+    #
     # If the function passed to the [`method: Worker.evaluate`] returns a non-[Serializable] value, then
     # [`method: Worker.evaluate`] returns `undefined`. Playwright also supports transferring some additional values that are
     # not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
@@ -65,10 +29,10 @@ module Playwright
     end
 
     # Returns the return value of `expression` as a `JSHandle`.
-    # 
+    #
     # The only difference between [`method: Worker.evaluate`] and [`method: Worker.evaluateHandle`] is that
     # [`method: Worker.evaluateHandle`] returns `JSHandle`.
-    # 
+    #
     # If the function passed to the [`method: Worker.evaluateHandle`] returns a [Promise], then
     # [`method: Worker.evaluateHandle`] would wait for the promise to resolve and return its value.
     def evaluate_handle(expression, arg: nil)

data/playwright.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ['YusukeIwaki']
   spec.email         = ['q7w8e9w8q7w8e9@yahoo.co.jp']
 
-  spec.summary       = 'The Ruby binding of playwright driver'
+  spec.summary       = "The Ruby binding of playwright driver #{Playwright::COMPATIBLE_PLAYWRIGHT_VERSION}"
   spec.homepage      = 'https://github.com/YusukeIwaki/playwright-ruby-client'
   spec.license       = 'MIT'
 
@@ -24,6 +24,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
+  spec.required_ruby_version = '>= 2.4'
   spec.add_dependency 'concurrent-ruby', '>= 1.1.6'
   spec.add_dependency 'mime-types', '>= 3.0'
   spec.add_development_dependency 'bundler', '~> 2.2.3'
@@ -33,7 +34,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake', '~> 13.0.3'
   spec.add_development_dependency 'rspec', '~> 3.10.0 '
   spec.add_development_dependency 'rspec_junit_formatter' # for CircleCI.
-  spec.add_development_dependency 'rubocop', '~> 1.7.0'
   spec.add_development_dependency 'rubocop-rspec'
   spec.add_development_dependency 'sinatra'
   spec.add_development_dependency 'webrick'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 0.5.7
+  version: 0.6.1
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-05-10 00:00:00.000000000 Z
+date: 2021-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -136,20 +136,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.7.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.7.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
@@ -207,7 +193,59 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
-- docs/api_coverage.md
+- documentation/README.md
+- documentation/babel.config.js
+- documentation/docs/api/accessibility.md
+- documentation/docs/api/browser.md
+- documentation/docs/api/browser_context.md
+- documentation/docs/api/browser_type.md
+- documentation/docs/api/cdp_session.md
+- documentation/docs/api/console_message.md
+- documentation/docs/api/dialog.md
+- documentation/docs/api/element_handle.md
+- documentation/docs/api/experimental/_category_.yml
+- documentation/docs/api/experimental/android.md
+- documentation/docs/api/experimental/android_device.md
+- documentation/docs/api/experimental/android_input.md
+- documentation/docs/api/experimental/android_socket.md
+- documentation/docs/api/experimental/android_web_view.md
+- documentation/docs/api/file_chooser.md
+- documentation/docs/api/frame.md
+- documentation/docs/api/js_handle.md
+- documentation/docs/api/keyboard.md
+- documentation/docs/api/mouse.md
+- documentation/docs/api/page.md
+- documentation/docs/api/playwright.md
+- documentation/docs/api/request.md
+- documentation/docs/api/response.md
+- documentation/docs/api/route.md
+- documentation/docs/api/selectors.md
+- documentation/docs/api/touchscreen.md
+- documentation/docs/api/tracing.md
+- documentation/docs/api/web_socket.md
+- documentation/docs/api/worker.md
+- documentation/docs/article/api_coverage.mdx
+- documentation/docs/article/getting_started.md
+- 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/rails_integration.md
+- documentation/docs/include/api_coverage.md
+- documentation/docusaurus.config.js
+- documentation/package.json
+- documentation/sidebars.js
+- documentation/src/components/HomepageFeatures.js
+- documentation/src/components/HomepageFeatures.module.css
+- documentation/src/css/custom.css
+- documentation/src/pages/index.js
+- documentation/src/pages/index.module.css
+- documentation/src/pages/markdown-page.md
+- documentation/static/.nojekyll
+- documentation/static/img/playwright-logo.svg
+- documentation/static/img/undraw_dropdown_menu.svg
+- documentation/static/img/undraw_web_development.svg
+- documentation/static/img/undraw_windows.svg
+- documentation/yarn.lock
 - lib/playwright.rb
 - lib/playwright/android_input_impl.rb
 - lib/playwright/api_implementation.rb
@@ -244,7 +282,6 @@ files:
 - lib/playwright/input_files.rb
 - lib/playwright/javascript.rb
 - lib/playwright/javascript/expression.rb
-- lib/playwright/javascript/function.rb
 - lib/playwright/javascript/value_parser.rb
 - lib/playwright/javascript/value_serializer.rb
 - lib/playwright/keyboard_impl.rb
@@ -254,6 +291,7 @@ files:
 - lib/playwright/select_option_values.rb
 - lib/playwright/timeout_settings.rb
 - lib/playwright/touchscreen_impl.rb
+- lib/playwright/tracing_impl.rb
 - lib/playwright/transport.rb
 - lib/playwright/url_matcher.rb
 - lib/playwright/utils.rb
@@ -285,6 +323,7 @@ files:
 - lib/playwright_api/route.rb
 - lib/playwright_api/selectors.rb
 - lib/playwright_api/touchscreen.rb
+- lib/playwright_api/tracing.rb
 - lib/playwright_api/web_socket.rb
 - lib/playwright_api/worker.rb
 - playwright.gemspec
@@ -300,7 +339,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -310,5 +349,5 @@ requirements: []
 rubygems_version: 3.2.15
 signing_key: 
 specification_version: 4
-summary: The Ruby binding of playwright driver
+summary: The Ruby binding of playwright driver 1.12.0
 test_files: []

data/lib/playwright/javascript/function.rb

@@ -1,67 +0,0 @@
-module Playwright
-  module JavaScript
-    class Function
-      def initialize(definition, arg)
-        @definition = definition
-        @serialized_arg = ValueSerializer.new(arg).serialize
-      end
-
-      def evaluate(channel)
-        value = channel.send_message_to_server(
-          'evaluateExpression',
-          expression: @definition,
-          isFunction: true,
-          arg: @serialized_arg,
-        )
-        ValueParser.new(value).parse
-      end
-
-      def evaluate_handle(channel)
-        resp = channel.send_message_to_server(
-          'evaluateExpressionHandle',
-          expression: @definition,
-          isFunction: true,
-          arg: @serialized_arg,
-        )
-        ::Playwright::ChannelOwner.from(resp)
-      end
-
-      def eval_on_selector(channel, selector)
-        value = channel.send_message_to_server(
-          'evalOnSelector',
-          selector: selector,
-          expression: @definition,
-          isFunction: true,
-          arg: @serialized_arg,
-        )
-        ValueParser.new(value).parse
-      end
-
-      def eval_on_selector_all(channel, selector)
-        value = channel.send_message_to_server(
-          'evalOnSelectorAll',
-          selector: selector,
-          expression: @definition,
-          isFunction: true,
-          arg: @serialized_arg,
-        )
-        ValueParser.new(value).parse
-      end
-
-      def wait_for_function(channel, polling:, timeout:)
-        params = {
-          expression: @definition,
-          isFunction: true,
-          arg: @serialized_arg,
-          polling: polling,
-          timeout: timeout,
-        }.compact
-        if polling.is_a?(Numeric)
-          params[:pollingInterval] = polling
-        end
-        resp = channel.send_message_to_server('waitForFunction', params)
-        ChannelOwners::JSHandle.from(resp)
-      end
-    end
-  end
-end