@xbrowser/cli 1.4.6 → 1.4.8

package/README.md

@@ -9,7 +9,7 @@
 
 ## 特性
 
-- **50 浏览器命令** — 导航、交互、查询、存储、截图，覆盖常见自动化场景
+- **51 浏览器命令** — 导航、交互、查询、存储、截图，覆盖常见自动化场景
 - **命令链** — 用 `&&`、`,`、`+`、`->`、`;` 串联多个命令，一行搞定复杂流程
 - **管道 & Heredoc** — 支持 stdin 管道和 heredoc 批量执行
 - **录制 / 回放** — 录制浏览器操作为 YAML，随时回放，可转换为 JS/Python/Bash 脚本
@@ -854,7 +854,7 @@ npm run validate
 ```
 xbrowser/
 ├── src/
-│   ├── commands/        # 50 个浏览器命令定义
+│   ├── commands/        # 51 个浏览器命令定义
 │   ├── builtins/        # CLI 内置命令（config, plugin, session, create）
 │   ├── recorder/        # 录制引擎（录制器 + 回放器）
 │   ├── session/         # 会话管理
@@ -883,7 +883,7 @@ xbrowser/
 | **Setup** | `npm i -g` — 0 config | Install + browser download | Install + browser download | Install + WebDriver + drivers |
 | **Web Scraping** | Built-in (`scrape`, `crawl`, `map`) | Write custom scripts | Write custom scripts | Write custom scripts |
 | **Search** | Built-in multi-engine (`search`) | No | No | No |
-| **Plugin Ecosystem** | 69 plugins | Limited | Limited | No |
+| **Plugin Ecosystem** | 70+ plugins | Limited | Limited | No |
 | **No Code Required** | ✅ CLI commands | ❌ Must write JS/TS | ❌ Must write JS/TS | ❌ Must write code |
 | **Headless Mode** | ✅ Default | ✅ | ✅ | ✅ |
 | **Record/Replay** | ✅ Built-in (`record`/`replay`) | ✅ Codegen | ❌ | ❌ |

package/dist/{browser-SOML2EWR.js → browser-4KKT6V5S.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-RGS6ECTH.js";
+} from "./chunk-M4U63K6B.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-ZTTS2SVT.js → browser-FKKMMB44.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-LYVU6SD3.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-TP6RHIWG.js";
+import "./chunk-JGITVXIU.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-ABXMBNQ6.js";

package/dist/{browser-2OK26HBS.js → browser-MMIFKC36.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-NQSFETTQ.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-J7LDVYWI.js";
+import "./chunk-JGITVXIU.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{cdp-driver-UGO45HXR.js → cdp-driver-OY67R2KD.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-2RHJEYWU.js";
+} from "./chunk-JGITVXIU.js";
 import {
   connectToCDP,
   findChrome,

package/dist/{cdp-driver-67B5EI4C.js → cdp-driver-VFPOTO42.js}

@@ -303,6 +303,18 @@ function queryAllJS(selector) {
 async function waitForActionable(page, selector, opts = {}) {
   const timeout = opts.timeout ?? 3e4;
   if (opts.force) {
+    if (selector.startsWith("xpath=")) {
+      const rect2 = await page.evaluate(`
+        (function() {
+          const el = ${queryJS(selector)};
+          if (!el) return null;
+          const r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `);
+      if (!rect2) throw new Error(`Element not found: ${selector}`);
+      return { nodeId: 0, rect: rect2 };
+    }
     const nodeId = await page.querySelector(selector);
     if (!nodeId) throw new Error(`Element not found: ${selector}`);
     const rect = await page.getBoxModel(nodeId);
@@ -1656,6 +1668,22 @@ Last error: ${lastError.message}` : "";
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {
+    if (selector.startsWith("xpath=")) {
+      const found = await this.evaluate(`
+        (() => { const el = ${queryJS(selector)}; return !!el; })()
+      `).catch(() => false);
+      if (!found) return 0;
+      try {
+        const search = await this.conn.send(
+          "DOM.performSearch",
+          { query: selector.slice(6) },
+          this.sessionId
+        );
+        if (search.nodeId) return search.nodeId;
+      } catch {
+      }
+      return 1;
+    }
     const doc = await this.conn.send(
       "DOM.getDocument",
       { depth: 0 },

package/dist/{chunk-NQSFETTQ.js → chunk-J7LDVYWI.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-2RHJEYWU.js";
+} from "./chunk-JGITVXIU.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-2RHJEYWU.js → chunk-JGITVXIU.js}

@@ -302,6 +302,18 @@ function queryAllJS(selector) {
 async function waitForActionable(page, selector, opts = {}) {
   const timeout = opts.timeout ?? 3e4;
   if (opts.force) {
+    if (selector.startsWith("xpath=")) {
+      const rect2 = await page.evaluate(`
+        (function() {
+          const el = ${queryJS(selector)};
+          if (!el) return null;
+          const r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `);
+      if (!rect2) throw new Error(`Element not found: ${selector}`);
+      return { nodeId: 0, rect: rect2 };
+    }
     const nodeId = await page.querySelector(selector);
     if (!nodeId) throw new Error(`Element not found: ${selector}`);
     const rect = await page.getBoxModel(nodeId);
@@ -1655,6 +1667,22 @@ Last error: ${lastError.message}` : "";
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {
+    if (selector.startsWith("xpath=")) {
+      const found = await this.evaluate(`
+        (() => { const el = ${queryJS(selector)}; return !!el; })()
+      `).catch(() => false);
+      if (!found) return 0;
+      try {
+        const search = await this.conn.send(
+          "DOM.performSearch",
+          { query: selector.slice(6) },
+          this.sessionId
+        );
+        if (search.nodeId) return search.nodeId;
+      } catch {
+      }
+      return 1;
+    }
     const doc = await this.conn.send(
       "DOM.getDocument",
       { depth: 0 },

package/dist/{chunk-RGS6ECTH.js → chunk-M4U63K6B.js}

@@ -308,6 +308,18 @@ function queryAllJS(selector) {
 async function waitForActionable(page, selector, opts = {}) {
   const timeout = opts.timeout ?? 3e4;
   if (opts.force) {
+    if (selector.startsWith("xpath=")) {
+      const rect2 = await page.evaluate(`
+        (function() {
+          const el = ${queryJS(selector)};
+          if (!el) return null;
+          const r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `);
+      if (!rect2) throw new Error(`Element not found: ${selector}`);
+      return { nodeId: 0, rect: rect2 };
+    }
     const nodeId = await page.querySelector(selector);
     if (!nodeId) throw new Error(`Element not found: ${selector}`);
     const rect = await page.getBoxModel(nodeId);
@@ -1661,6 +1673,22 @@ Last error: ${lastError.message}` : "";
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {
+    if (selector.startsWith("xpath=")) {
+      const found = await this.evaluate(`
+        (() => { const el = ${queryJS(selector)}; return !!el; })()
+      `).catch(() => false);
+      if (!found) return 0;
+      try {
+        const search = await this.conn.send(
+          "DOM.performSearch",
+          { query: selector.slice(6) },
+          this.sessionId
+        );
+        if (search.nodeId) return search.nodeId;
+      } catch {
+      }
+      return 1;
+    }
     const doc = await this.conn.send(
       "DOM.getDocument",
       { depth: 0 },

package/dist/{chunk-LYVU6SD3.js → chunk-TP6RHIWG.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-2RHJEYWU.js";
+} from "./chunk-JGITVXIU.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-RGS6ECTH.js";
+} from "./chunk-M4U63K6B.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -1208,9 +1208,9 @@ var setViewportCommand = registerCommand({
   description: "Set the viewport size and properties",
   scope: "browser",
   parameters: z11.object({
-    width: z11.number(),
-    height: z11.number(),
-    deviceScaleFactor: z11.number().optional(),
+    width: z11.coerce.number(),
+    height: z11.coerce.number(),
+    deviceScaleFactor: z11.coerce.number().optional(),
     isMobile: z11.boolean().optional(),
     hasTouch: z11.boolean().optional()
   }),
@@ -7083,7 +7083,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-SOML2EWR.js");
+    const { findTargetPage } = await import("./browser-4KKT6V5S.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -11859,7 +11859,8 @@ function printChainResult(chainResult) {
       }
       if (step.tips?.length) {
         for (const tip of step.tips) {
-          console.log(`  \u{1F4A1} ${tip}`);
+          const text = typeof tip === "string" ? tip : tip.message;
+          if (text) console.log(`  \u{1F4A1} ${text}`);
         }
       }
     } else {
@@ -12655,7 +12656,8 @@ async function routeCommand(argvIn, stdinCommands) {
                 }
                 if (step.tips?.length) {
                   for (const tip of step.tips) {
-                    console.log(`  \u{1F4A1} ${tip}`);
+                    const text = typeof tip === "string" ? tip : tip.message;
+                    if (text) console.log(`  \u{1F4A1} ${text}`);
                   }
                 }
               } else {
@@ -13057,7 +13059,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-SOML2EWR.js");
+      const { ensureProcessCanExit } = await import("./browser-4KKT6V5S.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,8 +21,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-NQSFETTQ.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-J7LDVYWI.js";
+import "./chunk-JGITVXIU.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getPluginLoader
@@ -1169,9 +1169,9 @@ var setViewportCommand = registerCommand({
   description: "Set the viewport size and properties",
   scope: "browser",
   parameters: z11.object({
-    width: z11.number(),
-    height: z11.number(),
-    deviceScaleFactor: z11.number().optional(),
+    width: z11.coerce.number(),
+    height: z11.coerce.number(),
+    deviceScaleFactor: z11.coerce.number().optional(),
     isMobile: z11.boolean().optional(),
     hasTouch: z11.boolean().optional()
   }),
@@ -6614,7 +6614,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-2OK26HBS.js");
+    const { findTargetPage } = await import("./browser-MMIFKC36.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -8330,7 +8330,7 @@ function createRPCHandler() {
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
-        const { SessionReplayer } = await import("./session-replayer-YIGRIIDD.js");
+        const { SessionReplayer } = await import("./session-replayer-JIH6H7WX.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.js

@@ -81,8 +81,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-LYVU6SD3.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-TP6RHIWG.js";
+import "./chunk-JGITVXIU.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -1248,9 +1248,9 @@ var setViewportCommand = registerCommand({
   description: "Set the viewport size and properties",
   scope: "browser",
   parameters: z11.object({
-    width: z11.number(),
-    height: z11.number(),
-    deviceScaleFactor: z11.number().optional(),
+    width: z11.coerce.number(),
+    height: z11.coerce.number(),
+    deviceScaleFactor: z11.coerce.number().optional(),
     isMobile: z11.boolean().optional(),
     hasTouch: z11.boolean().optional()
   }),
@@ -7403,7 +7403,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-ZTTS2SVT.js");
+    const { findTargetPage } = await import("./browser-FKKMMB44.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -12199,7 +12199,8 @@ function printChainResult(chainResult) {
       }
       if (step.tips?.length) {
         for (const tip of step.tips) {
-          console.log(`  \u{1F4A1} ${tip}`);
+          const text = typeof tip === "string" ? tip : tip.message;
+          if (text) console.log(`  \u{1F4A1} ${text}`);
         }
       }
     } else {
@@ -12995,7 +12996,8 @@ async function routeCommand(argvIn, stdinCommands) {
                 }
                 if (step.tips?.length) {
                   for (const tip of step.tips) {
-                    console.log(`  \u{1F4A1} ${tip}`);
+                    const text = typeof tip === "string" ? tip : tip.message;
+                    if (text) console.log(`  \u{1F4A1} ${text}`);
                   }
                 }
               } else {
@@ -16184,7 +16186,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-UGO45HXR.js");
+    const { launch } = await import("./cdp-driver-OY67R2KD.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-YIGRIIDD.js → session-replayer-JIH6H7WX.js}

@@ -31,7 +31,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-UGO45HXR.js");
+      const { launch } = await import("./cdp-driver-OY67R2KD.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.4.6",
+  "version": "1.4.8",
   "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {