chrome-cdp-cli 2.1.2 → 2.1.4

package/dist/cli/CLIApplication.js

@@ -141,6 +141,9 @@ class CLIApplication {
         const title = target.title.toLowerCase();
         return (url.startsWith("chrome-devtools://") ||
             url.startsWith("devtools://") ||
+            url.startsWith("chrome://") ||
+            url.startsWith("chrome-extension://") ||
+            url.startsWith("chrome-untrusted://") ||
             title.includes("devtools") ||
             title.includes("chrome devtools"));
     }
@@ -161,23 +164,18 @@ class CLIApplication {
             const CYAN = "\x1b[36m";
             const DIM = "\x1b[2m";
             const CLEAR_LINE = "\x1b[2K\x1b[G";
-            const SAVE = "\x1b[s";
-            const RESTORE = "\x1b[u";
+            const TOTAL_LINES = targets.length * 2 + 5;
             const truncate = (s, max) => s.length > max ? s.substring(0, max - 1) + "…" : s;
             const render = (first) => {
-                if (first) {
-                    process.stderr.write(SAVE);
-                }
-                else {
-                    process.stderr.write(RESTORE);
+                if (!first) {
+                    process.stderr.write(`\x1b[${TOTAL_LINES}A`);
                 }
                 process.stderr.write(`${CLEAR_LINE}${BOLD}Select a Chrome page${RESET}  (↑↓ navigate, Enter select, q quit)\n`);
                 process.stderr.write(`${CLEAR_LINE}${"─".repeat(54)}\n`);
                 targets.forEach((t, i) => {
                     const num = `[${i + 1}]`;
-                    const rawTitle = t.title || "(Untitled)";
-                    const title = truncate(rawTitle, 52);
-                    const url = truncate(t.url, 60);
+                    const title = truncate(t.title || "(Untitled)", 50);
+                    const url = truncate(t.url, 58);
                     const selected = i === cursor;
                     if (selected) {
                         process.stderr.write(`${CLEAR_LINE}${CYAN}${BOLD} ❯ ${num} ${title}${RESET}\n`);
@@ -189,8 +187,8 @@ class CLIApplication {
                     }
                 });
                 process.stderr.write(`${CLEAR_LINE}${"─".repeat(54)}\n`);
-                process.stderr.write(`${CLEAR_LINE}${DIM}Tip: skip this prompt with  cdp -i <number> <command>${RESET}\n` +
-                    `${CLEAR_LINE}${DIM}     or close other tabs until only one remains.${RESET}\n`);
+                process.stderr.write(`${CLEAR_LINE}${DIM}Tip: skip this prompt with  cdp -i <number> <command>${RESET}\n`);
+                process.stderr.write(`${CLEAR_LINE}${DIM}     or close other tabs until only one remains.${RESET}\n`);
             };
             render(true);
             process.stdin.setRawMode(true);

package/dist/cli/CommandSchemaRegistry.js

@@ -568,7 +568,7 @@ class CommandSchemaRegistry {
             name: "log",
             aliases: ["console"],
             description: "Follow console messages in real-time",
-            usage: "cdp log [options]",
+            usage: "cdp log [PATTERN] [options]",
             examples: [
                 { command: "cdp log", description: "Follow all console messages" },
                 {
@@ -576,8 +576,20 @@ class CommandSchemaRegistry {
                     description: "Follow only errors and warnings",
                 },
                 {
-                    command: 'cdp log --textPattern "API"',
-                    description: "Follow messages matching /API/i",
+                    command: "cdp log '\\[AI'",
+                    description: "Follow messages matching regex /\\[AI/i",
+                },
+                {
+                    command: "cdp log -e error -e warn",
+                    description: "Follow messages matching 'error' OR 'warn'",
+                },
+                {
+                    command: "cdp log -F '[AI'",
+                    description: "Follow messages containing literal string '[AI'",
+                },
+                {
+                    command: "cdp log -v 'debug'",
+                    description: "Follow messages NOT matching 'debug'",
                 },
                 {
                     command: "cdp log --format json",
@@ -592,9 +604,28 @@ class CommandSchemaRegistry {
                     type: "string",
                 },
                 {
-                    name: "textPattern",
-                    description: "Filter by text pattern (regex, case-insensitive)",
+                    name: "expression",
+                    short: "e",
+                    description: "Pattern to match (regex by default). May be specified multiple times (OR logic).",
                     type: "string",
+                    multiple: true,
+                },
+                {
+                    name: "fixed-strings",
+                    short: "F",
+                    description: "Treat pattern(s) as literal strings, not regexps",
+                    type: "boolean",
+                },
+                {
+                    name: "invert-match",
+                    short: "v",
+                    description: "Output messages that do NOT match the pattern",
+                    type: "boolean",
+                },
+                {
+                    name: "case-sensitive",
+                    description: "Match is case-sensitive (default: case-insensitive)",
+                    type: "boolean",
                 },
                 {
                     name: "follow",
@@ -609,7 +640,14 @@ class CommandSchemaRegistry {
                     choices: ["text", "json", "pretty"],
                 },
             ],
-            arguments: [],
+            arguments: [
+                {
+                    name: "pattern",
+                    description: "Pattern to match (regex by default, case-insensitive)",
+                    type: "string",
+                    required: false,
+                },
+            ],
         });
         this.registerCommand({
             name: "network",

package/dist/handlers/ListConsoleMessagesHandler.js

@@ -20,21 +20,44 @@ class ListConsoleMessagesHandler {
             };
         }
     }
+    buildMatcher(params) {
+        const rawExpressions = params.expression
+            ? Array.isArray(params.expression)
+                ? params.expression
+                : [params.expression]
+            : [];
+        const patterns = [
+            ...(params.pattern ? [params.pattern] : []),
+            ...rawExpressions,
+        ];
+        if (patterns.length === 0)
+            return () => true;
+        const fixedStrings = params.fixedStrings ?? params["fixed-strings"] ?? false;
+        const caseSensitive = params.caseSensitive ?? params["case-sensitive"] ?? false;
+        const invertMatch = params.invertMatch ?? params["invert-match"] ?? false;
+        const flags = caseSensitive ? "" : "i";
+        const tests = patterns.map((p) => {
+            if (fixedStrings) {
+                return caseSensitive
+                    ? (text) => text.includes(p)
+                    : (text) => text.toLowerCase().includes(p.toLowerCase());
+            }
+            const re = new RegExp(p, flags);
+            return (text) => re.test(text);
+        });
+        const anyMatch = (text) => tests.some((t) => t(text));
+        return invertMatch ? (text) => !anyMatch(text) : anyMatch;
+    }
     async executeFollowMode(client, params) {
         if (!this.consoleMonitor) {
             this.consoleMonitor = new ConsoleMonitor_1.ConsoleMonitor(client);
         }
         await this.consoleMonitor.startMonitoring();
-        const filter = {};
-        if (params.types && params.types.length > 0) {
-            filter.types = params.types;
-        }
-        if (params.textPattern) {
-            filter.textPattern = params.textPattern;
-        }
+        const typeFilter = params.types && params.types.length > 0 ? params.types : null;
+        const matchText = this.buildMatcher(params);
         const outputFormat = params.format || "text";
         const messageCallback = (message) => {
-            if (!this.shouldOutputMessage(message, filter)) {
+            if (!this.shouldOutputMessage(message, typeFilter, matchText)) {
                 return;
             }
             this.outputMessage(message, outputFormat);
@@ -69,19 +92,11 @@ class ListConsoleMessagesHandler {
             isLongRunning: true,
         };
     }
-    shouldOutputMessage(message, filter) {
-        if (filter.types && filter.types.length > 0) {
-            if (!filter.types.includes(message.type)) {
-                return false;
-            }
-        }
-        if (filter.textPattern) {
-            const pattern = new RegExp(filter.textPattern, "i");
-            if (!pattern.test(message.text)) {
-                return false;
-            }
+    shouldOutputMessage(message, typeFilter, matchText) {
+        if (typeFilter && !typeFilter.includes(message.type)) {
+            return false;
         }
-        return true;
+        return matchText(message.text);
     }
     outputMessage(message, format) {
         switch (format) {
@@ -142,10 +157,16 @@ class ListConsoleMessagesHandler {
                     return false;
             }
         }
-        if (params.textPattern !== undefined &&
-            typeof params.textPattern !== "string") {
+        if (params.pattern !== undefined && typeof params.pattern !== "string") {
             return false;
         }
+        if (params.expression !== undefined) {
+            const exprs = Array.isArray(params.expression)
+                ? params.expression
+                : [params.expression];
+            if (!exprs.every((e) => typeof e === "string"))
+                return false;
+        }
         if (params.format !== undefined) {
             const validFormats = ["text", "json", "pretty"];
             if (typeof params.format !== "string" ||
@@ -159,21 +180,30 @@ class ListConsoleMessagesHandler {
         return `log - Follow console messages in real-time
 
 Usage:
-  cdp log [options]
+  cdp log [PATTERN] [options]
+
+Arguments:
+  PATTERN                 Pattern to match (regex, case-insensitive by default)
 
 Options:
-  --types <types>         Filter by message types (comma-separated: log,info,warn,error,debug)
-  --textPattern <pattern> Filter by text pattern (regex, case-insensitive)
-  --format <format>       Output format: text, json, or pretty (default: text)
+  -e, --expression <pat>  Pattern to match; may be used multiple times (OR logic)
+  -F, --fixed-strings     Treat pattern(s) as literal strings, not regexps
+  -v, --invert-match      Output messages that do NOT match the pattern
+      --case-sensitive    Case-sensitive matching (default: case-insensitive)
+      --types <types>     Filter by message types (log,info,warn,error,debug)
+      --format <format>   Output format: text, json, or pretty (default: text)
   -f, --follow            Alias flag (follow mode is always active)
 
 Examples:
-  cdp log                                    # Follow all console messages
-  cdp log --types error,warn                 # Follow only errors and warnings
-  cdp log --textPattern "API"                # Follow messages matching /API/i
-  cdp log --format json                      # Output as JSON (one object per line)
-  cdp log --format pretty                    # Colorized output
-  cdp log --types error --textPattern "404"  # Combined filters
+  cdp log                          # Follow all console messages
+  cdp log '\\[AI'                  # Messages matching regex /\\[AI/i
+  cdp log -e error -e warn         # Messages containing 'error' OR 'warn'
+  cdp log -F '[AI'                 # Messages containing literal '[AI'
+  cdp log -v debug                 # Messages NOT containing 'debug'
+  cdp log '404' --case-sensitive   # Case-sensitive match
+  cdp log --types error,warn       # Filter by type
+  cdp log --format json            # Output as JSON (one object per line)
+  cdp log --format pretty          # Colorized output
 
 Note:
   This command runs continuously and streams console messages in real-time.

package/dist/utils/logger.js

@@ -53,7 +53,7 @@ class Logger {
             maxFiles: 5,
             enableConsole: true,
             enableStructured: false,
-            ...config
+            ...config,
         };
         if (this.config.file) {
             this.initializeLogFile();
@@ -74,13 +74,15 @@ class Logger {
                     this.rotateLogFile();
                 }
             }
-            this.logFileHandle = fs.createWriteStream(this.config.file, { flags: 'a' });
-            this.logFileHandle.on('error', (error) => {
-                console.error('Log file write error:', error);
+            this.logFileHandle = fs.createWriteStream(this.config.file, {
+                flags: "a",
+            });
+            this.logFileHandle.on("error", (error) => {
+                console.error("Log file write error:", error);
             });
         }
         catch (error) {
-            console.error('Failed to initialize log file:', error);
+            console.error("Failed to initialize log file:", error);
         }
     }
     rotateLogFile() {
@@ -104,25 +106,29 @@ class Logger {
                 fs.renameSync(this.config.file, `${this.config.file}.1`);
             }
             this.currentFileSize = 0;
-            this.logFileHandle = fs.createWriteStream(this.config.file, { flags: 'a' });
-            this.logFileHandle.on('error', (error) => {
-                console.error('Log file write error:', error);
+            this.logFileHandle = fs.createWriteStream(this.config.file, {
+                flags: "a",
+            });
+            this.logFileHandle.on("error", (error) => {
+                console.error("Log file write error:", error);
             });
         }
         catch (error) {
-            console.error('Failed to rotate log file:', error);
+            console.error("Failed to rotate log file:", error);
         }
     }
     formatLogEntry(entry) {
         if (this.config.enableStructured) {
-            return JSON.stringify(entry) + '\n';
+            return JSON.stringify(entry) + "\n";
         }
         else {
             const timestamp = entry.timestamp;
             const level = entry.level.padEnd(5);
-            const component = entry.component ? `[${entry.component}]` : '';
-            const connectionId = entry.connectionId ? `{conn:${entry.connectionId}}` : '';
-            const clientId = entry.clientId ? `{client:${entry.clientId}}` : '';
+            const component = entry.component ? `[${entry.component}]` : "";
+            const connectionId = entry.connectionId
+                ? `{conn:${entry.connectionId}}`
+                : "";
+            const clientId = entry.clientId ? `{client:${entry.clientId}}` : "";
             let message = `${timestamp} ${level} ${component}${connectionId}${clientId} ${entry.message}`;
             if (entry.data) {
                 message += ` | Data: ${JSON.stringify(entry.data)}`;
@@ -136,7 +142,7 @@ class Logger {
             if (entry.metrics) {
                 message += ` | Metrics: ${JSON.stringify(entry.metrics)}`;
             }
-            return message + '\n';
+            return message + "\n";
         }
     }
     writeLog(entry) {
@@ -145,24 +151,12 @@ class Logger {
             const consoleMessage = this.config.enableStructured
                 ? formattedEntry.trim()
                 : formattedEntry.trim();
-            switch (entry.level) {
-                case 'ERROR':
-                    console.error(consoleMessage);
-                    break;
-                case 'WARN':
-                    console.warn(consoleMessage);
-                    break;
-                case 'INFO':
-                    console.info(consoleMessage);
-                    break;
-                case 'DEBUG':
-                    console.debug(consoleMessage);
-                    break;
-            }
+            process.stderr.write(consoleMessage + "\n");
         }
         if (this.logFileHandle) {
-            const entrySize = Buffer.byteLength(formattedEntry, 'utf8');
-            if (this.currentFileSize + entrySize >= (this.config.maxFileSize || 10 * 1024 * 1024)) {
+            const entrySize = Buffer.byteLength(formattedEntry, "utf8");
+            if (this.currentFileSize + entrySize >=
+                (this.config.maxFileSize || 10 * 1024 * 1024)) {
                 this.rotateLogFile();
             }
             this.logFileHandle.write(formattedEntry);
@@ -174,7 +168,7 @@ class Logger {
             timestamp: new Date().toISOString(),
             level,
             message,
-            component: context?.component || this.config.component
+            component: context?.component || this.config.component,
         };
         if (context?.connectionId)
             entry.connectionId = context.connectionId;
@@ -188,7 +182,7 @@ class Logger {
             entry.error = {
                 message: error.message,
                 stack: error.stack,
-                code: error.code
+                code: error.code,
             };
         }
         return entry;
@@ -214,57 +208,59 @@ class Logger {
                 data = errorOrData;
                 error = undefined;
             }
-            const entry = this.createLogEntry('ERROR', message, data, error, context);
+            const entry = this.createLogEntry("ERROR", message, data, error, context);
             this.writeLog(entry);
         }
     }
     warn(message, data, context) {
         if (this.config.level >= LogLevel.WARN) {
-            const entry = this.createLogEntry('WARN', message, data, undefined, context);
+            const entry = this.createLogEntry("WARN", message, data, undefined, context);
             this.writeLog(entry);
         }
     }
     info(message, data, context) {
         if (this.config.level >= LogLevel.INFO) {
-            const entry = this.createLogEntry('INFO', message, data, undefined, context);
+            const entry = this.createLogEntry("INFO", message, data, undefined, context);
             this.writeLog(entry);
         }
     }
     debug(message, data, context) {
         if (this.config.level >= LogLevel.DEBUG) {
-            const entry = this.createLogEntry('DEBUG', message, data, undefined, context);
+            const entry = this.createLogEntry("DEBUG", message, data, undefined, context);
             this.writeLog(entry);
         }
     }
     logServerEvent(event, message, data, error) {
-        const metrics = event === 'startup' || event === 'shutdown' ? {
-            memoryUsage: process.memoryUsage()
-        } : undefined;
-        const entry = this.createLogEntry(event === 'error' ? 'ERROR' : 'INFO', `[SERVER-${event.toUpperCase()}] ${message}`, data, error, { component: 'ProxyServer', metrics });
+        const metrics = event === "startup" || event === "shutdown"
+            ? {
+                memoryUsage: process.memoryUsage(),
+            }
+            : undefined;
+        const entry = this.createLogEntry(event === "error" ? "ERROR" : "INFO", `[SERVER-${event.toUpperCase()}] ${message}`, data, error, { component: "ProxyServer", metrics });
         this.writeLog(entry);
     }
     logConnectionEvent(event, connectionId, message, data, error) {
-        const entry = this.createLogEntry(error ? 'ERROR' : 'INFO', `[CONNECTION-${event.toUpperCase()}] ${message}`, data, error, { component: 'ConnectionPool', connectionId });
+        const entry = this.createLogEntry(error ? "ERROR" : "INFO", `[CONNECTION-${event.toUpperCase()}] ${message}`, data, error, { component: "ConnectionPool", connectionId });
         this.writeLog(entry);
     }
     logClientEvent(event, clientId, message, data, error) {
-        const entry = this.createLogEntry(error ? 'ERROR' : 'INFO', `[CLIENT-${event.toUpperCase()}] ${message}`, data, error, { component: 'WSProxy', clientId });
+        const entry = this.createLogEntry(error ? "ERROR" : "INFO", `[CLIENT-${event.toUpperCase()}] ${message}`, data, error, { component: "WSProxy", clientId });
         this.writeLog(entry);
     }
     logMemoryEvent(event, message, metrics) {
-        const entry = this.createLogEntry('INFO', `[MEMORY-${event.toUpperCase()}] ${message}`, undefined, undefined, { component: 'MemoryManager', metrics });
+        const entry = this.createLogEntry("INFO", `[MEMORY-${event.toUpperCase()}] ${message}`, undefined, undefined, { component: "MemoryManager", metrics });
         this.writeLog(entry);
     }
     logAPIEvent(method, path, statusCode, duration, clientIP, error) {
-        const entry = this.createLogEntry(error ? 'ERROR' : 'INFO', `[API] ${method} ${path} - ${statusCode} (${duration}ms)`, { clientIP, duration, statusCode }, error, { component: 'ProxyAPI' });
+        const entry = this.createLogEntry(error ? "ERROR" : "INFO", `[API] ${method} ${path} - ${statusCode} (${duration}ms)`, { clientIP, duration, statusCode }, error, { component: "ProxyAPI" });
         this.writeLog(entry);
     }
     logSecurityEvent(event, message, data, error) {
-        const entry = this.createLogEntry(error ? 'ERROR' : 'WARN', `[SECURITY-${event.toUpperCase()}] ${message}`, data, error, { component: 'SecurityManager' });
+        const entry = this.createLogEntry(error ? "ERROR" : "WARN", `[SECURITY-${event.toUpperCase()}] ${message}`, data, error, { component: "SecurityManager" });
         this.writeLog(entry);
     }
     logPerformanceMetrics(component, metrics) {
-        const entry = this.createLogEntry('INFO', `[PERFORMANCE] ${component} metrics`, undefined, undefined, { component, metrics });
+        const entry = this.createLogEntry("INFO", `[PERFORMANCE] ${component} metrics`, undefined, undefined, { component, metrics });
         this.writeLog(entry);
     }
     close() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-cdp-cli",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "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",