support for fetching the protocol remotely via stdio pipes

Author: kevzoid

lib/chrome.js

@@ -118,16 +118,26 @@ class Chrome extends EventEmitter {
 
     // initiate the connection process
     async _start() {
-        const options = {
-            host: this.host,
-            port: this.port,
-            secure: this.secure,
-            useHostName: this.useHostName,
-            alterPath: this.alterPath,
-            ...this.connectOptions,
-        };
         try {
-            if (!this.process) {
+            if (this.process)
+            {
+                const options = {local: this.local, cdp: this};
+                // we first "connect" to stdio pipes, so that we can
+                // first the protocol remotely via the pipe.
+                await this._connect();
+                const protocol = await this._fetchProtocol(options);
+                api.prepare(this, protocol);
+            }
+            else
+            {
+                const options = {
+                    host: this.host,
+                    port: this.port,
+                    secure: this.secure,
+                    useHostName: this.useHostName,
+                    alterPath: this.alterPath,
+                    ...this.connectOptions,
+                };
                 // fetch the WebSocket debugger URL
                 const url = await this._fetchDebuggerURL(options);
                 // allow the user to alter the URL
@@ -137,12 +147,12 @@ class Chrome extends EventEmitter {
                 // update the connection parameters using the debugging URL
                 options.host = urlObject.hostname;
                 options.port = urlObject.port || options.port;
+                // fetch the protocol and prepare the API
+                const protocol = await this._fetchProtocol(options);
+                api.prepare(this, protocol);
+                // finally connect to the WebSocket
+                await this._connect();
             }
-            // fetch the protocol and prepare the API
-            const protocol = await this._fetchProtocol(options);
-            api.prepare(this, protocol);
-            // finally connect to the WebSocket or stdio
-            await this._connect();
             // since the handler is executed synchronously, the emit() must be
             // performed in the next tick so that uncaught errors in the client code
             // are not intercepted by the Promise mechanism and therefore reported

lib/devtools.js

@@ -48,6 +48,15 @@ function promisesWrapper(func) {
 }
 
 function Protocol(options, callback) {
+    // fetch remotely via CDP when using stdio pipes (Bright Data exclusive)
+    if (options.cdp)
+    {
+        return options.cdp.send('Browser.getProtocolJson', (err, data)=>{
+            if (err)
+                return callback(err);
+            callback(null, JSON.parse(data.result));
+        });
+    }
     // if the local protocol is requested
     if (options.local) {
         const localDescriptor = require('./protocol.json');