@weapp-vite/miniprogram-automator 1.2.0 → 1.2.1

package/dist/index.d.mts

@@ -277,6 +277,10 @@ declare class MiniProgram extends EventEmitter {
   on(event: string | symbol, listener: (...args: any[]) => void): this;
   exposeFunction(name: string, bindingFunction: AutomatorCallable): Promise<void>;
   checkVersion(): Promise<void>;
+  /**
+   * @description 等待小程序 App 域协议可用，避免返回半就绪自动化会话。
+   */
+  waitForAppReady(timeout?: number): Promise<void>;
   screenshot(options?: IScreenshotOptions): Promise<any>;
   testAccounts(): Promise<any>;
   /**

package/dist/index.mjs

@@ -683,7 +683,7 @@ async function acquireAutomatorPortLease(preferredPort) {
 }
 //#endregion
 //#region package.json
-var version = "1.2.0";
+var version = "1.2.1";
 //#endregion
 //#region src/Native.ts
 /** Native 的实现。 */
@@ -880,6 +880,9 @@ const CHANGE_ROUTE_CONTEXT_TIMEOUT = 12e3;
 const CHANGE_ROUTE_CALL_TIMEOUT = 12e3;
 const CHANGE_ROUTE_READY_TIMEOUT = 15e3;
 const CHANGE_ROUTE_POLL_DELAY = 500;
+const APP_READY_TIMEOUT = 2e4;
+const APP_READY_PROBE_TIMEOUT = 3e3;
+const APP_READY_POLL_DELAY = 500;
 const CHANGE_ROUTE_DEBUG_ENABLED = process.env.WEAPP_VITE_E2E_CHANGE_ROUTE_DEBUG === "1";
 function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
@@ -1107,6 +1110,21 @@ var MiniProgram = class extends EventEmitter {
 		const sdkVersion = (await this.send("Tool.getInfo")).SDKVersion;
 		if (sdkVersion !== "dev" && cmpVersion(sdkVersion, "2.7.3") < 0) throw new Error(`SDKVersion is currently ${sdkVersion}, while automator(${version}) requires at least version 2.7.3`);
 	}
+	/**
+	* @description 等待小程序 App 域协议可用，避免返回半就绪自动化会话。
+	*/
+	async waitForAppReady(timeout = APP_READY_TIMEOUT) {
+		const startedAt = Date.now();
+		let lastError;
+		while (Date.now() - startedAt <= timeout) try {
+			await this.send("App.captureScreenshot", {}, { timeout: APP_READY_PROBE_TIMEOUT });
+			return;
+		} catch (error) {
+			lastError = error;
+			await sleep(APP_READY_POLL_DELAY);
+		}
+		throw lastError instanceof Error ? lastError : /* @__PURE__ */ new Error(`Timed out waiting App domain readiness after ${timeout}ms`);
+	}
 	async screenshot(options = {}) {
 		const { data } = await this.send("App.captureScreenshot");
 		if (!options.path) return data;
@@ -1815,6 +1833,7 @@ var Launcher = class {
 					const candidate = await this.connectTool({ wsEndpoint: `ws://127.0.0.1:${port}` });
 					try {
 						await candidate.checkVersion();
+						if (typeof candidate.waitForAppReady === "function") await candidate.waitForAppReady(timeout);
 					} catch (error) {
 						candidate.disconnect();
 						lastConnectError = error;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/miniprogram-automator",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "完全兼容微信 miniprogram-automator 的现代化替代实现",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",