playwright-ruby-client 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a283a84899327e4b56db01800535c7231c1c2e94e7cbf11bd72ec60b1415c92c
-  data.tar.gz: 5e929e57b0b8d3b0970c2a0cb5029acd6cc5bd23e419bf06bc1b0a45e2f5e781
+  metadata.gz: b365f47558ade3fcf3d803a070cbd61eb4eae6279f0d93c1641a53d9b50ec232
+  data.tar.gz: 353de7a190205c6d3d4542b3058afe24c0c634fe70811c15384b55d1cb464571
 SHA512:
-  metadata.gz: d13545073c8a110c55098547c7f7c5c4adae5c542b6b18f78be4cf3e5187cf2c92d8ccc86484c0e7bdfbeaf619ff6c8f77ce2f9c82b5eccad4c72dffb22603a5
-  data.tar.gz: ea4a751f747e5738121c8603eb3e495dd2ef32082d1fbd92841c2a0182637300b7c3bde0a00acbf1b25bdc572b140ff4e8a5a694dda95152f568ea5aa2760fef
+  metadata.gz: ec905a5051716af754993c11b5a484e5bf69a9b50cdb6681f583869d0cf70d23eb3265507d6739b6d006fc8419360dea8570f6fae6fc3ac8fdd6d44ae3547fd8
+  data.tar.gz: cf06e3351a40457108080dea85af6c8e417ffda3bec6671f9280ad42bc5fde7e58cf039016fe11387a7cb3e1347e1391f1440d23c2e54e512ca70e39ba90db38

data/documentation/README.md

@@ -0,0 +1,33 @@
+# Website
+
+This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```console
+yarn install
+```
+
+## Local Development
+
+```console
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```console
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+```console
+GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

data/documentation/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

data/documentation/docs/api/accessibility.md

@@ -0,0 +1,7 @@
+---
+sidebar_position: 10
+---
+
+# Accessibility
+
+Not Implemented

data/documentation/docs/api/browser.md

@@ -0,0 +1,185 @@
+---
+sidebar_position: 10
+---
+
+# Browser
+
+- extends: [EventEmitter]
+
+A Browser is created via [BrowserType#launch](./browser_type#launch). An example of using a [Browser](./browser) to create a [Page](./page):
+
+```ruby
+firefox = playwright.firefox
+browser = firefox.launch
+begin
+  page = browser.new_page
+  page.goto("https://example.com")
+ensure
+  browser.close
+end
+```
+
+
+
+## close
+
+```
+def close
+```
+
+In case this browser is obtained using [BrowserType#launch](./browser_type#launch), closes the browser and all of its pages (if any
+were opened).
+
+In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from the
+browser server.
+
+The [Browser](./browser) object itself is considered to be disposed and cannot be used anymore.
+
+## contexts
+
+```
+def contexts
+```
+
+Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.
+
+```ruby
+playwright.webkit.launch do |browser|
+  puts browser.contexts.count # => 0
+  context = browser.new_context
+  puts browser.contexts.count # => 1
+end
+```
+
+
+
+## connected?
+
+```
+def connected?
+```
+
+Indicates that the browser is connected.
+
+## new_context
+
+```
+def new_context(
+      acceptDownloads: nil,
+      bypassCSP: nil,
+      colorScheme: nil,
+      deviceScaleFactor: nil,
+      extraHTTPHeaders: nil,
+      geolocation: nil,
+      hasTouch: nil,
+      httpCredentials: nil,
+      ignoreHTTPSErrors: nil,
+      isMobile: nil,
+      javaScriptEnabled: nil,
+      locale: nil,
+      noViewport: nil,
+      offline: nil,
+      permissions: nil,
+      proxy: nil,
+      record_har_omit_content: nil,
+      record_har_path: nil,
+      record_video_dir: nil,
+      record_video_size: nil,
+      screen: nil,
+      storageState: nil,
+      timezoneId: nil,
+      userAgent: nil,
+      viewport: nil,
+      &block)
+```
+
+Creates a new browser context. It won't share cookies/cache with other browser contexts.
+
+```ruby
+playwright.firefox.launch do |browser| # or "chromium.launch" or "webkit.launch".
+  # create a new incognito browser context.
+  context = browser.new_context
+
+  # create a new page in a pristine context.
+  page = context.new_page()
+  page.goto("https://example.com")
+end
+```
+
+
+
+## new_page
+
+```
+def new_page(
+      acceptDownloads: nil,
+      bypassCSP: nil,
+      colorScheme: nil,
+      deviceScaleFactor: nil,
+      extraHTTPHeaders: nil,
+      geolocation: nil,
+      hasTouch: nil,
+      httpCredentials: nil,
+      ignoreHTTPSErrors: nil,
+      isMobile: nil,
+      javaScriptEnabled: nil,
+      locale: nil,
+      noViewport: nil,
+      offline: nil,
+      permissions: nil,
+      proxy: nil,
+      record_har_omit_content: nil,
+      record_har_path: nil,
+      record_video_dir: nil,
+      record_video_size: nil,
+      screen: nil,
+      storageState: nil,
+      timezoneId: nil,
+      userAgent: nil,
+      viewport: nil)
+```
+
+Creates a new page in a new browser context. Closing this page will close the context as well.
+
+This is a convenience API that should only be used for the single-page scenarios and short snippets. Production code and
+testing frameworks should explicitly create [Browser#new_context](./browser#new_context) followed by the
+[BrowserContext#new_page](./browser_context#new_page) to control their exact life times.
+
+## start_tracing
+
+```
+def start_tracing(page: nil, categories: nil, path: nil, screenshots: nil)
+```
+
+> NOTE: Tracing is only supported on Chromium-based browsers.
+
+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.
+
+```ruby
+browser.start_tracing(page: page, path: "trace.json")
+begin
+  page.goto("https://www.google.com")
+ensure
+  browser.stop_tracing
+end
+```
+
+
+## stop_tracing
+
+```
+def stop_tracing
+```
+
+> NOTE: Tracing is only supported on Chromium-based browsers.
+
+Returns the buffer with trace data.
+
+## version
+
+```
+def version
+```
+
+Returns the browser version.

data/documentation/docs/api/browser_context.md

@@ -0,0 +1,398 @@
+---
+sidebar_position: 10
+---
+
+# BrowserContext
+
+- extends: [EventEmitter]
+
+BrowserContexts provide a way to operate multiple independent browser sessions.
+
+If a page opens another page, e.g. with a `window.open` call, the popup will belong to the parent page's browser
+context.
+
+Playwright allows creation of "incognito" browser contexts with [Browser#new_context](./browser#new_context) method. "Incognito" browser
+contexts don't write any browsing data to disk.
+
+```ruby
+# create a new incognito browser context
+context = browser.new_context
+
+# create a new page inside context.
+page = context.new_page
+page.goto("https://example.com")
+
+# dispose context once it is no longer needed.
+context.close()
+```
+
+
+
+## add_cookies
+
+```
+def add_cookies(cookies)
+```
+
+Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies can be
+obtained via [BrowserContext#cookies](./browser_context#cookies).
+
+```ruby
+browser_context.add_cookies([cookie_object1, cookie_object2])
+```
+
+
+
+## add_init_script
+
+```
+def add_init_script(path: nil, script: nil)
+```
+
+Adds a script which would be evaluated in one of the following scenarios:
+- Whenever a page is created in the browser context or is navigated.
+- Whenever a child frame is attached or navigated in any page in the browser context. In this case, the script is
+  evaluated in the context of the newly attached frame.
+
+The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend
+the JavaScript environment, e.g. to seed `Math.random`.
+
+An example of overriding `Math.random` before the page loads:
+
+```ruby
+# in your playwright script, assuming the preload.js file is in same directory.
+browser_context.add_init_script(path: "preload.js")
+```
+
+> NOTE: The order of evaluation of multiple scripts installed via [BrowserContext#add_init_script](./browser_context#add_init_script) and
+[Page#add_init_script](./page#add_init_script) is not defined.
+
+## browser
+
+```
+def browser
+```
+
+Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
+
+## clear_cookies
+
+```
+def clear_cookies
+```
+
+Clears context cookies.
+
+## clear_permissions
+
+```
+def clear_permissions
+```
+
+Clears all permission overrides for the browser context.
+
+```ruby
+context = browser.new_context
+context.grant_permissions(["clipboard-read"])
+
+# do stuff ..
+
+context.clear_permissions
+```
+
+
+
+## close
+
+```
+def close
+```
+
+Closes the browser context. All the pages that belong to the browser context will be closed.
+
+> NOTE: The default browser context cannot be closed.
+
+## cookies
+
+```
+def cookies(urls: nil)
+```
+
+If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
+are returned.
+
+## expose_binding
+
+```
+def expose_binding(name, callback, handle: nil)
+```
+
+The method adds a function called `name` on the `window` object of every frame in every page in the context. When
+called, the function executes `callback` and returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) which resolves to the return value of `callback`. If
+the `callback` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), it will be awaited.
+
+The first argument of the `callback` function contains information about the caller: `{ browserContext: BrowserContext,
+page: Page, frame: Frame }`.
+
+See [Page#expose_binding](./page#expose_binding) for page-only version.
+
+An example of exposing page URL to all frames in all pages in the context:
+
+```ruby
+browser_context.expose_binding("pageURL", ->(source) { source[:page].url })
+page = browser_context.new_page
+
+page.content = <<~HTML
+<script>
+  async function onClick() {
+    document.querySelector('div').textContent = await window.pageURL();
+  }
+</script>
+<button onclick="onClick()">Click me</button>
+<div></div>
+HTML
+
+page.click("button")
+```
+
+An example of passing an element handle:
+
+```ruby
+def print_text(source, element)
+  element.text_content
+end
+
+browser_context.expose_binding("clicked", method(:print_text), handle: true)
+page = browser_context.new_page
+
+page.content = <<~HTML
+<script>
+  document.addEventListener('click', async (event) => {
+    alert(await window.clicked(event.target));
+  })
+</script>
+<div>Click me</div>
+<div>Or click me</div>
+HTML
+
+page.click('div')
+```
+
+
+
+## expose_function
+
+```
+def expose_function(name, callback)
+```
+
+The method adds a function called `name` on the `window` object of every frame in every page in the context. When
+called, the function executes `callback` and returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) which resolves to the return value of `callback`.
+
+If the `callback` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), it will be awaited.
+
+See [Page#expose_function](./page#expose_function) for page-only version.
+
+An example of adding an `sha256` function to all pages in the context:
+
+```ruby
+require 'digest'
+
+def sha256(text)
+  Digest::SHA256.hexdigest(text)
+end
+
+browser_context.expose_function("sha256", method(:sha256))
+page = browser_context.new_page()
+page.content = <<~HTML
+<script>
+  async function onClick() {
+    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
+  }
+</script>
+<button onclick="onClick()">Click me</button>
+<div></div>
+HTML
+page.click("button")
+```
+
+
+
+## grant_permissions
+
+```
+def grant_permissions(permissions, origin: nil)
+```
+
+Grants specified permissions to the browser context. Only grants corresponding permissions to the given origin if
+specified.
+
+## new_page
+
+```
+def new_page
+```
+
+Creates a new page in the browser context.
+
+## pages
+
+```
+def pages
+```
+
+Returns all open pages in the context.
+
+## route
+
+```
+def route(url, handler)
+```
+
+Routing provides the capability to modify network requests that are made by any page in the browser context. Once route
+is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
+
+An example of a naive handler that aborts all image requests:
+
+```ruby
+context = browser.new_context
+page = context.new_page
+context.route("**/*.{png,jpg,jpeg}", ->(route, request) { route.abort })
+page.goto("https://example.com")
+```
+
+or the same snippet using a regex pattern instead:
+
+```ruby
+context = browser.new_context
+page = context.new_page
+context.route(/\.(png|jpg)$/, ->(route, request) { route.abort })
+page.goto("https://example.com")
+```
+
+It is possible to examine the request to decide the route action. For example, mocking all requests that contain some
+post data, and leaving all other requests as is:
+
+```ruby
+def handle_route(route, request)
+  if request.post_data["my-string"]
+    mocked_data = request.post_data.merge({ "my-string" => 'mocked-data'})
+    route.fulfill(postData: mocked_data)
+  else
+    route.continue
+  end
+end
+context.route("/api/**", method(:handle_route))
+```
+
+Page routes (set up with [Page#route](./page#route)) take precedence over browser context routes when request matches both
+handlers.
+
+To remove a route with its handler you can use [BrowserContext#unroute](./browser_context#unroute).
+
+> NOTE: Enabling routing disables http cache.
+
+## set_default_navigation_timeout
+
+```
+def set_default_navigation_timeout(timeout)
+```
+alias: `default_navigation_timeout=`
+
+This setting will change the default maximum navigation time for the following methods and related shortcuts:
+- [Page#go_back](./page#go_back)
+- [Page#go_forward](./page#go_forward)
+- [Page#goto](./page#goto)
+- [Page#reload](./page#reload)
+- [Page#set_content](./page#set_content)
+- [Page#expect_navigation](./page#expect_navigation)
+
+> NOTE: [Page#set_default_navigation_timeout](./page#set_default_navigation_timeout) and [Page#set_default_timeout](./page#set_default_timeout) take priority over
+[BrowserContext#set_default_navigation_timeout](./browser_context#set_default_navigation_timeout).
+
+## set_default_timeout
+
+```
+def set_default_timeout(timeout)
+```
+alias: `default_timeout=`
+
+This setting will change the default maximum time for all the methods accepting `timeout` option.
+
+> NOTE: [Page#set_default_navigation_timeout](./page#set_default_navigation_timeout), [Page#set_default_timeout](./page#set_default_timeout) and
+[BrowserContext#set_default_navigation_timeout](./browser_context#set_default_navigation_timeout) take priority over [BrowserContext#set_default_timeout](./browser_context#set_default_timeout).
+
+## set_extra_http_headers
+
+```
+def set_extra_http_headers(headers)
+```
+alias: `extra_http_headers=`
+
+The extra HTTP headers will be sent with every request initiated by any page in the context. These headers are merged
+with page-specific extra HTTP headers set with [Page#set_extra_http_headers](./page#set_extra_http_headers). If page overrides a particular
+header, page-specific header value will be used instead of the browser context header value.
+
+> NOTE: [BrowserContext#set_extra_http_headers](./browser_context#set_extra_http_headers) does not guarantee the order of headers in the outgoing requests.
+
+## set_geolocation
+
+```
+def set_geolocation(geolocation)
+```
+alias: `geolocation=`
+
+Sets the context's geolocation. Passing `null` or `undefined` emulates position unavailable.
+
+```ruby
+browser_context.geolocation = { latitude: 59.95, longitude: 30.31667 }
+```
+
+> NOTE: Consider using [BrowserContext#grant_permissions](./browser_context#grant_permissions) to grant permissions for the browser context pages to
+read its geolocation.
+
+## set_offline
+
+```
+def set_offline(offline)
+```
+alias: `offline=`
+
+
+
+## unroute
+
+```
+def unroute(url, handler: nil)
+```
+
+Removes a route created with [BrowserContext#route](./browser_context#route). When `handler` is not specified, removes all routes for
+the `url`.
+
+## expect_event
+
+```
+def expect_event(event, predicate: nil, timeout: nil, &block)
+```
+
+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 context closes before the event is fired. Returns the event data value.
+
+```ruby
+new_page = browser_context.expect_event('page') do
+  page.click('button')
+end
+```
+
+
+
+## expect_page
+
+```
+def expect_page(predicate: nil, timeout: nil)
+```
+
+Performs action and waits for a new [Page](./page) to be created in the context. If predicate is provided, it passes [Page](./page) value into the `predicate` and waits for `predicate.call(page)` to return a truthy value. Will throw an error if
+the context closes before new [Page](./page) is created.
+
+## tracing