@weapp-vite/miniprogram-automator 1.2.4 → 1.2.6

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 import { EventEmitter } from "node:events";
 import WebSocket from "ws";
 import { Buffer } from "node:buffer";
-
 //#region src/smartapp/file.d.ts
 declare function mkdir(dir: string): Promise<void>;
 declare function rmdir(dir: string): Promise<void>;
@@ -54,7 +53,7 @@ declare class Connection extends EventEmitter {
   dispose(): void;
   private onMessage;
   private onClose;
-  static create(url: string): Promise<Connection>;
+  static create(url: string, timeout?: number): Promise<Connection>;
 }
 //#endregion
 //#region src/Native.d.ts
@@ -111,6 +110,9 @@ interface IEventOptions {
   detail?: Record<string, any>;
 }
 type ElementMap = Map<string, Element>;
+interface ElementQueryOptions {
+  timeout?: number;
+}
 /** Element 的实现。 */
 declare class Element {
   private connection;
@@ -122,8 +124,8 @@ declare class Element {
   private pageId;
   private publicProps?;
   constructor(connection: Connection, options: IElementOptions, elementMap: ElementMap);
-  $(selector: string): Promise<Element | null>;
-  $$(selector: string): Promise<any>;
+  $(selector: string, options?: ElementQueryOptions): Promise<Element | null>;
+  $$(selector: string, options?: ElementQueryOptions): Promise<any>;
   size(): Promise<{
     width: any;
     height: any;
@@ -144,7 +146,9 @@ declare class Element {
   touchend(options?: ITouchEventOptions): Promise<void>;
   dispatchEvent(options: IEventOptions): Promise<void>;
   protected _property(name: string | string[]): Promise<any>;
-  protected send(method: string, params?: Record<string, any>): Promise<any>;
+  protected send(method: string, params?: Record<string, any>, options?: {
+    timeout?: number;
+  }): Promise<any>;
   protected callFunction(functionName: string, ...args: any[]): Promise<any>;
   private domProperty;
   private getter;
@@ -202,6 +206,41 @@ interface IPageOptions {
 }
 type PageMap = Map<number, Page>;
 type WaitCondition = string | number | (() => unknown | Promise<unknown>);
+interface PageQueryOptions {
+  componentSelectors?: string[];
+  fallback?: boolean;
+  routeOnly?: boolean;
+  timeout?: number;
+}
+interface PageDataOptions {
+  fallback?: boolean;
+  routeOnly?: boolean;
+  timeout?: number;
+}
+interface PageCallMethodOptions {
+  fallback?: boolean;
+  routeOnly?: boolean;
+  timeout?: number;
+}
+interface PageRenderedOptions {
+  componentSelectors?: string[];
+  dataset?: Record<string, string | number | boolean>;
+  predicate?: (wxml: string) => boolean;
+  selector?: string;
+  text?: string;
+  timeout?: number;
+}
+interface RenderedNodeSnapshot {
+  bottom?: number;
+  dataset?: Record<string, unknown>;
+  height?: number;
+  id?: string;
+  left?: number;
+  right?: number;
+  top?: number;
+  width?: number;
+}
+type RenderedSelectorNodesSnapshot = Record<string, RenderedNodeSnapshot[]>;
 /** Page 的实现。 */
 declare class Page {
   private connection;
@@ -209,20 +248,32 @@ declare class Page {
   query: any;
   private id;
   private elementMap;
+  private preferRoutePageFallback;
   constructor(connection: Connection, options: IPageOptions);
+  updateFromOptions(options: IPageOptions): void;
   waitFor(condition: WaitCondition): Promise<void>;
-  $(selector: string): Promise<Element | null>;
-  $$(selector: string): Promise<any>;
-  getElementByXpath(selector: string): Promise<Element | null>;
-  getElementsByXpath(selector: string): Promise<any>;
+  $(selector: string, options?: PageQueryOptions): Promise<Element | null>;
+  $$(selector: string, options?: PageQueryOptions): Promise<any>;
+  getElementByXpath(selector: string, options?: PageQueryOptions): Promise<Element | null>;
+  getElementsByXpath(selector: string, options?: PageQueryOptions): Promise<any>;
   xpath(selector: string): Promise<Element | null>;
-  data(path?: string): Promise<any>;
+  wxml(): Promise<any>;
+  renderedNodes(selector: string, options?: PageQueryOptions): Promise<RenderedNodeSnapshot[]>;
+  renderedSelectorNodes(selectors: string[], options?: PageQueryOptions): Promise<RenderedSelectorNodesSnapshot>;
+  waitForRendered(options?: PageRenderedOptions): Promise<any>;
+  data(path?: string, options?: PageDataOptions): Promise<any>;
+  private readRouteData;
   setData(data: any): Promise<void>;
   size(): Promise<{
     width: any;
     height: any;
   }>;
   callMethod(method: string, ...args: any[]): Promise<any>;
+  callMethodWithOptions(method: string, options?: PageCallMethodOptions, ...args: any[]): Promise<any>;
+  private queryRouteElement;
+  private queryRouteElements;
+  private callRouteMethod;
+  private setRouteData;
   scrollTop(): Promise<any>;
   private windowProperty;
   private send;
@@ -245,25 +296,33 @@ interface IToolClearCacheOptions {
 }
 type AutomatorCallable = (...args: any[]) => any;
 interface CurrentPageOptions {
+  appFunctionFallback?: boolean;
   retries?: number;
   timeout?: number;
 }
+interface EvaluateOptions {
+  timeout?: number;
+}
 /** MiniProgram 的实现。 */
 declare class MiniProgram extends EventEmitter {
   private connection;
   private appBindings;
+  private logEnabled;
   private pageMap;
   private nativeIns?;
   constructor(connection: Connection);
   pageStack(): Promise<any>;
-  navigateTo(url: string): Promise<any>;
-  redirectTo(url: string): Promise<any>;
-  navigateBack(): Promise<any>;
-  reLaunch(url: string): Promise<any>;
-  switchTab(url: string): Promise<any>;
+  navigateTo(url: string): Promise<Page>;
+  redirectTo(url: string): Promise<Page>;
+  navigateBack(): Promise<Page>;
+  reLaunch(url: string): Promise<Page>;
+  switchTab(url: string): Promise<Page>;
   currentPage(options?: CurrentPageOptions): Promise<Page>;
   systemInfo(): Promise<any>;
   callWxMethod(method: string, ...args: any[]): Promise<any>;
+  callWxMethodWithOptions(method: string, options?: {
+    timeout?: number;
+  }, ...args: any[]): Promise<any>;
   private callWxMethodWithTimeout;
   mockWxMethod(method: string, result: any, ...args: any[]): Promise<void>;
   restoreWxMethod(method: string): Promise<void>;
@@ -271,10 +330,12 @@ declare class MiniProgram extends EventEmitter {
   mockPluginWxMethod(pluginId: string, method: string, result: any, ...args: any[]): Promise<void>;
   restorePluginWxMethod(pluginId: string, method: string): Promise<void>;
   evaluate(appFunction: AutomatorCallable | string, ...args: any[]): Promise<any>;
+  evaluateWithOptions(appFunction: AutomatorCallable | string, options?: EvaluateOptions, ...args: any[]): Promise<any>;
   pageScrollTo(scrollTop: number): Promise<void>;
   close(): Promise<void>;
   remote(auto?: boolean): Promise<void>;
   disconnect(): void;
+  enableLog(): Promise<void>;
   on(event: string | symbol, listener: (...args: any[]) => void): this;
   exposeFunction(name: string, bindingFunction: AutomatorCallable): Promise<void>;
   checkVersion(): Promise<void>;
@@ -309,6 +370,9 @@ declare class MiniProgram extends EventEmitter {
   private resolveRouteContextPage;
   private readRoutePollingCurrentPage;
   private readRoutePollingPageStack;
+  private createPageFromPayload;
+  private createPagesFromPayloads;
+  private readAppFunctionPageStack;
   private send;
   private onLogAdded;
   private onBindingCalled;
@@ -489,6 +553,7 @@ declare function normalizePlatform(platform?: MiniprogramAutomatorPlatform): Nor
 //#region src/Launcher.d.ts
 interface IConnectOptions {
   wsEndpoint: string;
+  timeout?: number;
   platform?: MiniprogramAutomatorPlatform;
 }
 /** ILaunchOptions 的类型定义。 */