playwright-ruby-client 0.0.8 → 0.3.0

data/lib/playwright_api/playwright.rb

@@ -113,51 +113,15 @@ module Playwright
       wrap_impl(@impl.devices)
     end
 
-    # Playwright methods might throw errors if they are unable to fulfill a request. For example,
-    # [`method: Page.waitForSelector`] might fail if the selector doesn't match any nodes during the given timeframe.
-    # 
-    # For certain types of errors Playwright uses specific error classes. These classes are available via
-    # [`playwright.errors`](#playwrighterrors).
-    # 
-    # An example of handling a timeout error:
-    # 
-    #
-    # ```js
-    # try {
-    #   await page.waitForSelector('.foo');
-    # } catch (e) {
-    #   if (e instanceof playwright.errors.TimeoutError) {
-    #     // Do something if this is a timeout.
-    #   }
-    # }
-    # ```
-    # 
-    # ```python async
-    # try:
-    #     await page.wait_for_selector(".foo")
-    # except TimeoutError as e:
-    #     # do something if this is a timeout.
-    # ```
-    # 
-    # ```python sync
-    # try:
-    #     page.wait_for_selector(".foo")
-    # except TimeoutError as e:
-    #     # do something if this is a timeout.
-    # ```
-    def errors # property
-      raise NotImplementedError.new('errors is not implemented yet.')
-    end
-
     # This object can be used to launch or connect to Firefox, returning instances of `FirefoxBrowser`.
     def firefox # property
       wrap_impl(@impl.firefox)
     end
 
-    # Selectors can be used to install custom selector engines. See
-    # [Working with selectors](./selectors.md#working-with-selectors) for more information.
+    # Selectors can be used to install custom selector engines. See [Working with selectors](./selectors.md) for more
+    # information.
     def selectors # property
-      raise NotImplementedError.new('selectors is not implemented yet.')
+      wrap_impl(@impl.selectors)
     end
 
     # This object can be used to launch or connect to WebKit, returning instances of `WebKitBrowser`.
@@ -165,6 +129,26 @@ module Playwright
       wrap_impl(@impl.webkit)
     end
 
+    # Terminates this instance of Playwright in case it was created bypassing the Python context manager. This is useful in
+    # REPL applications.
+    # 
+    # ```py
+    # >>> from playwright.sync_api import sync_playwright
+    # 
+    # >>> playwright = sync_playwright().start()
+    # 
+    # >>> browser = playwright.chromium.launch()
+    # >>> page = browser.new_page()
+    # >>> page.goto("http://whatsmyuseragent.org/")
+    # >>> page.screenshot(path="example.png")
+    # >>> browser.close()
+    # 
+    # >>> playwright.stop()
+    # ```
+    def stop
+      raise NotImplementedError.new('stop is not implemented yet.')
+    end
+
     # @nodoc
     def android
       wrap_impl(@impl.android)
@@ -177,20 +161,24 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      wrap_impl(@impl.on(unwrap_impl(event), unwrap_impl(callback)))
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      wrap_impl(@impl.off(unwrap_impl(event), unwrap_impl(callback)))
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      wrap_impl(@impl.once(unwrap_impl(event), unwrap_impl(callback)))
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
+    end
+
+    private def event_emitter_proxy
+      @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end
   end
 end

data/lib/playwright_api/request.rb

@@ -2,10 +2,10 @@ module Playwright
   # Whenever the page sends a request for a network resource the following sequence of events are emitted by `Page`:
   # - [`event: Page.request`] emitted when the request is issued by the page.
   # - [`event: Page.response`] emitted when/if the response status and headers are received for the request.
-  # - [`event: Page.requestfinished`] emitted when the response body is downloaded and the request is complete.
+  # - [`event: Page.requestFinished`] emitted when the response body is downloaded and the request is complete.
   # 
   # If request fails at some point, then instead of `'requestfinished'` event (and possibly instead of 'response' event),
-  # the  [`event: Page.requestfailed`] event is emitted.
+  # the  [`event: Page.requestFailed`] event is emitted.
   # 
   # > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
   # complete with `'requestfinished'` event.
@@ -178,27 +178,26 @@ module Playwright
       wrap_impl(@impl.url)
     end
 
+    # -- inherited from EventEmitter --
     # @nodoc
-    def after_initialize
-      wrap_impl(@impl.after_initialize)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      wrap_impl(@impl.on(unwrap_impl(event), unwrap_impl(callback)))
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      wrap_impl(@impl.off(unwrap_impl(event), unwrap_impl(callback)))
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      wrap_impl(@impl.once(unwrap_impl(event), unwrap_impl(callback)))
+    private def event_emitter_proxy
+      @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end
   end
 end

data/lib/playwright_api/response.rb

@@ -4,77 +4,91 @@ module Playwright
 
     # Returns the buffer with response body.
     def body
-      raise NotImplementedError.new('body is not implemented yet.')
+      wrap_impl(@impl.body)
     end
 
     # Waits for this response to finish, returns failure error if request failed.
     def finished
-      raise NotImplementedError.new('finished is not implemented yet.')
+      wrap_impl(@impl.finished)
     end
 
     # Returns the `Frame` that initiated this response.
     def frame
-      raise NotImplementedError.new('frame is not implemented yet.')
+      wrap_impl(@impl.frame)
     end
 
     # Returns the object with HTTP headers associated with the response. All header names are lower-case.
     def headers
-      raise NotImplementedError.new('headers is not implemented yet.')
+      wrap_impl(@impl.headers)
     end
 
     # Returns the JSON representation of response body.
     # 
     # This method will throw if the response body is not parsable via `JSON.parse`.
     def json
-      raise NotImplementedError.new('json is not implemented yet.')
+      wrap_impl(@impl.json)
     end
 
     # Contains a boolean stating whether the response was successful (status in the range 200-299) or not.
     def ok
-      raise NotImplementedError.new('ok is not implemented yet.')
+      wrap_impl(@impl.ok)
     end
 
     # Returns the matching `Request` object.
     def request
-      raise NotImplementedError.new('request is not implemented yet.')
+      wrap_impl(@impl.request)
     end
 
     # Contains the status code of the response (e.g., 200 for a success).
     def status
-      raise NotImplementedError.new('status is not implemented yet.')
+      wrap_impl(@impl.status)
     end
 
     # Contains the status text of the response (e.g. usually an "OK" for a success).
     def status_text
-      raise NotImplementedError.new('status_text is not implemented yet.')
+      wrap_impl(@impl.status_text)
     end
 
     # Returns the text representation of response body.
     def text
-      raise NotImplementedError.new('text is not implemented yet.')
+      wrap_impl(@impl.text)
     end
 
     # Contains the URL of the response.
     def url
-      raise NotImplementedError.new('url is not implemented yet.')
+      wrap_impl(@impl.url)
     end
 
-    # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      wrap_impl(@impl.on(unwrap_impl(event), unwrap_impl(callback)))
+    def ok?
+      wrap_impl(@impl.ok?)
+    end
+
+    # @nodoc
+    def after_initialize
+      wrap_impl(@impl.after_initialize)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
     def off(event, callback)
-      wrap_impl(@impl.off(unwrap_impl(event), unwrap_impl(callback)))
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
     def once(event, callback)
-      wrap_impl(@impl.once(unwrap_impl(event), unwrap_impl(callback)))
+      event_emitter_proxy.once(event, callback)
+    end
+
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
+    end
+
+    private def event_emitter_proxy
+      @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end
   end
 end

data/lib/playwright_api/route.rb

@@ -5,7 +5,7 @@ module Playwright
 
     # Aborts the route's request.
     def abort(errorCode: nil)
-      raise NotImplementedError.new('abort is not implemented yet.')
+      wrap_impl(@impl.abort(errorCode: unwrap_impl(errorCode)))
     end
 
     # Continues route's request with optional overrides.
@@ -48,8 +48,8 @@ module Playwright
     # }
     # page.route("**/*", handle)
     # ```
-    def continue_(headers: nil, method: nil, postData: nil, url: nil)
-      raise NotImplementedError.new('continue_ is not implemented yet.')
+    def continue(headers: nil, method: nil, postData: nil, url: nil)
+      wrap_impl(@impl.continue(headers: unwrap_impl(headers), method: unwrap_impl(method), postData: unwrap_impl(postData), url: unwrap_impl(url)))
     end
 
     # Fulfills route's request with given response.
@@ -101,12 +101,34 @@ module Playwright
           headers: nil,
           path: nil,
           status: nil)
-      raise NotImplementedError.new('fulfill is not implemented yet.')
+      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
 
     # A request to be routed.
     def request
-      raise NotImplementedError.new('request is not implemented yet.')
+      wrap_impl(@impl.request)
+    end
+
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
+    end
+
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
+    end
+
+    private def event_emitter_proxy
+      @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end
   end
 end

data/lib/playwright_api/selectors.rb

@@ -1,6 +1,6 @@
 module Playwright
-  # Selectors can be used to install custom selector engines. See
-  # [Working with selectors](./selectors.md#working-with-selectors) for more information.
+  # Selectors can be used to install custom selector engines. See [Working with selectors](./selectors.md) for more
+  # information.
   class Selectors < PlaywrightApi
 
     # An example of registering selector engine that queries elements based on a tag name:
@@ -48,26 +48,30 @@ module Playwright
     # ```python sync
     # # FIXME: add snippet
     # ```
-    def register(name, script, contentScript: nil)
-      raise NotImplementedError.new('register is not implemented yet.')
+    def register(name, contentScript: nil, path: nil, script: nil)
+      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 on(event, callback)
-      wrap_impl(@impl.on(unwrap_impl(event), unwrap_impl(callback)))
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      wrap_impl(@impl.off(unwrap_impl(event), unwrap_impl(callback)))
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      wrap_impl(@impl.once(unwrap_impl(event), unwrap_impl(callback)))
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
+    end
+
+    private def event_emitter_proxy
+      @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end
   end
 end

data/lib/playwright_api/web_socket.rb

@@ -14,8 +14,17 @@ module Playwright
 
     # Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
     # value. Will throw an error if the webSocket is closed before the event is fired. Returns the event data value.
-    def expect_event(event, optionsOrPredicate: nil)
+    def expect_event(event, predicate: nil, timeout: nil)
       raise NotImplementedError.new('expect_event is not implemented yet.')
     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.
+    def wait_for_event(event, predicate: nil, timeout: nil)
+      raise NotImplementedError.new('wait_for_event is not implemented yet.')
+    end
   end
 end

data/lib/playwright_api/worker.rb

@@ -28,26 +28,26 @@ module Playwright
   # ```
   class Worker < PlaywrightApi
 
-    # Returns the return value of `pageFunction`
+    # Returns the return value of `expression`.
     # 
-    # If the function passed to the `worker.evaluate` returns a [Promise], then `worker.evaluate` would wait for the promise
-    # to resolve and return its value.
+    # 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 `worker.evaluate` returns a non-[Serializable] value, then `worker.evaluate` returns
-    # `undefined`. DevTools Protocol also supports transferring some additional values that are not serializable by `JSON`:
-    # `-0`, `NaN`, `Infinity`, `-Infinity`, and bigint literals.
-    def evaluate(pageFunction, arg: nil)
+    # 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`.
+    def evaluate(expression, arg: nil)
       raise NotImplementedError.new('evaluate is not implemented yet.')
     end
 
-    # Returns the return value of `pageFunction` as in-page object (JSHandle).
+    # Returns the return value of `expression` as a `JSHandle`.
     # 
-    # The only difference between `worker.evaluate` and `worker.evaluateHandle` is that `worker.evaluateHandle` returns
-    # in-page object (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 `worker.evaluateHandle` returns a [Promise], then `worker.evaluateHandle` would wait for
-    # the promise to resolve and return its value.
-    def evaluate_handle(pageFunction, arg: nil)
+    # 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)
       raise NotImplementedError.new('evaluate_handle is not implemented yet.')
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.3.0
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-02-11 00:00:00.000000000 Z
+date: 2021-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -181,6 +181,8 @@ files:
 - bin/setup
 - docs/api_coverage.md
 - lib/playwright.rb
+- lib/playwright/android_input_impl.rb
+- lib/playwright/api_implementation.rb
 - lib/playwright/channel.rb
 - lib/playwright/channel_owner.rb
 - lib/playwright/channel_owners/android.rb
@@ -192,6 +194,8 @@ files:
 - lib/playwright/channel_owners/chromium_browser.rb
 - lib/playwright/channel_owners/chromium_browser_context.rb
 - lib/playwright/channel_owners/console_message.rb
+- lib/playwright/channel_owners/dialog.rb
+- lib/playwright/channel_owners/download.rb
 - lib/playwright/channel_owners/electron.rb
 - lib/playwright/channel_owners/element_handle.rb
 - lib/playwright/channel_owners/firefox_browser.rb
@@ -201,26 +205,29 @@ files:
 - lib/playwright/channel_owners/playwright.rb
 - lib/playwright/channel_owners/request.rb
 - lib/playwright/channel_owners/response.rb
+- lib/playwright/channel_owners/route.rb
 - lib/playwright/channel_owners/selectors.rb
 - lib/playwright/channel_owners/webkit_browser.rb
 - lib/playwright/connection.rb
 - lib/playwright/errors.rb
 - lib/playwright/event_emitter.rb
+- lib/playwright/event_emitter_proxy.rb
 - lib/playwright/events.rb
+- lib/playwright/file_chooser_impl.rb
+- lib/playwright/http_headers.rb
 - lib/playwright/input_files.rb
-- lib/playwright/input_type.rb
-- lib/playwright/input_types/android_input.rb
-- lib/playwright/input_types/keyboard.rb
-- lib/playwright/input_types/mouse.rb
-- lib/playwright/input_types/touchscreen.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
+- lib/playwright/mouse_impl.rb
 - lib/playwright/playwright_api.rb
+- lib/playwright/route_handler_entry.rb
 - lib/playwright/select_option_values.rb
 - lib/playwright/timeout_settings.rb
+- lib/playwright/touchscreen_impl.rb
 - lib/playwright/transport.rb
 - lib/playwright/url_matcher.rb
 - lib/playwright/utils.rb
@@ -230,6 +237,8 @@ files:
 - lib/playwright_api/android.rb
 - lib/playwright_api/android_device.rb
 - lib/playwright_api/android_input.rb
+- lib/playwright_api/android_socket.rb
+- lib/playwright_api/android_web_view.rb
 - lib/playwright_api/binding_call.rb
 - lib/playwright_api/browser.rb
 - lib/playwright_api/browser_context.rb