@mefistofelix/cdp.js 0.5.0 → 0.5.1

package/README.md

@@ -542,8 +542,8 @@ await client.call({
 Provide `user_data_dir` or raw `args['user-data-dir']` to choose a custom
 directory. An effective custom directory makes `cdp_ext_install` default to true:
 the manager copies the two extension files into
-`<user-data-dir>/<profile-directory>/cdp_ext/` (`Default` when unset), sets the
-shared server URL in that manifest and adds startup loading flags. Normal launch
+`<user-data-dir>/<profile-directory>/cdp_ext/` (`Default` when unset) and adds
+startup loading flags. The server address comes only from the trigger URL. Normal launch
 options and profile preferences then apply. Set `cdp_ext_install: false` to use
 an extension already installed in that profile, or true to force preparation and
 loading. A null/false raw directory override makes automatic installation default off.
@@ -568,6 +568,13 @@ and enable the bridge. An `extensions` array adds its directories;
 `extensions: true` retains enabled profile extensions through `'*'`. Raw `args`
 still win and can prevent loading or connection.
 
+Both launch paths keep `--no-first-run` and
+`--disable-search-engine-choice-screen`, including when opening a new custom
+profile with installation disabled. This suppresses onboarding and the search
+engine selection prompt without changing the chosen search provider or writing
+search preferences. Raw `args` can override either flag. An existing Chrome only
+receives the URL; new startup flags require restarting that instance.
+
 The manager opens an actual local HTTP URL on the shared listener, for example
 `http://127.0.0.1:9223/cdp_ext?browser=work&websocket_url=...&token=...`.
 The port is the effective listening port, including an automatically allocated
@@ -590,15 +597,22 @@ manager while connected returns an explicit error, preserving the existing
 connection. After disconnection, a new bootstrap can rebind it.
 
 Passive external attachment remains available through `reverse: true`: it opens
-no URL and waits for `extension_id` (or the browser label). Without bootstrap,
-the extension announces its native ID and uses its manifest endpoint. This
-compatibility mode is optional; `cdp_ext: true` needs neither `reverse` nor an ID.
+no URL and waits for `extension_id` (or the browser label). This compatibility
+mode is optional; `cdp_ext: true` needs neither `reverse` nor an ID.
+The current extension still requires a trigger URL in passive mode; it never
+connects automatically to a manifest endpoint or a default port.
+
+The extension stays idle until a valid trigger URL supplies the logical name,
+WebSocket endpoint and token. Before that it makes no server requests and logs
+no connection messages. A worker restart may resume the same browser session's
+previous trigger from `chrome.storage.session`.
 
-The manifest's `cdp` configuration supplies initial connection defaults:
+The shipped manifest needs no custom configuration keys. An optional custom
+`cdp.reconnect_ms` override remains supported (Chrome displays a harmless
+unrecognized-key warning if it is added):
 
 | Manifest `cdp` key | Default | Meaning |
 | --- | --- | --- |
-| `websocket_url` | `ws://127.0.0.1:9223` | Initial shared endpoint; URL bootstrap overrides it. |
 | `reconnect_ms` | `5000` | Awake retry and connected heartbeat interval; use a positive value below 30000. |
 
 Construction and direct CDP calls do not start a listener. The first browser call
@@ -662,10 +676,20 @@ another connection attempt; the configured interval applies while it is awake.
 Connected empty-text heartbeats keep an otherwise idle WebSocket worker active.
 These are transport messages, not event buffering or polling of browser state.
 
+After a trigger, the server may be offline normally. Before each disconnected
+WebSocket attempt the extension checks the same server's HTTP `/cdp_ext` endpoint
+with a two-second timeout and no cache. It opens the socket only when that
+endpoint identifies CDP.js. Concurrent retries share the check; an unavailable or
+incompatible server causes one informational waiting message, not a failing
+WebSocket attempt on every timer tick. Successful connections and later
+disconnects log their status once per transition. Chrome can still emit a native
+network diagnostic if the server disappears between the HTTP check and upgrade.
+
 ### Reverse protocol and supported commands
 
-The first announcement contains `{ browser, extension_id, token }` for bootstrap,
-or the native extension ID for passive attachment. Subsequent messages use CDP envelopes:
+The current extension's first announcement contains `{ browser, extension_id, token }`
+after a trigger. The server also accepts legacy native-ID announcements.
+Subsequent messages use CDP envelopes:
 
 - Request: `{ id, method, params, sessionId? }`.
 - Response: `{ id, result }` or `{ id, error: { code, message } }`.
@@ -1805,5 +1829,11 @@ already running instance, startup when absent, one shared extension directory,
 logical names, binding tokens, conflicting names and preservation on manager close.
 Installation defaults, raw directory overrides, profile writes independent of
 installation and shared wildcard expansion are covered without opening personal profiles.
+Argument coverage crosses direct/extension launch modes with headless, proxy,
+image/login/translation options, extension selectors and raw overrides. Profile
+combinations include default/custom directories, null/false raw directory
+overrides, forced installation and independent preference-write controls.
+Offline worker checks verify silence before a trigger, deduplicated waiting logs,
+no WebSocket attempts against absent/incompatible servers and concurrent retry checks.
 The npm tarball contains `package.json`, `cdp.js`, `README.md` and the two extension
 files required by managed reverse launches.

package/cdp.js

@@ -153,12 +153,10 @@ export class browser {
       'disable-prompt-on-repost': true,
       'force-color-profile': 'srgb',
       'metrics-recording-only': true,
-      'no-first-run': true,
       'password-store': 'basic',
       'use-mock-keychain': true,
       'no-service-autorun': true,
       'export-tagged-pdf': true,
-      'disable-search-engine-choice-screen': true,
       'disable-features': [
         'InfiniteSessionRestore',
         'ImprovedCookieControls',
@@ -177,6 +175,8 @@ export class browser {
       'user-data-dir': options.user_data_dir,
       'remote-debugging-port': 0,
     }
+    args['no-first-run'] = true
+    args['disable-search-engine-choice-screen'] = true
     if (options.headless) {
       args.headless = 'new'
       args['window-size'] = '1440,900'
@@ -658,9 +658,7 @@ export class cdp extends EventTarget {
           await fs.mkdir(record.extension_path, { recursive: true })
           record.extension_path = await fs.realpath(record.extension_path)
           record.extension_id = browser.extension_id(record.extension_path)
-          const manifest = JSON.parse(await fs.readFile(new URL('./cdp_ext/manifest.json', import.meta.url), 'utf8'))
-          manifest.cdp.websocket_url = record.reverse_url
-          await fs.writeFile(path.join(record.extension_path, 'manifest.json'), JSON.stringify(manifest))
+          await fs.copyFile(new URL('./cdp_ext/manifest.json', import.meta.url), path.join(record.extension_path, 'manifest.json'))
           await fs.copyFile(new URL('./cdp_ext/cdp_ext.js', import.meta.url), path.join(record.extension_path, 'cdp_ext.js'))
         }
         if (args['user-data-dir'] && record.update_preferences !== false) {

package/cdp_ext/cdp_ext.js

@@ -1,4 +1,6 @@
-const config = chrome.runtime.getManifest().cdp ?? {}
+const config = {
+  reconnect_ms: chrome.runtime.getManifest().cdp?.reconnect_ms ?? 5000,
+}
 const configured = chrome.storage.session.get('cdp_bootstrap').then(value => Object.assign(config, value.cdp_bootstrap))
 const sessions = {}
 const attached = {}
@@ -8,6 +10,14 @@ let disconnecting
 let discovering = false
 let auto_attach = {}
 let bootstrapping
+let checking = false
+let connection_message
+
+function report_connection(message) {
+  if (connection_message === message) return
+  connection_message = message
+  console.info('[cdp_ext] ' + message)
+}
 
 async function bootstrap(tab) {
   const text = tab.pendingUrl ?? tab.url ?? ''
@@ -245,15 +255,43 @@ for (const [name, options] of Object.entries({
 
 async function connect() {
   await configured
-  if (disconnecting) return
+  if (!config.browser || !config.websocket_url || !config.token) return
+  if (disconnecting || checking) return
   if (socket?.readyState === WebSocket.CONNECTING) return
   if (socket?.readyState === WebSocket.OPEN) return socket.send('')
-  const connection = socket = new WebSocket(config.websocket_url ?? 'ws://127.0.0.1:9223')
-  connection.onopen = () => connection.send(JSON.stringify({
-    browser: config.browser ?? chrome.runtime.id,
-    extension_id: chrome.runtime.id,
-    token: config.token,
-  }))
+  const endpoint = config.websocket_url
+  const url = new URL(endpoint)
+  url.protocol = url.protocol === 'wss:' ? 'https:' : 'http:'
+  url.pathname = '/cdp_ext'
+  url.search = ''
+  url.hash = ''
+  let available = false
+  checking = true
+  try {
+    const response = await fetch(url, {
+      cache: 'no-store',
+      signal: AbortSignal.timeout(2000),
+    })
+    available = response.ok && await response.text() === 'CDP.js browser connection'
+  } catch (error) {
+    if (!(error instanceof TypeError) && error.name !== 'TimeoutError') throw error
+  } finally {
+    checking = false
+  }
+  if (endpoint !== config.websocket_url) return connect()
+  if (!available) {
+    report_connection('Waiting for CDP.js server at ' + endpoint + '; retrying automatically.')
+    return
+  }
+  const connection = socket = new WebSocket(endpoint)
+  connection.onopen = () => {
+    report_connection('Connected to CDP.js server at ' + endpoint + '.')
+    connection.send(JSON.stringify({
+      browser: config.browser,
+      extension_id: chrome.runtime.id,
+      token: config.token,
+    }))
+  }
   connection.onmessage = async event => {
     if (!event.data) return
     const request = JSON.parse(event.data)
@@ -300,6 +338,7 @@ async function connect() {
     if (id != null && connection.readyState === WebSocket.OPEN) connection.send(JSON.stringify(response))
   }
   connection.onclose = () => {
+    report_connection('Waiting for CDP.js server at ' + endpoint + '; retrying automatically.')
     discovering = false
     disconnecting = Promise.all(Object.keys(attached).map(id => {
       const source = { tabId: Number(id) }
@@ -323,5 +362,5 @@ async function start() {
 chrome.runtime.onStartup.addListener(start)
 chrome.alarms.onAlarm.addListener(connect)
 chrome.alarms.create('cdp-reconnect', { periodInMinutes: 0.5 })
-setInterval(connect, config.reconnect_ms ?? 5000)
+setInterval(connect, config.reconnect_ms)
 start()

package/cdp_ext/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "CDP reverse connection",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "minimum_chrome_version": "125",
   "permissions": [
     "accessibilityFeatures.read",
@@ -68,9 +68,5 @@
   "incognito": "spanning",
   "background": {
     "service_worker": "cdp_ext.js"
-  },
-  "cdp": {
-    "websocket_url": "ws://127.0.0.1:9223",
-    "reconnect_ms": 5000
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mefistofelix/cdp.js",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Low-level Chromium DevTools Protocol client for Node.js, Deno and Bun, with no runtime dependencies.",
   "type": "module",
   "exports": "./cdp.js",