puppeteer-ruby 0.28.1 → 0.31.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61aae6f779d8c0b4566cb9fd8966ba7d5941bda2b0c43754d61616dab29ca555
-  data.tar.gz: f5394e8ac944d188795e8a4eff87a60b2b226b659d8183ac1003d2d9f1c9c27b
+  metadata.gz: 6c29d76a1dd9f52a59eecdb311ab8c110a3393bc1500aea3df7d5defdc469d4f
+  data.tar.gz: 296188c1573813718e0f3d320ceff5bbd8f036f8326f04499e6d81a77ca92051
 SHA512:
-  metadata.gz: e51fc1ffce61bf542d4057803ae3f2ac811285b54a221d4bc2ce6cfccc18e9de2828ba98de82d246efa7b1fdf58c44cce8e9205ac1343889f173462b8dd8f546
-  data.tar.gz: 4b5706d9f926372415acafa3c0d9339d653dd35542642a48593d400fd929ec03f1f32cd5624d99b0c1e870471f591c385b18b02b742d8b83d501fef599f64ffc
+  metadata.gz: 25411b18a7d0279ebc736981cc47db542340d49c01429b8419e95e3f3d3c66ce633de11c8b645a0eb1643dc41adedb215522d0f2a06d173cd6140aeedb44156f
+  data.tar.gz: e1cc9c01f114534c4c44df4f036a9c9743b7330c1cfee710799381d9cdafe736d2c04498c673e3d79cd64671d4f270fcd37fc7cd0cbebf07d423736a5705851f

data/CHANGELOG.md

@@ -1,7 +1,41 @@
-### master [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.28.1...master)]
+### master [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.3...master)]
 
 * xxx
 
+### 0.31.3 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.1...0.31.3)]
+
+Bugfix:
+
+* Fix `wait_for_selector` to work. *It is strongly recommended to update for 0.29.0-0.31.x users.*
+
+### 0.31.1 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.0...0.31.1)]
+
+Bugfix:
+
+* Fix `Page#pdf` to work on Windows.
+
+### 0.31.0 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.30.0...0.31.0)]
+
+New features:
+
+* Now puppeteer-ruby is compatible with Windows
+
+Bugfix:
+
+* Fix `Page#add_script_tag` and `Page#add_style_tag` to work
+
+### 0.30.0 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.29.0...0.30.0)]
+
+New features:
+
+* S, SS, Seval, SSeval is renamed to query_selector, query_selector_all, eval_on_selector, eval_on_selector_all
+
+### 0.29.0 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.28.1...0.29.0)]
+
+New features:
+
+* Add `AriaQueryHandler`. Now we can use "aria/...." for selectors.
+
 ### 0.28.1 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.0.27...0.28.1)]
 
 New features:

data/README.md

@@ -1,18 +1,36 @@
 [![Gem Version](https://badge.fury.io/rb/puppeteer-ruby.svg)](https://badge.fury.io/rb/puppeteer-ruby)
 
-# Puppeteer in Ruby [UNDER HEAVY DEVELOPMENT]
+# Puppeteer in Ruby
 
 A Ruby port of [puppeteer](https://pptr.dev/).
 
 ![logo](puppeteer-ruby.png)
 
-REMARK: This Gem is NOT production-ready!!
+REMARK: This Gem covers just a part of Puppeteer APIs. See [API Coverage list](./docs/api_coverage.md) for detail. Feedbacks and feature requests are welcome :)
 
 ## Getting Started
 
+### Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'puppeteer-ruby'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install puppeteer-ruby
+
 ### Capture a site
 
 ```ruby
+require 'puppeteer'
+
 Puppeteer.launch(headless: false) do |browser|
   page = browser.pages.first || browser.new_page
   page.goto("https://github.com/YusukeIwaki")
@@ -30,18 +48,18 @@ Puppeteer.launch(headless: false, slow_mo: 50, args: ['--guest', '--window-size=
   page.viewport = Puppeteer::Viewport.new(width: 1280, height: 800)
   page.goto("https://github.com/", wait_until: 'domcontentloaded')
 
-  form = page.S("form.js-site-search-form")
-  searchInput = form.S("input.header-search-input")
+  form = page.query_selector("form.js-site-search-form")
+  searchInput = form.query_selector("input.header-search-input")
   searchInput.type_text("puppeteer")
   await_all(
     page.async_wait_for_navigation,
     searchInput.async_press("Enter"),
   )
 
-  list = page.S("ul.repo-list")
-  items = list.SS("div.f4")
+  list = page.query_selector("ul.repo-list")
+  items = list.query_selector_all("div.f4")
   items.each do |item|
-    title = item.Seval("a", "a => a.innerText")
+    title = item.eval_on_selector("a", "a => a.innerText")
     puts("==> #{title}")
   end
 end
@@ -50,6 +68,8 @@ end
 ### Evaluate JavaScript
 
 ```ruby
+require 'puppeteer'
+
 Puppeteer.launch do |browser|
   page = browser.pages.last || browser.new_page
   page.goto 'https://github.com/YusukeIwaki'
@@ -114,7 +134,7 @@ RSpec.describe 'hotel.testplanisphere.dev', type: :feature do
     puppeteer_page = @browser.pages.first
     puppeteer_page.wait_for_selector('li.nav-item')
 
-    reservation_link = puppeteer_page.SS('li.nav-item')[1]
+    reservation_link = puppeteer_page.query_selector_all('li.nav-item')[1]
 
     await_all(
       puppeteer_page.async_wait_for_navigation,
@@ -131,7 +151,7 @@ RSpec.describe 'hotel.testplanisphere.dev', type: :feature do
 
     # expectation with puppeteer
     puppeteer_page = @browser.pages.first
-    body_text = puppeteer_page.Seval('body', '(el) => el.textContent')
+    body_text = puppeteer_page.eval_on_selector('body', '(el) => el.textContent')
     expect(body_text).to include('宿泊プラン一覧')
   end
 ```

data/docs/api_coverage.md

@@ -0,0 +1,359 @@
+# API coverages
+- Puppeteer version: v8.0.0
+- puppeteer-ruby version: 0.31.3
+
+## Puppeteer
+
+* ~~clearCustomQueryHandlers~~
+* connect
+* ~~createBrowserFetcher~~
+* ~~customQueryHandlerNames~~
+* defaultArgs => `#default_args`
+* devices
+* ~~errors~~
+* executablePath => `#executable_path`
+* launch
+* ~~networkConditions~~
+* product
+* ~~registerCustomQueryHandler~~
+* ~~unregisterCustomQueryHandler~~
+
+## ~~BrowserFetcher~~
+
+* ~~canDownload~~
+* ~~download~~
+* ~~host~~
+* ~~localRevisions~~
+* ~~platform~~
+* ~~product~~
+* ~~remove~~
+* ~~revisionInfo~~
+
+## Browser
+
+* browserContexts => `#browser_contexts`
+* close
+* createIncognitoBrowserContext => `#create_incognito_browser_context`
+* defaultBrowserContext => `#default_browser_context`
+* disconnect
+* isConnected => `#connected?`
+* newPage => `#new_page`
+* pages
+* process
+* target
+* targets
+* userAgent => `#user_agent`
+* version
+* waitForTarget => `#wait_for_target`
+* wsEndpoint => `#ws_endpoint`
+
+## BrowserContext
+
+* browser
+* clearPermissionOverrides => `#clear_permission_overrides`
+* close
+* isIncognito => `#incognito?`
+* newPage => `#new_page`
+* overridePermissions => `#override_permissions`
+* pages
+* targets
+* waitForTarget => `#wait_for_target`
+
+## Page
+
+* $ => `#query_selector`
+* $$ => `#query_selector_all`
+* $$eval => `#eval_on_selector_all`
+* $eval => `#eval_on_selector`
+* $x => `#Sx`
+* accessibility
+* addScriptTag => `#add_script_tag`
+* addStyleTag => `#add_style_tag`
+* authenticate
+* ~~bringToFront~~
+* browser
+* browserContext => `#browser_context`
+* click
+* close
+* content
+* cookies
+* coverage
+* deleteCookie => `#delete_cookie`
+* emulate
+* emulateIdleState => `#emulate_idle_state`
+* ~~emulateMediaFeatures~~
+* emulateMediaType => `#emulate_media_type`
+* ~~emulateNetworkConditions~~
+* emulateTimezone => `#emulate_timezone`
+* ~~emulateVisionDeficiency~~
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* evaluateOnNewDocument => `#evaluate_on_new_document`
+* ~~exposeFunction~~
+* focus
+* frames
+* goBack => `#go_back`
+* goForward => `#go_forward`
+* goto
+* hover
+* isClosed => `#closed?`
+* isJavaScriptEnabled => `#javascript_enabled?`
+* keyboard
+* mainFrame => `#main_frame`
+* ~~metrics~~
+* mouse
+* pdf
+* queryObjects => `#query_objects`
+* reload
+* screenshot
+* select
+* setBypassCSP => `#bypass_csp=`
+* setCacheEnabled => `#cache_enabled=`
+* setContent => `#content=`
+* setCookie => `#set_cookie`
+* setDefaultNavigationTimeout => `#default_navigation_timeout=`
+* setDefaultTimeout => `#default_timeout=`
+* setExtraHTTPHeaders => `#extra_http_headers=`
+* setGeolocation => `#geolocation=`
+* setJavaScriptEnabled => `#javascript_enabled=`
+* setOfflineMode => `#offline_mode=`
+* setRequestInterception => `#request_interception=`
+* setUserAgent => `#user_agent=`
+* setViewport => `#viewport=`
+* tap
+* target
+* title
+* ~~touchscreen~~
+* ~~tracing~~
+* type => `#type_text`
+* url
+* viewport
+* ~~waitFor~~
+* waitForFileChooser => `#wait_for_file_chooser`
+* waitForFunction => `#wait_for_function`
+* waitForNavigation => `#async_wait_for_navigation`
+* waitForRequest => `#async_wait_for_request`
+* waitForResponse => `#async_wait_for_response`
+* waitForSelector => `#wait_for_selector`
+* waitForTimeout => `#wait_for_timeout`
+* waitForXPath => `#wait_for_xpath`
+* workers
+
+## ~~WebWorker~~
+
+* ~~evaluate~~
+* ~~evaluateHandle~~
+* ~~executionContext~~
+* ~~url~~
+
+## ~~Accessibility~~
+
+* ~~snapshot~~
+
+## Keyboard
+
+* down
+* press
+* sendCharacter => `#send_character`
+* type => `#type_text`
+* up
+
+## Mouse
+
+* click
+* down
+* move
+* up
+* wheel
+
+## ~~Touchscreen~~
+
+* ~~tap~~
+
+## ~~Tracing~~
+
+* ~~start~~
+* ~~stop~~
+
+## FileChooser
+
+* accept
+* cancel
+* isMultiple => `#multiple?`
+
+## Dialog
+
+* accept
+* defaultValue => `#default_value`
+* dismiss
+* message
+* type
+
+## ConsoleMessage
+
+* args
+* location
+* ~~stackTrace~~
+* text
+* ~~type~~
+
+## Frame
+
+* $ => `#query_selector`
+* $$ => `#query_selector_all`
+* $$eval => `#eval_on_selector_all`
+* $eval => `#eval_on_selector`
+* $x => `#Sx`
+* addScriptTag => `#add_script_tag`
+* addStyleTag => `#add_style_tag`
+* childFrames => `#child_frames`
+* click
+* content
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* executionContext => `#execution_context`
+* focus
+* goto
+* hover
+* isDetached => `#detached?`
+* name
+* parentFrame => `#parent_frame`
+* select
+* setContent => `#set_content`
+* tap
+* title
+* type => `#type_text`
+* url
+* ~~waitFor~~
+* waitForFunction => `#wait_for_function`
+* waitForNavigation => `#async_wait_for_navigation`
+* waitForSelector => `#wait_for_selector`
+* waitForTimeout => `#wait_for_timeout`
+* waitForXPath => `#wait_for_xpath`
+
+## ExecutionContext
+
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* frame
+* ~~queryObjects~~
+
+## JSHandle
+
+* asElement => `#as_element`
+* dispose
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* executionContext => `#execution_context`
+* getProperties => `#properties`
+* getProperty => `#[]`
+* jsonValue => `#json_value`
+
+## ElementHandle
+
+* $ => `#query_selector`
+* $$ => `#query_selector_all`
+* $$eval => `#eval_on_selector_all`
+* $eval => `#eval_on_selector`
+* $x => `#Sx`
+* asElement => `#as_element`
+* boundingBox => `#bounding_box`
+* boxModel => `#box_model`
+* click
+* contentFrame => `#content_frame`
+* dispose
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* executionContext => `#execution_context`
+* focus
+* getProperties => `#properties`
+* getProperty => `#[]`
+* hover
+* isIntersectingViewport => `#intersecting_viewport?`
+* jsonValue => `#json_value`
+* press
+* screenshot
+* select
+* tap
+* ~~toString~~
+* type => `#type_text`
+* uploadFile => `#upload_file`
+
+## ~~HTTPRequest~~
+
+* ~~abort~~
+* ~~continue~~
+* ~~failure~~
+* ~~frame~~
+* ~~headers~~
+* ~~isNavigationRequest~~
+* ~~method~~
+* ~~postData~~
+* ~~redirectChain~~
+* ~~resourceType~~
+* ~~respond~~
+* ~~response~~
+* ~~url~~
+
+## ~~HTTPResponse~~
+
+* ~~buffer~~
+* ~~frame~~
+* ~~fromCache~~
+* ~~fromServiceWorker~~
+* ~~headers~~
+* ~~json~~
+* ~~ok~~
+* ~~remoteAddress~~
+* ~~request~~
+* ~~securityDetails~~
+* ~~status~~
+* ~~statusText~~
+* ~~text~~
+* ~~url~~
+
+## ~~SecurityDetails~~
+
+* ~~issuer~~
+* ~~protocol~~
+* ~~subjectAlternativeNames~~
+* ~~subjectName~~
+* ~~validFrom~~
+* ~~validTo~~
+
+## Target
+
+* browser
+* browserContext => `#browser_context`
+* createCDPSession => `#create_cdp_session`
+* opener
+* page
+* type
+* url
+* ~~worker~~
+
+## CDPSession
+
+* detach
+* send
+
+## ~~Coverage~~
+
+* ~~startCSSCoverage~~
+* ~~startJSCoverage~~
+* ~~stopCSSCoverage~~
+* ~~stopJSCoverage~~
+
+## TimeoutError
+
+
+## ~~EventEmitter~~
+
+* ~~addListener~~
+* ~~emit~~
+* ~~listenerCount~~
+* ~~off~~
+* ~~on~~
+* ~~once~~
+* ~~removeAllListeners~~
+* ~~removeListener~~