@xbrowser/cli 1.4.5 → 1.4.7

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-V3VHXQQF.js → browser-2OK26HBS.js}

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

package/dist/{browser-5CM4GUZU.js → browser-SOML2EWR.js}

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

package/dist/{browser-2OALOLR2.js → browser-ZTTS2SVT.js}

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

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

@@ -1165,23 +1165,17 @@ var XBPageImpl = class _XBPageImpl {
       headers: () => headers
     };
   }
-  async goBack(opts = {}) {
+  async goBack(_opts = {}) {
+    const prevUrl = await this.evaluate("location.href").catch(() => "");
     await this.evaluate("() => history.back()");
-    await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 5e3).catch(() => {
-    });
-    try {
-      this._url = await this.evaluate("location.href");
-    } catch {
-    }
+    await this.waitForTimeout(2e3);
+    this._url = await this.evaluate("location.href").catch(() => prevUrl);
   }
-  async goForward(opts = {}) {
+  async goForward(_opts = {}) {
+    const prevUrl = await this.evaluate("location.href").catch(() => "");
     await this.evaluate("() => history.forward()");
-    await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 5e3).catch(() => {
-    });
-    try {
-      this._url = await this.evaluate("location.href");
-    } catch {
-    }
+    await this.waitForTimeout(2e3);
+    this._url = await this.evaluate("location.href").catch(() => prevUrl);
   }
   async reload(opts = {}) {
     this._loadState = { loadFired: false, domContentFired: false, networkIdle: false };

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

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

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

@@ -1164,23 +1164,17 @@ var XBPageImpl = class _XBPageImpl {
       headers: () => headers
     };
   }
-  async goBack(opts = {}) {
+  async goBack(_opts = {}) {
+    const prevUrl = await this.evaluate("location.href").catch(() => "");
     await this.evaluate("() => history.back()");
-    await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 5e3).catch(() => {
-    });
-    try {
-      this._url = await this.evaluate("location.href");
-    } catch {
-    }
+    await this.waitForTimeout(2e3);
+    this._url = await this.evaluate("location.href").catch(() => prevUrl);
   }
-  async goForward(opts = {}) {
+  async goForward(_opts = {}) {
+    const prevUrl = await this.evaluate("location.href").catch(() => "");
     await this.evaluate("() => history.forward()");
-    await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 5e3).catch(() => {
-    });
-    try {
-      this._url = await this.evaluate("location.href");
-    } catch {
-    }
+    await this.waitForTimeout(2e3);
+    this._url = await this.evaluate("location.href").catch(() => prevUrl);
   }
   async reload(opts = {}) {
     this._loadState = { loadFired: false, domContentFired: false, networkIdle: false };

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

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

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

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

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

@@ -1170,23 +1170,17 @@ var XBPageImpl = class _XBPageImpl {
       headers: () => headers
     };
   }
-  async goBack(opts = {}) {
+  async goBack(_opts = {}) {
+    const prevUrl = await this.evaluate("location.href").catch(() => "");
     await this.evaluate("() => history.back()");
-    await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 5e3).catch(() => {
-    });
-    try {
-      this._url = await this.evaluate("location.href");
-    } catch {
-    }
+    await this.waitForTimeout(2e3);
+    this._url = await this.evaluate("location.href").catch(() => prevUrl);
   }
-  async goForward(opts = {}) {
+  async goForward(_opts = {}) {
+    const prevUrl = await this.evaluate("location.href").catch(() => "");
     await this.evaluate("() => history.forward()");
-    await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 5e3).catch(() => {
-    });
-    try {
-      this._url = await this.evaluate("location.href");
-    } catch {
-    }
+    await this.waitForTimeout(2e3);
+    this._url = await this.evaluate("location.href").catch(() => prevUrl);
   }
   async reload(opts = {}) {
     this._loadState = { loadFired: false, domContentFired: false, networkIdle: false };

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-NW3WE5JK.js";
+} from "./chunk-RGS6ECTH.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -5466,12 +5466,12 @@ registerCommandDefinition("health", []);
 registerCommandDefinition("scrape", ["url"]);
 registerCommandDefinition("structure", []);
 registerCommandDefinition("get-cookies", []);
-registerCommandDefinition("set-cookie", []);
+registerCommandDefinition("set-cookie", ["name", "value"]);
 registerCommandDefinition("clear-cookies", []);
 registerCommandDefinition("get-local-storage", []);
-registerCommandDefinition("set-local-storage", []);
+registerCommandDefinition("set-local-storage", ["key", "value"]);
 registerCommandDefinition("clear-local-storage", []);
-registerCommandDefinition("set-viewport", []);
+registerCommandDefinition("set-viewport", ["width", "height"]);
 registerCommandDefinition("frames", []);
 registerCommandDefinition("frame", ["selector"]);
 registerCommandDefinition("actions", ["url"]);
@@ -7083,7 +7083,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-5CM4GUZU.js");
+    const { findTargetPage } = await import("./browser-SOML2EWR.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.`);
@@ -10040,6 +10040,24 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
           timeout: args[0] ? Number(args[0]) : options.timeout ? Number(options.timeout) : 1e3
         };
         break;
+      case "set-cookie":
+        cmdName = "set-cookie";
+        params = {
+          name: options.name || args[0],
+          value: (options.value || options.v) ?? args[1],
+          domain: options.domain,
+          path: options.path,
+          httpOnly: options.httpOnly ? Boolean(options.httpOnly) : void 0,
+          secure: options.secure ? Boolean(options.secure) : void 0
+        };
+        break;
+      case "set-local-storage":
+        cmdName = "set-local-storage";
+        params = {
+          key: options.key || args[0],
+          value: (options.value || options.v) ?? args[1]
+        };
+        break;
       default:
         cmdName = command;
         params = { ...options };
@@ -11841,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 {
@@ -12637,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 {
@@ -13039,7 +13059,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-5CM4GUZU.js");
+      const { ensureProcessCanExit } = await import("./browser-SOML2EWR.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,8 +21,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-SMRIC22G.js";
-import "./chunk-IDJ5NILK.js";
+} from "./chunk-NQSFETTQ.js";
+import "./chunk-2RHJEYWU.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getPluginLoader
@@ -5427,12 +5427,12 @@ registerCommandDefinition("health", []);
 registerCommandDefinition("scrape", ["url"]);
 registerCommandDefinition("structure", []);
 registerCommandDefinition("get-cookies", []);
-registerCommandDefinition("set-cookie", []);
+registerCommandDefinition("set-cookie", ["name", "value"]);
 registerCommandDefinition("clear-cookies", []);
 registerCommandDefinition("get-local-storage", []);
-registerCommandDefinition("set-local-storage", []);
+registerCommandDefinition("set-local-storage", ["key", "value"]);
 registerCommandDefinition("clear-local-storage", []);
-registerCommandDefinition("set-viewport", []);
+registerCommandDefinition("set-viewport", ["width", "height"]);
 registerCommandDefinition("frames", []);
 registerCommandDefinition("frame", ["selector"]);
 registerCommandDefinition("actions", ["url"]);
@@ -6614,7 +6614,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-V3VHXQQF.js");
+    const { findTargetPage } = await import("./browser-2OK26HBS.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-F4ORJMCL.js");
+        const { SessionReplayer } = await import("./session-replayer-YIGRIIDD.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-Z6GGTJL5.js";
-import "./chunk-IDJ5NILK.js";
+} from "./chunk-LYVU6SD3.js";
+import "./chunk-2RHJEYWU.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -5783,12 +5783,12 @@ registerCommandDefinition("health", []);
 registerCommandDefinition("scrape", ["url"]);
 registerCommandDefinition("structure", []);
 registerCommandDefinition("get-cookies", []);
-registerCommandDefinition("set-cookie", []);
+registerCommandDefinition("set-cookie", ["name", "value"]);
 registerCommandDefinition("clear-cookies", []);
 registerCommandDefinition("get-local-storage", []);
-registerCommandDefinition("set-local-storage", []);
+registerCommandDefinition("set-local-storage", ["key", "value"]);
 registerCommandDefinition("clear-local-storage", []);
-registerCommandDefinition("set-viewport", []);
+registerCommandDefinition("set-viewport", ["width", "height"]);
 registerCommandDefinition("frames", []);
 registerCommandDefinition("frame", ["selector"]);
 registerCommandDefinition("actions", ["url"]);
@@ -7403,7 +7403,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-2OALOLR2.js");
+    const { findTargetPage } = await import("./browser-ZTTS2SVT.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.`);
@@ -10380,6 +10380,24 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
           timeout: args[0] ? Number(args[0]) : options.timeout ? Number(options.timeout) : 1e3
         };
         break;
+      case "set-cookie":
+        cmdName = "set-cookie";
+        params = {
+          name: options.name || args[0],
+          value: (options.value || options.v) ?? args[1],
+          domain: options.domain,
+          path: options.path,
+          httpOnly: options.httpOnly ? Boolean(options.httpOnly) : void 0,
+          secure: options.secure ? Boolean(options.secure) : void 0
+        };
+        break;
+      case "set-local-storage":
+        cmdName = "set-local-storage";
+        params = {
+          key: options.key || args[0],
+          value: (options.value || options.v) ?? args[1]
+        };
+        break;
       default:
         cmdName = command;
         params = { ...options };
@@ -12181,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 {
@@ -12977,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 {
@@ -16166,7 +16186,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-VRXHK6P6.js");
+    const { launch } = await import("./cdp-driver-UGO45HXR.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-F4ORJMCL.js → session-replayer-YIGRIIDD.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-VRXHK6P6.js");
+      const { launch } = await import("./cdp-driver-UGO45HXR.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.5",
+  "version": "1.4.7",
   "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": {