puppeteer-ruby 0.29.0 → 0.31.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b852a48cd11f269c3b4eec0a85583b120a5cd1b0bc204e27a6ec0e365aa33dd
-  data.tar.gz: 8864c21fe02f6e3fcbb07c6c009516e91273ecfe0636437bc41015187e9985ad
+  metadata.gz: ff91cc32cf078ad68ba001f02b0f9f3e614778e3b40f0622fd63570a6915ad52
+  data.tar.gz: b12ef40943838b16f0cafc9f7cc2b0c046bab5dc03e99729f8726cc912fbbef8
 SHA512:
-  metadata.gz: dd3cdb6d7b64b0b6f6e2568eb83cad62f36ea45943f0df9cd434c6e30221ccd47b161a0368cbe02cacf4a6a3c6c6ecf293bd1313829d7f02daed5d1d2c5c9f73
-  data.tar.gz: 541c2dffa4c6359dff6c2d9d03e70a039057d554c1ee6509d0574d194f17a6407a968c30153bae850f8c4c0e9fa7ade7beaea2dcc8d136a896e80b22831a436f
+  metadata.gz: a84bdfa144789d50926e0d2177711b7ff43f025948e6832b11c7105a3923c84597909bd142db54cac1b09c4ede013bd6f9b94a991888d0c4c420aaf5c2f4511b
+  data.tar.gz: 6558efa9f6ba92544a236aa17a9e879332ab2f03bbc2115e2035930b15b5ebb8a5d85b93558f961a8ee9258c22a766ce4fc9baf45a586c6836dede1511bab6dd

data/CHANGELOG.md

@@ -1,14 +1,47 @@
-### master [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.29.0...master)]
+### master [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.4...master)]
 
 * xxx
 
+### 0.31.4 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.3...0.31.4)]
+
+Bugfix:
+
+* Fix PDF options (format, margin, omit_background) to work.
+
+### 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

@@ -6,7 +6,7 @@ A Ruby port of [puppeteer](https://pptr.dev/).
 
 ![logo](puppeteer-ruby.png)
 
-REMARK: This Gem covers just a part of Puppeteer APIs. Feedbacks and feature requests are welcome :)
+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
 
@@ -29,6 +29,8 @@ Or install it yourself as:
 ### 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")
@@ -46,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
@@ -66,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'
@@ -130,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,
@@ -147,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.4
+
+## 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~~