puppeteer-bidi 0.0.1.beta10 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a52c1dcb0d3a791f2754c968a543411c98051380796455da1f0e24404923aa8
-  data.tar.gz: cd9c3880fe2f8ab49201c681efd39a95a77b477e6445cd620e3cdb3e7a7014d3
+  metadata.gz: 7242d594b90af9ed2739ef56e234d3d26805cf19d688212e9b0b68ad823a96c2
+  data.tar.gz: 6bca1fe1f82165851376466367cee72ec59f10fabb6b2970a70bcffde5ef42b6
 SHA512:
-  metadata.gz: 516d9e6b86a99902e20db1fd43d7d8521fcf8ce6850d72cf253cc6ae5af97f5bd591e2138f0c733d2d96f89f606e45f3d8b6f015ca4730e7b8f75b306dcbd0df
-  data.tar.gz: a2314ab02834c9ded0abdf5ba85bbae5dcf2252c9dbeaaf81c9f2d6c332d16fc291a6b18d6e36bc470d0585f960fb4cac8aa090467329fa816b47e693df7b024
+  metadata.gz: 1c7f73fa6f5351d1e1e12a87388e56c05faa11286bf724e400ec97e19092a81a6e22c6718970c028305717afdaf560ddd16dbfa6f499b5dbc28313b8b55d3347
+  data.tar.gz: ad2cc2f58a6da1d6bff87bde5eab283536f46aa160bbc3ac197c6574f9fd5f35950ca47331c9363feea4a93eaa8af76322f38b123e31d9212206d01e01d2d9d4

data/AGENTS.md

@@ -0,0 +1,44 @@
+# Repository Guidelines
+
+## Start Here (Project-Specific Guidance)
+
+- Read `CLAUDE.md` and `CLAUDE/` first; they define the core async architecture, porting workflow, and testing strategy.
+- Ruby: requires `>= 3.2` (CI covers 3.2–3.4). Prefer a version manager (`rbenv`, `asdf`, etc.) over system Ruby.
+
+## Project Structure & Module Organization
+
+- `lib/puppeteer/bidi/`: user-facing API (sync, calls `.wait`).
+- `lib/puppeteer/bidi/core/`: low-level BiDi core (async, returns `Async::Task`).
+- `spec/integration/`: browser-driven specs; fixtures in `spec/assets/`.
+
+## Build, Test, and Development Commands
+
+- See `DEVELOPMENT.md` for the full command list and environment variables.
+- Run RSpec via `rbenv exec bundle exec rspec ...` when using rbenv.
+
+## Coding Style & Naming Conventions
+
+- Ruby: 2-space indent, double-quoted strings, ~120 char lines; follow RuboCop (`.rubocop.yml`).
+- BiDi-only: do not introduce CDP-related ports.
+- Async: core returns `Async::Task`; upper layer must call `.wait` on every core call (see `CLAUDE/two_layer_architecture.md`).
+- Reviews to watch: WS messages can be handled out-of-order; “wait for event” code must not hang (register listeners before commands, handle “already happened”, cancel on errors).
+
+## Testing Guidelines
+
+- Prefer `spec/integration/` and the shared-browser `with_test_state` pattern (see `CLAUDE/testing_strategy.md`).
+- Use `pending` for browser limitations vs `skip` for unimplemented features.
+
+## Commit & Pull Request Guidelines
+
+- See `DEVELOPMENT.md` for commit, PR, and release conventions.
+
+## Agent Notes (Porting/Review)
+
+- When porting from upstream TS, mirror optional vs default fields: defaults are for validation, and optional keys should be omitted from payloads unless explicitly provided.
+- Match upstream error messages as closely as possible (including interpolated values) so tests align with Puppeteer.
+- In core layer option checks, use key presence (`options.key?`) when upstream uses `'in'` to distinguish "missing" from `nil`.
+- During reviews, compare both implementation (`packages/puppeteer-core/src/bidi/*.ts`) and tests (`test/src/page.spec.ts`) to catch behavior parity gaps.
+
+## Security & Configuration Tips
+
+- Do not commit credentials; review network-fetched changes (e.g., `scripts/update_injected_source.rb` → `lib/puppeteer/bidi/injected.js`) carefully.

data/API_COVERAGE.md

@@ -0,0 +1,331 @@
+# API Coverage
+
+- Puppeteer commit: `7d750c25cb29764f2fb31cb90b750a8eec350199`
+- Generated by: `development/generate_api_coverage.rb`
+- Coverage: `182/265` (`68.68%`)
+
+## Browser (Puppeteer::Bidi::Browser)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `Browser.addScreen` | `Puppeteer::Bidi::Browser#add_screen` | ❌ |
+| `Browser.browserContexts` | `Puppeteer::Bidi::Browser#browser_contexts` | ❌ |
+| `Browser.close` | `Puppeteer::Bidi::Browser#close` | ✅ |
+| `Browser.cookies` | `Puppeteer::Bidi::Browser#cookies` | ✅ |
+| `Browser.createBrowserContext` | `Puppeteer::Bidi::Browser#create_browser_context` | ✅ |
+| `Browser.defaultBrowserContext` | `Puppeteer::Bidi::Browser#default_browser_context` | ✅ |
+| `Browser.deleteCookie` | `Puppeteer::Bidi::Browser#delete_cookie` | ✅ |
+| `Browser.deleteMatchingCookies` | `Puppeteer::Bidi::Browser#delete_matching_cookies` | ✅ |
+| `Browser.disconnect` | `Puppeteer::Bidi::Browser#disconnect` | ✅ |
+| `Browser.getWindowBounds` | `Puppeteer::Bidi::Browser#get_window_bounds` | ❌ |
+| `Browser.installExtension` | `Puppeteer::Bidi::Browser#install_extension` | ❌ |
+| `Browser.isConnected` | `Puppeteer::Bidi::Browser#is_connected` | ❌ |
+| `Browser.newPage` | `Puppeteer::Bidi::Browser#new_page` | ✅ |
+| `Browser.pages` | `Puppeteer::Bidi::Browser#pages` | ✅ |
+| `Browser.process` | `Puppeteer::Bidi::Browser#process` | ✅ |
+| `Browser.removeScreen` | `Puppeteer::Bidi::Browser#remove_screen` | ❌ |
+| `Browser.screens` | `Puppeteer::Bidi::Browser#screens` | ❌ |
+| `Browser.setCookie` | `Puppeteer::Bidi::Browser#set_cookie` | ✅ |
+| `Browser.setWindowBounds` | `Puppeteer::Bidi::Browser#set_window_bounds` | ❌ |
+| `Browser.target` | `Puppeteer::Bidi::Browser#target` | ❌ |
+| `Browser.targets` | `Puppeteer::Bidi::Browser#targets` | ❌ |
+| `Browser.uninstallExtension` | `Puppeteer::Bidi::Browser#uninstall_extension` | ❌ |
+| `Browser.userAgent` | `Puppeteer::Bidi::Browser#user_agent` | ✅ |
+| `Browser.version` | `Puppeteer::Bidi::Browser#version` | ❌ |
+| `Browser.waitForTarget` | `Puppeteer::Bidi::Browser#wait_for_target` | ✅ |
+| `Browser.wsEndpoint` | `Puppeteer::Bidi::Browser#ws_endpoint` | ✅ |
+
+## BrowserContext (Puppeteer::Bidi::BrowserContext)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `BrowserContext.browser` | `Puppeteer::Bidi::BrowserContext#browser` | ✅ |
+| `BrowserContext.clearPermissionOverrides` | `Puppeteer::Bidi::BrowserContext#clear_permission_overrides` | ❌ |
+| `BrowserContext.close` | `Puppeteer::Bidi::BrowserContext#close` | ✅ |
+| `BrowserContext.cookies` | `Puppeteer::Bidi::BrowserContext#cookies` | ✅ |
+| `BrowserContext.deleteCookie` | `Puppeteer::Bidi::BrowserContext#delete_cookie` | ✅ |
+| `BrowserContext.deleteMatchingCookies` | `Puppeteer::Bidi::BrowserContext#delete_matching_cookies` | ✅ |
+| `BrowserContext.newPage` | `Puppeteer::Bidi::BrowserContext#new_page` | ✅ |
+| `BrowserContext.overridePermissions` | `Puppeteer::Bidi::BrowserContext#override_permissions` | ✅ |
+| `BrowserContext.pages` | `Puppeteer::Bidi::BrowserContext#pages` | ✅ |
+| `BrowserContext.setCookie` | `Puppeteer::Bidi::BrowserContext#set_cookie` | ✅ |
+| `BrowserContext.targets` | `Puppeteer::Bidi::BrowserContext#targets` | ❌ |
+| `BrowserContext.waitForTarget` | `Puppeteer::Bidi::BrowserContext#wait_for_target` | ❌ |
+
+## ElementHandle (Puppeteer::Bidi::ElementHandle)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `ElementHandle.$` | `Puppeteer::Bidi::ElementHandle#query_selector` | ✅ |
+| `ElementHandle.$$` | `Puppeteer::Bidi::ElementHandle#query_selector_all` | ✅ |
+| `ElementHandle.$$eval` | `Puppeteer::Bidi::ElementHandle#eval_on_selector_all` | ✅ |
+| `ElementHandle.$eval` | `Puppeteer::Bidi::ElementHandle#eval_on_selector` | ✅ |
+| `ElementHandle.asLocator` | `Puppeteer::Bidi::ElementHandle#as_locator` | ✅ |
+| `ElementHandle.autofill` | `Puppeteer::Bidi::ElementHandle#autofill` | ❌ |
+| `ElementHandle.backendNodeId` | `Puppeteer::Bidi::ElementHandle#backend_node_id` | ❌ |
+| `ElementHandle.boundingBox` | `Puppeteer::Bidi::ElementHandle#bounding_box` | ✅ |
+| `ElementHandle.boxModel` | `Puppeteer::Bidi::ElementHandle#box_model` | ✅ |
+| `ElementHandle.click` | `Puppeteer::Bidi::ElementHandle#click` | ✅ |
+| `ElementHandle.clickablePoint` | `Puppeteer::Bidi::ElementHandle#clickable_point` | ✅ |
+| `ElementHandle.contentFrame` | `Puppeteer::Bidi::ElementHandle#content_frame` | ✅ |
+| `ElementHandle.drag` | `Puppeteer::Bidi::ElementHandle#drag` | ❌ |
+| `ElementHandle.dragAndDrop` | `Puppeteer::Bidi::ElementHandle#drag_and_drop` | ❌ |
+| `ElementHandle.dragEnter` | `Puppeteer::Bidi::ElementHandle#drag_enter` | ❌ |
+| `ElementHandle.dragOver` | `Puppeteer::Bidi::ElementHandle#drag_over` | ❌ |
+| `ElementHandle.drop` | `Puppeteer::Bidi::ElementHandle#drop` | ❌ |
+| `ElementHandle.focus` | `Puppeteer::Bidi::ElementHandle#focus` | ✅ |
+| `ElementHandle.hover` | `Puppeteer::Bidi::ElementHandle#hover` | ✅ |
+| `ElementHandle.isHidden` | `Puppeteer::Bidi::ElementHandle#hidden?` | ✅ |
+| `ElementHandle.isIntersectingViewport` | `Puppeteer::Bidi::ElementHandle#intersecting_viewport?` | ✅ |
+| `ElementHandle.isVisible` | `Puppeteer::Bidi::ElementHandle#visible?` | ✅ |
+| `ElementHandle.press` | `Puppeteer::Bidi::ElementHandle#press` | ✅ |
+| `ElementHandle.screenshot` | `Puppeteer::Bidi::ElementHandle#screenshot` | ✅ |
+| `ElementHandle.scrollIntoView` | `Puppeteer::Bidi::ElementHandle#scroll_into_view` | ✅ |
+| `ElementHandle.select` | `Puppeteer::Bidi::ElementHandle#select` | ✅ |
+| `ElementHandle.tap` | `Puppeteer::Bidi::ElementHandle#tap` | ❌ |
+| `ElementHandle.toElement` | `Puppeteer::Bidi::ElementHandle#to_element` | ✅ |
+| `ElementHandle.touchEnd` | `Puppeteer::Bidi::ElementHandle#touch_end` | ❌ |
+| `ElementHandle.touchMove` | `Puppeteer::Bidi::ElementHandle#touch_move` | ❌ |
+| `ElementHandle.touchStart` | `Puppeteer::Bidi::ElementHandle#touch_start` | ❌ |
+| `ElementHandle.type` | `Puppeteer::Bidi::ElementHandle#type` | ✅ |
+| `ElementHandle.uploadFile` | `Puppeteer::Bidi::ElementHandle#upload_file` | ✅ |
+| `ElementHandle.waitForSelector` | `Puppeteer::Bidi::ElementHandle#wait_for_selector` | ✅ |
+
+## FileChooser (Puppeteer::Bidi::FileChooser)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `FileChooser.accept` | `Puppeteer::Bidi::FileChooser#accept` | ✅ |
+| `FileChooser.cancel` | `Puppeteer::Bidi::FileChooser#cancel` | ✅ |
+| `FileChooser.isMultiple` | `Puppeteer::Bidi::FileChooser#multiple?` | ✅ |
+
+## Frame (Puppeteer::Bidi::Frame)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `Frame.$` | `Puppeteer::Bidi::Frame#query_selector` | ✅ |
+| `Frame.$$` | `Puppeteer::Bidi::Frame#query_selector_all` | ✅ |
+| `Frame.$$eval` | `Puppeteer::Bidi::Frame#eval_on_selector_all` | ✅ |
+| `Frame.$eval` | `Puppeteer::Bidi::Frame#eval_on_selector` | ✅ |
+| `Frame.addScriptTag` | `Puppeteer::Bidi::Frame#add_script_tag` | ❌ |
+| `Frame.addStyleTag` | `Puppeteer::Bidi::Frame#add_style_tag` | ❌ |
+| `Frame.childFrames` | `Puppeteer::Bidi::Frame#child_frames` | ✅ |
+| `Frame.click` | `Puppeteer::Bidi::Frame#click` | ✅ |
+| `Frame.content` | `Puppeteer::Bidi::Frame#content` | ✅ |
+| `Frame.evaluate` | `Puppeteer::Bidi::Frame#evaluate` | ✅ |
+| `Frame.evaluateHandle` | `Puppeteer::Bidi::Frame#evaluate_handle` | ✅ |
+| `Frame.focus` | `Puppeteer::Bidi::Frame#focus` | ❌ |
+| `Frame.frameElement` | `Puppeteer::Bidi::Frame#frame_element` | ✅ |
+| `Frame.goto` | `Puppeteer::Bidi::Frame#goto` | ✅ |
+| `Frame.hover` | `Puppeteer::Bidi::Frame#hover` | ✅ |
+| `Frame.isDetached` | `Puppeteer::Bidi::Frame#detached?` | ✅ |
+| `Frame.locator` | `Puppeteer::Bidi::Frame#locator` | ✅ |
+| `Frame.name` | `Puppeteer::Bidi::Frame#name` | ✅ |
+| `Frame.page` | `Puppeteer::Bidi::Frame#page` | ✅ |
+| `Frame.parentFrame` | `Puppeteer::Bidi::Frame#parent_frame` | ✅ |
+| `Frame.select` | `Puppeteer::Bidi::Frame#select` | ✅ |
+| `Frame.setContent` | `Puppeteer::Bidi::Frame#set_content` | ✅ |
+| `Frame.tap` | `Puppeteer::Bidi::Frame#tap` | ❌ |
+| `Frame.title` | `Puppeteer::Bidi::Frame#title` | ❌ |
+| `Frame.type` | `Puppeteer::Bidi::Frame#type` | ✅ |
+| `Frame.url` | `Puppeteer::Bidi::Frame#url` | ✅ |
+| `Frame.waitForFunction` | `Puppeteer::Bidi::Frame#wait_for_function` | ✅ |
+| `Frame.waitForNavigation` | `Puppeteer::Bidi::Frame#wait_for_navigation` | ✅ |
+| `Frame.waitForSelector` | `Puppeteer::Bidi::Frame#wait_for_selector` | ✅ |
+
+## HTTPRequest (Puppeteer::Bidi::HTTPRequest)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `HTTPRequest.abort` | `Puppeteer::Bidi::HTTPRequest#abort` | ✅ |
+| `HTTPRequest.abortErrorReason` | `Puppeteer::Bidi::HTTPRequest#abort_error_reason` | ✅ |
+| `HTTPRequest.continue` | `Puppeteer::Bidi::HTTPRequest#continue` | ✅ |
+| `HTTPRequest.continueRequestOverrides` | `Puppeteer::Bidi::HTTPRequest#continue_request_overrides` | ✅ |
+| `HTTPRequest.enqueueInterceptAction` | `Puppeteer::Bidi::HTTPRequest#enqueue_intercept_action` | ✅ |
+| `HTTPRequest.failure` | `Puppeteer::Bidi::HTTPRequest#failure` | ✅ |
+| `HTTPRequest.fetchPostData` | `Puppeteer::Bidi::HTTPRequest#fetch_post_data` | ✅ |
+| `HTTPRequest.finalizeInterceptions` | `Puppeteer::Bidi::HTTPRequest#finalize_interceptions` | ✅ |
+| `HTTPRequest.frame` | `Puppeteer::Bidi::HTTPRequest#frame` | ✅ |
+| `HTTPRequest.hasPostData` | `Puppeteer::Bidi::HTTPRequest#has_post_data` | ❌ |
+| `HTTPRequest.headers` | `Puppeteer::Bidi::HTTPRequest#headers` | ✅ |
+| `HTTPRequest.initiator` | `Puppeteer::Bidi::HTTPRequest#initiator` | ✅ |
+| `HTTPRequest.interceptResolutionState` | `Puppeteer::Bidi::HTTPRequest#intercept_resolution_state` | ✅ |
+| `HTTPRequest.isInterceptResolutionHandled` | `Puppeteer::Bidi::HTTPRequest#intercept_resolution_handled?` | ✅ |
+| `HTTPRequest.isNavigationRequest` | `Puppeteer::Bidi::HTTPRequest#navigation_request?` | ✅ |
+| `HTTPRequest.method` | `Puppeteer::Bidi::HTTPRequest#method` | ✅ |
+| `HTTPRequest.postData` | `Puppeteer::Bidi::HTTPRequest#post_data` | ✅ |
+| `HTTPRequest.redirectChain` | `Puppeteer::Bidi::HTTPRequest#redirect_chain` | ✅ |
+| `HTTPRequest.resourceType` | `Puppeteer::Bidi::HTTPRequest#resource_type` | ✅ |
+| `HTTPRequest.respond` | `Puppeteer::Bidi::HTTPRequest#respond` | ✅ |
+| `HTTPRequest.response` | `Puppeteer::Bidi::HTTPRequest#response` | ✅ |
+| `HTTPRequest.responseForRequest` | `Puppeteer::Bidi::HTTPRequest#response_for_request` | ✅ |
+| `HTTPRequest.url` | `Puppeteer::Bidi::HTTPRequest#url` | ✅ |
+
+## HTTPResponse (Puppeteer::Bidi::HTTPResponse)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `HTTPResponse.buffer` | `Puppeteer::Bidi::HTTPResponse#buffer` | ✅ |
+| `HTTPResponse.content` | `Puppeteer::Bidi::HTTPResponse#content` | ✅ |
+| `HTTPResponse.frame` | `Puppeteer::Bidi::HTTPResponse#frame` | ✅ |
+| `HTTPResponse.fromCache` | `Puppeteer::Bidi::HTTPResponse#from_cache` | ❌ |
+| `HTTPResponse.fromServiceWorker` | `Puppeteer::Bidi::HTTPResponse#from_service_worker` | ❌ |
+| `HTTPResponse.headers` | `Puppeteer::Bidi::HTTPResponse#headers` | ✅ |
+| `HTTPResponse.json` | `Puppeteer::Bidi::HTTPResponse#json` | ✅ |
+| `HTTPResponse.ok` | `Puppeteer::Bidi::HTTPResponse#ok` | ❌ |
+| `HTTPResponse.remoteAddress` | `Puppeteer::Bidi::HTTPResponse#remote_address` | ✅ |
+| `HTTPResponse.request` | `Puppeteer::Bidi::HTTPResponse#request` | ✅ |
+| `HTTPResponse.securityDetails` | `Puppeteer::Bidi::HTTPResponse#security_details` | ✅ |
+| `HTTPResponse.status` | `Puppeteer::Bidi::HTTPResponse#status` | ✅ |
+| `HTTPResponse.statusText` | `Puppeteer::Bidi::HTTPResponse#status_text` | ✅ |
+| `HTTPResponse.text` | `Puppeteer::Bidi::HTTPResponse#text` | ✅ |
+| `HTTPResponse.timing` | `Puppeteer::Bidi::HTTPResponse#timing` | ✅ |
+| `HTTPResponse.url` | `Puppeteer::Bidi::HTTPResponse#url` | ✅ |
+
+## JSHandle (Puppeteer::Bidi::JSHandle)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `JSHandle.asElement` | `Puppeteer::Bidi::JSHandle#as_element` | ✅ |
+| `JSHandle.dispose` | `Puppeteer::Bidi::JSHandle#dispose` | ✅ |
+| `JSHandle.evaluate` | `Puppeteer::Bidi::JSHandle#evaluate` | ✅ |
+| `JSHandle.evaluateHandle` | `Puppeteer::Bidi::JSHandle#evaluate_handle` | ✅ |
+| `JSHandle.getProperties` | `Puppeteer::Bidi::JSHandle#get_properties` | ✅ |
+| `JSHandle.getProperty` | `Puppeteer::Bidi::JSHandle#get_property` | ✅ |
+| `JSHandle.jsonValue` | `Puppeteer::Bidi::JSHandle#json_value` | ✅ |
+| `JSHandle.remoteObject` | `Puppeteer::Bidi::JSHandle#remote_object` | ✅ |
+| `JSHandle.toString` | `Puppeteer::Bidi::JSHandle#to_string` | ❌ |
+
+## Keyboard (Puppeteer::Bidi::Keyboard)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `Keyboard.down` | `Puppeteer::Bidi::Keyboard#down` | ✅ |
+| `Keyboard.press` | `Puppeteer::Bidi::Keyboard#press` | ✅ |
+| `Keyboard.sendCharacter` | `Puppeteer::Bidi::Keyboard#send_character` | ✅ |
+| `Keyboard.type` | `Puppeteer::Bidi::Keyboard#type` | ✅ |
+| `Keyboard.up` | `Puppeteer::Bidi::Keyboard#up` | ✅ |
+
+## Mouse (Puppeteer::Bidi::Mouse)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `Mouse.click` | `Puppeteer::Bidi::Mouse#click` | ✅ |
+| `Mouse.down` | `Puppeteer::Bidi::Mouse#down` | ✅ |
+| `Mouse.drag` | `Puppeteer::Bidi::Mouse#drag` | ❌ |
+| `Mouse.dragAndDrop` | `Puppeteer::Bidi::Mouse#drag_and_drop` | ❌ |
+| `Mouse.dragEnter` | `Puppeteer::Bidi::Mouse#drag_enter` | ❌ |
+| `Mouse.dragOver` | `Puppeteer::Bidi::Mouse#drag_over` | ❌ |
+| `Mouse.drop` | `Puppeteer::Bidi::Mouse#drop` | ❌ |
+| `Mouse.move` | `Puppeteer::Bidi::Mouse#move` | ✅ |
+| `Mouse.reset` | `Puppeteer::Bidi::Mouse#reset` | ✅ |
+| `Mouse.up` | `Puppeteer::Bidi::Mouse#up` | ✅ |
+| `Mouse.wheel` | `Puppeteer::Bidi::Mouse#wheel` | ✅ |
+
+## Page (Puppeteer::Bidi::Page)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `Page.$` | `Puppeteer::Bidi::Page#query_selector` | ✅ |
+| `Page.$$` | `Puppeteer::Bidi::Page#query_selector_all` | ✅ |
+| `Page.$$eval` | `Puppeteer::Bidi::Page#eval_on_selector_all` | ✅ |
+| `Page.$eval` | `Puppeteer::Bidi::Page#eval_on_selector` | ✅ |
+| `Page.addScriptTag` | `Puppeteer::Bidi::Page#add_script_tag` | ❌ |
+| `Page.addStyleTag` | `Puppeteer::Bidi::Page#add_style_tag` | ❌ |
+| `Page.authenticate` | `Puppeteer::Bidi::Page#authenticate` | ✅ |
+| `Page.bringToFront` | `Puppeteer::Bidi::Page#bring_to_front` | ❌ |
+| `Page.browser` | `Puppeteer::Bidi::Page#browser` | ❌ |
+| `Page.browserContext` | `Puppeteer::Bidi::Page#browser_context` | ✅ |
+| `Page.click` | `Puppeteer::Bidi::Page#click` | ✅ |
+| `Page.close` | `Puppeteer::Bidi::Page#close` | ✅ |
+| `Page.content` | `Puppeteer::Bidi::Page#content` | ✅ |
+| `Page.cookies` | `Puppeteer::Bidi::Page#cookies` | ✅ |
+| `Page.createCDPSession` | `Puppeteer::Bidi::Page#create_cdp_session` | ❌ |
+| `Page.createPDFStream` | `Puppeteer::Bidi::Page#create_pdf_stream` | ❌ |
+| `Page.deleteCookie` | `Puppeteer::Bidi::Page#delete_cookie` | ✅ |
+| `Page.emulate` | `Puppeteer::Bidi::Page#emulate` | ❌ |
+| `Page.emulateCPUThrottling` | `Puppeteer::Bidi::Page#emulate_cpu_throttling` | ❌ |
+| `Page.emulateFocusedPage` | `Puppeteer::Bidi::Page#emulate_focused_page` | ❌ |
+| `Page.emulateIdleState` | `Puppeteer::Bidi::Page#emulate_idle_state` | ❌ |
+| `Page.emulateMediaFeatures` | `Puppeteer::Bidi::Page#emulate_media_features` | ❌ |
+| `Page.emulateMediaType` | `Puppeteer::Bidi::Page#emulate_media_type` | ❌ |
+| `Page.emulateNetworkConditions` | `Puppeteer::Bidi::Page#emulate_network_conditions` | ❌ |
+| `Page.emulateTimezone` | `Puppeteer::Bidi::Page#emulate_timezone` | ❌ |
+| `Page.emulateVisionDeficiency` | `Puppeteer::Bidi::Page#emulate_vision_deficiency` | ❌ |
+| `Page.evaluate` | `Puppeteer::Bidi::Page#evaluate` | ✅ |
+| `Page.evaluateHandle` | `Puppeteer::Bidi::Page#evaluate_handle` | ✅ |
+| `Page.evaluateOnNewDocument` | `Puppeteer::Bidi::Page#evaluate_on_new_document` | ✅ |
+| `Page.exposeFunction` | `Puppeteer::Bidi::Page#expose_function` | ✅ |
+| `Page.focus` | `Puppeteer::Bidi::Page#focus` | ✅ |
+| `Page.frames` | `Puppeteer::Bidi::Page#frames` | ✅ |
+| `Page.getDefaultNavigationTimeout` | `Puppeteer::Bidi::Page#get_default_navigation_timeout` | ✅ |
+| `Page.getDefaultTimeout` | `Puppeteer::Bidi::Page#get_default_timeout` | ✅ |
+| `Page.goBack` | `Puppeteer::Bidi::Page#go_back` | ✅ |
+| `Page.goForward` | `Puppeteer::Bidi::Page#go_forward` | ✅ |
+| `Page.goto` | `Puppeteer::Bidi::Page#goto` | ✅ |
+| `Page.hover` | `Puppeteer::Bidi::Page#hover` | ✅ |
+| `Page.isClosed` | `Puppeteer::Bidi::Page#closed?` | ✅ |
+| `Page.isDragInterceptionEnabled` | `Puppeteer::Bidi::Page#is_drag_interception_enabled` | ❌ |
+| `Page.isJavaScriptEnabled` | `Puppeteer::Bidi::Page#is_java_script_enabled` | ❌ |
+| `Page.isServiceWorkerBypassed` | `Puppeteer::Bidi::Page#is_service_worker_bypassed` | ❌ |
+| `Page.locator` | `Puppeteer::Bidi::Page#locator` | ✅ |
+| `Page.mainFrame` | `Puppeteer::Bidi::Page#main_frame` | ✅ |
+| `Page.metrics` | `Puppeteer::Bidi::Page#metrics` | ❌ |
+| `Page.openDevTools` | `Puppeteer::Bidi::Page#open_dev_tools` | ❌ |
+| `Page.pdf` | `Puppeteer::Bidi::Page#pdf` | ❌ |
+| `Page.queryObjects` | `Puppeteer::Bidi::Page#query_objects` | ❌ |
+| `Page.reload` | `Puppeteer::Bidi::Page#reload` | ✅ |
+| `Page.removeExposedFunction` | `Puppeteer::Bidi::Page#remove_exposed_function` | ✅ |
+| `Page.removeScriptToEvaluateOnNewDocument` | `Puppeteer::Bidi::Page#remove_script_to_evaluate_on_new_document` | ✅ |
+| `Page.resize` | `Puppeteer::Bidi::Page#resize` | ❌ |
+| `Page.screencast` | `Puppeteer::Bidi::Page#screencast` | ❌ |
+| `Page.screenshot` | `Puppeteer::Bidi::Page#screenshot` | ✅ |
+| `Page.select` | `Puppeteer::Bidi::Page#select` | ✅ |
+| `Page.setBypassCSP` | `Puppeteer::Bidi::Page#set_bypass_csp` | ❌ |
+| `Page.setBypassServiceWorker` | `Puppeteer::Bidi::Page#set_bypass_service_worker` | ❌ |
+| `Page.setCacheEnabled` | `Puppeteer::Bidi::Page#set_cache_enabled` | ✅ |
+| `Page.setContent` | `Puppeteer::Bidi::Page#set_content` | ✅ |
+| `Page.setCookie` | `Puppeteer::Bidi::Page#set_cookie` | ✅ |
+| `Page.setDefaultNavigationTimeout` | `Puppeteer::Bidi::Page#set_default_navigation_timeout` | ✅ |
+| `Page.setDefaultTimeout` | `Puppeteer::Bidi::Page#set_default_timeout` | ✅ |
+| `Page.setDragInterception` | `Puppeteer::Bidi::Page#set_drag_interception` | ❌ |
+| `Page.setExtraHTTPHeaders` | `Puppeteer::Bidi::Page#set_extra_http_headers` | ✅ |
+| `Page.setGeolocation` | `Puppeteer::Bidi::Page#set_geolocation` | ✅ |
+| `Page.setJavaScriptEnabled` | `Puppeteer::Bidi::Page#set_java_script_enabled` | ❌ |
+| `Page.setOfflineMode` | `Puppeteer::Bidi::Page#set_offline_mode` | ❌ |
+| `Page.setRequestInterception` | `Puppeteer::Bidi::Page#set_request_interception` | ✅ |
+| `Page.setUserAgent` | `Puppeteer::Bidi::Page#set_user_agent` | ✅ |
+| `Page.setViewport` | `Puppeteer::Bidi::Page#set_viewport` | ✅ |
+| `Page.tap` | `Puppeteer::Bidi::Page#tap` | ❌ |
+| `Page.target` | `Puppeteer::Bidi::Page#target` | ❌ |
+| `Page.title` | `Puppeteer::Bidi::Page#title` | ✅ |
+| `Page.type` | `Puppeteer::Bidi::Page#type` | ✅ |
+| `Page.url` | `Puppeteer::Bidi::Page#url` | ✅ |
+| `Page.viewport` | `Puppeteer::Bidi::Page#viewport` | ✅ |
+| `Page.waitForDevicePrompt` | `Puppeteer::Bidi::Page#wait_for_device_prompt` | ❌ |
+| `Page.waitForFileChooser` | `Puppeteer::Bidi::Page#wait_for_file_chooser` | ✅ |
+| `Page.waitForFrame` | `Puppeteer::Bidi::Page#wait_for_frame` | ❌ |
+| `Page.waitForFunction` | `Puppeteer::Bidi::Page#wait_for_function` | ✅ |
+| `Page.waitForNavigation` | `Puppeteer::Bidi::Page#wait_for_navigation` | ✅ |
+| `Page.waitForNetworkIdle` | `Puppeteer::Bidi::Page#wait_for_network_idle` | ✅ |
+| `Page.waitForRequest` | `Puppeteer::Bidi::Page#wait_for_request` | ✅ |
+| `Page.waitForResponse` | `Puppeteer::Bidi::Page#wait_for_response` | ✅ |
+| `Page.waitForSelector` | `Puppeteer::Bidi::Page#wait_for_selector` | ✅ |
+| `Page.windowId` | `Puppeteer::Bidi::Page#window_id` | ❌ |
+| `Page.workers` | `Puppeteer::Bidi::Page#workers` | ❌ |
+
+## Puppeteer (Puppeteer::Bidi)
+
+| Node.js | Ruby | Supported |
+| --- | --- | :---: |
+| `Puppeteer.clearCustomQueryHandlers` | `Puppeteer::Bidi.clear_custom_query_handlers` | ❌ |
+| `Puppeteer.connect` | `Puppeteer::Bidi.connect` | ✅ |
+| `PuppeteerNode.connect` | `Puppeteer::Bidi.connect` | ✅ |
+| `Puppeteer.customQueryHandlerNames` | `Puppeteer::Bidi.custom_query_handler_names` | ❌ |
+| `PuppeteerNode.defaultArgs` | `Puppeteer::Bidi.default_args` | ❌ |
+| `PuppeteerNode.executablePath` | `Puppeteer::Bidi.executable_path` | ❌ |
+| `PuppeteerNode.launch` | `Puppeteer::Bidi.launch` | ✅ |
+| `Puppeteer.registerCustomQueryHandler` | `Puppeteer::Bidi.register_custom_query_handler` | ❌ |
+| `PuppeteerNode.trimCache` | `Puppeteer::Bidi.trim_cache` | ❌ |
+| `Puppeteer.unregisterCustomQueryHandler` | `Puppeteer::Bidi.unregister_custom_query_handler` | ❌ |
+

data/CLAUDE/expose_function_implementation.md

@@ -0,0 +1,271 @@
+# ExposeFunction and EvaluateOnNewDocument Implementation
+
+This document details the implementation of `Page.evaluateOnNewDocument` and `Page.exposeFunction`, which use BiDi preload scripts and `script.message` channel for communication.
+
+## Page.evaluateOnNewDocument
+
+Injects JavaScript to be evaluated before any page scripts run.
+
+### BiDi Implementation
+
+Uses `script.addPreloadScript` command:
+
+```ruby
+def evaluate_on_new_document(page_function, *args)
+  expression = build_evaluation_expression(page_function, *args)
+  script_id = @browsing_context.add_preload_script(expression).wait
+  NewDocumentScriptEvaluation.new(script_id)
+end
+```
+
+### Key Points
+
+1. **Preload Scripts Persist**: Scripts added via `addPreloadScript` run on every navigation
+2. **Argument Serialization**: Arguments are serialized into the script as JSON literals
+3. **Return Value**: Returns a `NewDocumentScriptEvaluation` with the script ID for later removal
+
+### Example
+
+```ruby
+# Inject code that runs before any page scripts
+script = page.evaluate_on_new_document("window.injected = 123")
+page.goto(server.empty_page)
+result = page.evaluate("window.injected")  # => 123
+
+# Remove when done
+page.remove_script_to_evaluate_on_new_document(script.identifier)
+```
+
+## Page.exposeFunction
+
+Exposes a Ruby callable as a JavaScript function on the page.
+
+### BiDi Implementation
+
+Uses `script.message` channel for bidirectional communication:
+
+```
+Page (JS)                    Ruby (ExposedFunction)
+    |                              |
+    |-- callback([resolve,reject,args]) -->|
+    |                              |
+    |<-- resolve(result) or reject(error) -|
+```
+
+### Key Components
+
+#### 1. Channel Argument Pattern
+
+BiDi uses a special `channel` argument type:
+
+```ruby
+def channel_argument
+  {
+    type: "channel",
+    value: {
+      channel: @channel,  # Unique channel ID
+      ownership: "root"   # Keep handles alive
+    }
+  }
+end
+```
+
+#### 2. Function Declaration
+
+The exposed function creates a Promise that waits for the Ruby callback:
+
+```javascript
+(callback) => {
+  Object.assign(globalThis, {
+    [name]: function (...args) {
+      return new Promise((resolve, reject) => {
+        callback([resolve, reject, args]);
+      });
+    },
+  });
+}
+```
+
+#### 3. Message Handling
+
+Ruby listens for `script.message` events and processes calls:
+
+```ruby
+def handle_message(params)
+  return unless params["channel"] == @channel
+
+  # Extract data handle with [resolve, reject, args]
+  data_handle = JSHandle.from(params["data"], realm.core_realm)
+
+  # Call Ruby function and send result back
+  result = @apply.call(*args)
+  send_result(data_handle, result)
+end
+```
+
+### Session Event Subscription
+
+**Important**: `script.message` must be subscribed in the session:
+
+```ruby
+# In Core::Session
+def subscribe_to_events
+  subscribe([
+    "browsingContext.load",
+    "browsingContext.domContentLoaded",
+    # ... other events
+    "script.message",  # Required for exposeFunction
+  ]).wait
+end
+```
+
+### Frame Handling
+
+ExposedFunction handles dynamic frames by:
+
+1. **Listening to frameattached**: Injects into new frames
+2. **Using preload scripts**: For top-level browsing contexts (not iframes)
+3. **Using callFunction**: For immediate injection into current context
+
+```ruby
+def inject_into_frame(frame)
+  # Add preload script for top-level contexts only
+  if frame.browsing_context.parent.nil?
+    script_id = frame.browsing_context.add_preload_script(
+      function_declaration,
+      arguments: [channel]
+    ).wait
+  end
+
+  # Always call function for immediate availability
+  realm.core_realm.call_function(
+    function_declaration,
+    false,
+    arguments: [channel]
+  ).wait
+end
+```
+
+### Error Handling
+
+#### Standard Errors
+
+Errors are serialized with name, message, and stack trace:
+
+```ruby
+def send_error(data_handle, error)
+  name = error.class.name
+  message = error.message
+  stack = error.backtrace&.join("\n")
+
+  data_handle.evaluate(<<~JS, name, message, stack)
+    ([, reject], name, message, stack) => {
+      const error = new Error(message);
+      error.name = name;
+      if (stack) { error.stack = stack; }
+      reject(error);
+    }
+  JS
+end
+```
+
+#### Non-Error Values (ThrownValue)
+
+Ruby doesn't support `throw "string"` syntax. Use `ThrownValue`:
+
+```ruby
+class ThrownValue < StandardError
+  attr_reader :value
+
+  def initialize(value)
+    @value = value
+    super("Thrown value")
+  end
+end
+
+# Usage
+page.expose_function("throwValue") do |value|
+  raise ExposedFunction::ThrownValue.new(value)
+end
+```
+
+### Cleanup
+
+Disposal removes the function from all frames and cleans up resources:
+
+```ruby
+def dispose
+  session.off("script.message", &@listener)
+  page.off(:frameattached, &@frame_listener)
+
+  # Remove from globalThis
+  remove_binding_from_frame(@frame)
+
+  # Remove preload scripts
+  @scripts.each do |frame, script_id|
+    frame.browsing_context.remove_preload_script(script_id).wait
+  end
+end
+```
+
+## Testing Considerations
+
+### CSP Headers
+
+Some tests require Content-Security-Policy headers. Use `TestServer#set_csp`:
+
+```ruby
+server.set_csp("/empty.html", "script-src 'self'")
+```
+
+### Test Asset
+
+`spec/assets/tamperable.html` captures `window.injected` before page scripts run:
+
+```html
+<script>
+  window.result = window.injected;
+</script>
+```
+
+## Common Pitfalls
+
+### 1. Missing script.message Subscription
+
+**Problem**: `exposeFunction` doesn't receive callbacks
+
+**Solution**: Ensure `script.message` is in session event subscriptions
+
+### 2. Ownership: "root" Required
+
+**Problem**: JSHandle becomes invalid before processing
+
+**Solution**: Use `ownership: "root"` in channel argument to keep handles alive
+
+### 3. Preload Scripts for Iframes
+
+**Problem**: `addPreloadScript` not supported for iframe contexts
+
+**Solution**: Only use preload scripts for top-level contexts; use `callFunction` for iframes
+
+### 4. TypeError on raise nil
+
+**Problem**: Ruby's `raise nil` throws `TypeError: exception class/object expected`
+
+**Solution**: Catch and convert to `send_thrown_value`:
+
+```ruby
+rescue TypeError => e
+  if e.message.include?("exception class/object expected")
+    send_thrown_value(data_handle, nil)
+  else
+    send_error(data_handle, e)
+  end
+end
+```
+
+## References
+
+- [WebDriver BiDi script.message](https://w3c.github.io/webdriver-bidi/#event-script-message)
+- [WebDriver BiDi addPreloadScript](https://w3c.github.io/webdriver-bidi/#command-script-addPreloadScript)
+- [Puppeteer ExposedFunction.ts](https://github.com/puppeteer/puppeteer/blob/main/packages/puppeteer-core/src/bidi/ExposedFunction.ts)

data/CLAUDE/porting_puppeteer.md

@@ -212,3 +212,23 @@ curl -sL https://raw.githubusercontent.com/puppeteer/puppeteer/main/test/assets/
 ```
 
 **Why this matters**: Test assets are designed to test specific edge cases (rotated elements, complex layouts, etc.). Using simplified versions defeats the purpose of these tests.
+
+## 9. API Coverage Update
+
+**IMPORTANT**: When implementing new Puppeteer API methods, update `API_COVERAGE.md`:
+
+1. Find the corresponding entry in the table (e.g., `Browser.userAgent`, `Page.setUserAgent`)
+2. Change the status from `❌` to `✅`
+3. Update the coverage count at the top of the file
+
+```markdown
+# Before
+- Coverage: `156/274` (`56.93%`)
+| `Browser.userAgent` | `Puppeteer::Bidi::Browser#user_agent` | ❌ |
+
+# After (implemented 2 new methods: 156 + 2 = 158)
+- Coverage: `158/274` (`57.66%`)
+| `Browser.userAgent` | `Puppeteer::Bidi::Browser#user_agent` | ✅ |
+```
+
+**CI will fail** if API_COVERAGE.md is not updated when new methods are implemented. The API Coverage check compares implemented methods against the coverage file.