chrome-cdp-cli 1.8.0 → 1.9.0

package/README.md

@@ -119,7 +119,7 @@ npm link
 Before using the CLI, start Chrome with remote debugging enabled:
 
 ```bash
-# Default port (9222) - IMPORTANT: Include --user-data-dir to avoid conflicts
+# Default port (9222) - IMPORTANT: --user-data-dir is required for security
 chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug-profile
 
 # Custom port
@@ -136,9 +136,9 @@ chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug-profile --
 ```
 
 **Important Notes:**
-- **Always use `--user-data-dir`**: This creates a separate Chrome profile for debugging and prevents conflicts with your regular Chrome instance
+- **Always use `--user-data-dir`**: This is **required for security**. Chrome will not enable the debugging port without a specified user data directory to prevent unauthorized access to your default profile
 - **Choose a dedicated directory**: Use a path like `/tmp/chrome-debug-profile` or `/Users/$USER/chrome-profile-debug`
-- **Avoid profile conflicts**: Without `--user-data-dir`, Chrome may fail to open the debugging port if another instance is running
+- **Security requirement**: Without `--user-data-dir`, Chrome will refuse to enable remote debugging to protect your default browser profile
 
 For more details, see the [Chrome Remote Debugging documentation](https://developer.chrome.com/blog/remote-debugging-port).
 
@@ -910,7 +910,7 @@ Create a `.chrome-cdp-cli.json` file in your project root or home directory:
 
 ```bash
 # Clone repository
-git clone https://github.com/nickxiao42/chrome-devtools-cli.git
+git clone https://github.com/nicoster/chrome-devtools-cli.git
 cd chrome-devtools-cli
 
 # Install dependencies
@@ -1030,14 +1030,14 @@ console.log(result);
 
 1. **Connection Refused**
    - Ensure Chrome is running with `--remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug`
-   - **Always include `--user-data-dir`** to avoid profile conflicts
+   - **Always include `--user-data-dir`** - it's required for security (Chrome won't enable debugging port without it)
    - Check if the port is correct and not blocked by firewall
    - Verify no other Chrome instances are using the same debugging port
 
 2. **Chrome Won't Start Debugging Port**
    - **Most common cause**: Missing `--user-data-dir` parameter
    - **Solution**: Use a dedicated profile directory: `--user-data-dir=/tmp/chrome-debug-profile`
-   - **Why needed**: Prevents conflicts with existing Chrome instances
+   - **Why needed**: Chrome requires `--user-data-dir` for security - it will not enable the debugging port without it to protect your default browser profile
    - See [Chrome Remote Debugging documentation](https://developer.chrome.com/blog/remote-debugging-port) for details
 
 3. **Command Timeout**

package/dist/handlers/EvaluateScriptHandler.js

@@ -159,7 +159,7 @@ class EvaluateScriptHandler {
                 }
                 let value = commandResult.result?.value;
                 if (commandResult.result?.type === 'undefined') {
-                    value = undefined;
+                    value = '';
                 }
                 else if (commandResult.result?.unserializableValue) {
                     value = commandResult.result.unserializableValue;
@@ -227,6 +227,10 @@ class EvaluateScriptHandler {
         }
     }
     async executeScript(client, expression, awaitPromise, returnByValue) {
+        const consoleHandler = (params) => {
+            this.handleConsoleOutput(params);
+        };
+        client.on('Runtime.consoleAPICalled', consoleHandler);
         try {
             const response = (await client.send('Runtime.evaluate', {
                 expression,
@@ -261,6 +265,52 @@ class EvaluateScriptHandler {
                 error: `CDP command failed: ${error instanceof Error ? error.message : String(error)}`
             };
         }
+        finally {
+            client.off('Runtime.consoleAPICalled', consoleHandler);
+        }
+    }
+    handleConsoleOutput(params) {
+        try {
+            const consoleParams = params;
+            const messageText = this.formatConsoleArgs(consoleParams.args || []);
+            const messageType = this.mapConsoleType(consoleParams.type);
+            if (messageType === 'log' || messageType === 'info' || messageType === 'debug') {
+                process.stdout.write(messageText + '\n');
+            }
+            else {
+                process.stderr.write(messageText + '\n');
+            }
+        }
+        catch (error) {
+            this.logger.debug('Error handling console output:', error);
+        }
+    }
+    formatConsoleArgs(args) {
+        return args.map(arg => {
+            if (arg.value !== undefined) {
+                if (typeof arg.value === 'string') {
+                    return arg.value;
+                }
+                return JSON.stringify(arg.value);
+            }
+            return arg.description || '';
+        }).join(' ');
+    }
+    mapConsoleType(cdpType) {
+        switch (cdpType) {
+            case 'log':
+                return 'log';
+            case 'info':
+                return 'info';
+            case 'warning':
+                return 'warn';
+            case 'error':
+                return 'error';
+            case 'debug':
+                return 'debug';
+            default:
+                return 'log';
+        }
     }
     formatException(exceptionDetails) {
         if (!exceptionDetails) {
@@ -285,7 +335,10 @@ class EvaluateScriptHandler {
     }
     formatResult(result) {
         if (!result) {
-            return 'undefined';
+            return '';
+        }
+        if (result.type === 'undefined') {
+            return '';
         }
         if (result.value !== undefined) {
             return result.value;

package/dist/utils/logger.js

@@ -52,7 +52,7 @@ class Logger {
             maxFileSize: 10 * 1024 * 1024,
             maxFiles: 5,
             enableConsole: true,
-            enableStructured: true,
+            enableStructured: false,
             ...config
         };
         if (this.config.file) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-cdp-cli",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Browser automation CLI via Chrome DevTools Protocol. Designed for developers and AI assistants - combines dedicated commands for common tasks with flexible JavaScript execution for complex scenarios. Features: element interaction, screenshots, DOM snapshots, console/network monitoring. Built-in IDE integration for Cursor and Claude.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",