@mpcore/simulator 0.4.3 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -12,7 +12,15 @@
12
12
  - 提供测试节点句柄上的 `tap()`、`trigger()`、`input()`、`change()`、`blur()` 交互辅助方法
13
13
  - 提供测试页面/会话句柄上的 `waitForSelector()`、`waitForText()`、`waitForTextGone()`、`waitForData()`、`waitForCurrentPage()` 等轮询等待方法
14
14
  - 测试会话句柄提供与 `miniprogram-automator` 对齐的 `toolInfo()`,headless provider 返回稳定的 simulator 标识
15
+ - 提供原生形状的 `wx.onAppShow/offAppShow/onAppHide/offAppHide`;Node/browser session 与测试句柄通过 `triggerAppShow(options?)`、`triggerAppHide({ reason })` 显式驱动应用前后台事件,普通页面导航不会伪造应用切换
16
+ - 测试入口 `launch({ configureSession })` 会在执行 `app.js` 前等待配置完成,可安装测试宿主能力;配置失败会关闭会话,默认 request 仍受既有 mock / strict mock 策略约束,不自动开放真实网络
15
17
  - 通过共享 `RuntimeKernel` 管理 artifact、独立执行 realm、timer、diagnostics 与平台适配边界
16
18
  - `close()` 会清理页面栈、组件 scope、observer、timer、事件和模块缓存,并使旧页面/节点 handle 失效
17
19
 
18
20
  编写页面和组件单测时优先使用上层 `@mpcore/test`;直接使用本包适合实现 provider、调试桥或更低层运行时断言。
21
+
22
+ 应用首次启动只执行一次 `onLaunch`,并在首页加载前发送应用显示事件。后续 `triggerAppShow` 更新 enter options,不改写 launch options;隐藏原因显式限定为 `0 | 1 | 2 | 3`。关闭会话会清理应用事件监听,不合成额外的隐藏事件。这里定义的是可测试的 simulator 行为,不代表已验证真实微信 IDE 中 App hook 与 `wx` 监听器之间的相对调用顺序。
23
+
24
+ 浏览器会话的 `renderCurrentPage().styles` 提供当前页面的 `cssText`、项目相对 `dependencies` 和 `appWxssEnabled`,Web demo 将该结果挂载到页面预览的 Shadow DOM。解析器读取 `app.wxss`、页面 `.wxss` 及递归本地 `@import`,保留导入位置和全局在前、页面在后的层叠顺序;页面 `.wxss` 内联的全局样式快照也会动态加载,并保留其后页面自有样式的覆盖优先级。文件修改后重新渲染会读取最新内容,包括只更新样式的场景,不重建页面或 App 实例。
25
+
26
+ 此入口只负责页面样式依赖和 CSS 兼容声明,不实现嵌套组件的完整样式隔离、类名前缀转换或 `rpx` 布局换算。Component 页面的 `page-isolated`、`page-strong-isolated`、`page-apply-shared`、`page-shared` 禁用隐式 `app.wxss`,页面仍可显式导入样式;最终页面 JSON 的 `styleIsolation` 优先于 JS 定义,JSON 未提供该值时才保留 JS 选项。普通 `Page` 注册不应用组件隔离选项,普通 `isolated` 也不等同于 `page-isolated`。缺失依赖、循环导入、非法 CSS 和不支持的导入会抛出明确错误。支持带媒体条件的本地导入;远程导入及 `layer` / `supports` 导入条件不受支持,也不会触发外部请求。
package/dist/index.d.mts CHANGED
@@ -337,11 +337,16 @@ export interface HeadlessWxLaunchOptions {
337
337
  path: string;
338
338
  query: Record<string, string>;
339
339
  referrerInfo: {
340
- appId: string;
341
- extraData: Record<string, never>;
340
+ appId?: string;
341
+ extraData?: Record<string, never>;
342
342
  };
343
343
  scene: number;
344
344
  }
345
+ export interface HeadlessWxAppHideOptions {
346
+ reason: 0 | 1 | 2 | 3;
347
+ }
348
+ export type HeadlessWxAppHideCallback = (options: HeadlessWxAppHideOptions) => void;
349
+ export type HeadlessWxAppShowCallback = (options: HeadlessWxLaunchOptions) => void;
345
350
  export interface HeadlessWxMenuButtonBoundingClientRectResult {
346
351
  bottom: number;
347
352
  height: number;
@@ -478,6 +483,18 @@ export interface HeadlessWxFileSystemManager {
478
483
  writeFileSync: (filePath: string, data: string, encoding?: string) => void;
479
484
  }
480
485
  //#endregion
486
+ //#region src/host/wx/logManager.d.ts
487
+ interface HeadlessWxGetLogManagerOption {
488
+ /** 控制宿主自动生命周期及 API 日志,不过滤显式日志方法。 */
489
+ level?: number;
490
+ }
491
+ interface HeadlessWxLogManager {
492
+ debug: (...args: unknown[]) => void;
493
+ info: (...args: unknown[]) => void;
494
+ log: (...args: unknown[]) => void;
495
+ warn: (...args: unknown[]) => void;
496
+ }
497
+ //#endregion
481
498
  //#region src/host/wx/media.d.ts
482
499
  export interface HeadlessWxGetImageInfoResult {
483
500
  errMsg: string;
@@ -837,7 +854,11 @@ export interface HeadlessWxDriverCapabilities {
837
854
  navigateBack: (option?: HeadlessWxNavigateBackOption) => unknown;
838
855
  navigateTo: (option: HeadlessWxNavigateOption) => unknown;
839
856
  nextTick: (callback?: () => void) => void;
857
+ offAppHide: (callback?: HeadlessWxAppHideCallback) => void;
858
+ offAppShow: (callback?: HeadlessWxAppShowCallback) => void;
840
859
  offNetworkStatusChange: (callback?: HeadlessWxNetworkStatusChangeCallback) => void;
860
+ onAppHide: (callback: HeadlessWxAppHideCallback) => void;
861
+ onAppShow: (callback: HeadlessWxAppShowCallback) => void;
841
862
  onNetworkStatusChange: (callback: HeadlessWxNetworkStatusChangeCallback) => void;
842
863
  pageScrollTo: (option: HeadlessWxPageScrollToOption) => unknown;
843
864
  reLaunch: (option: HeadlessWxNavigateOption) => unknown;
@@ -947,6 +968,7 @@ export interface HeadlessWx extends HeadlessUniEventBus {
947
968
  getAppBaseInfoSync: () => HeadlessWxAppBaseInfoResult;
948
969
  getDeviceInfo: () => HeadlessWxDeviceInfoResult;
949
970
  getLaunchOptionsSync: () => HeadlessWxLaunchOptions;
971
+ getLogManager: (option?: HeadlessWxGetLogManagerOption) => HeadlessWxLogManager;
950
972
  getMenuButtonBoundingClientRect: () => HeadlessWxMenuButtonBoundingClientRectResult;
951
973
  getClipboardData: (option?: HeadlessWxGetClipboardDataOption) => HeadlessWxGetClipboardDataResult | undefined;
952
974
  getLocation: (option?: HeadlessWxGetLocationOption) => HeadlessWxGetLocationResult | undefined;
@@ -970,7 +992,11 @@ export interface HeadlessWx extends HeadlessUniEventBus {
970
992
  navigateBack: (option?: HeadlessWxNavigateBackOption) => unknown;
971
993
  navigateTo: (option: HeadlessWxNavigateOption) => unknown;
972
994
  nextTick: (callback?: () => void) => void;
995
+ offAppHide: (callback?: HeadlessWxAppHideCallback) => void;
996
+ offAppShow: (callback?: HeadlessWxAppShowCallback) => void;
973
997
  offNetworkStatusChange: (callback?: HeadlessWxNetworkStatusChangeCallback) => void;
998
+ onAppHide: (callback: HeadlessWxAppHideCallback) => void;
999
+ onAppShow: (callback: HeadlessWxAppShowCallback) => void;
974
1000
  onNetworkStatusChange: (callback: HeadlessWxNetworkStatusChangeCallback) => void;
975
1001
  openDocument: (option: HeadlessWxOpenDocumentOption) => HeadlessWxOpenDocumentResult | undefined;
976
1002
  pageScrollTo: (option: HeadlessWxPageScrollToOption) => unknown;
@@ -1055,7 +1081,7 @@ export interface HeadlessWx extends HeadlessUniEventBus {
1055
1081
  }
1056
1082
  //#endregion
1057
1083
  //#region src/host/wx/index.d.ts
1058
- export declare function createHeadlessWx(driver: HeadlessWxDriver): HeadlessWx;
1084
+ export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'>): HeadlessWx;
1059
1085
  //#endregion
1060
1086
  //#region src/kernel/artifactSource.d.ts
1061
1087
  export interface ArtifactSource {
@@ -1246,30 +1272,6 @@ interface HeadlessBackgroundSnapshot {
1246
1272
  textStyle: HeadlessBackgroundTextStyle;
1247
1273
  }
1248
1274
  //#endregion
1249
- //#region src/runtime/pageInstance.d.ts
1250
- export interface HeadlessPageInstance extends Record<string, any> {
1251
- __background__?: HeadlessBackgroundSnapshot;
1252
- __backgroundTextStyle__?: HeadlessBackgroundTextStyle;
1253
- __lastChangedKeys__?: string[];
1254
- __navigationBar__?: HeadlessNavigationBarSnapshot;
1255
- __navigationBarTitle__?: string;
1256
- __route__: string;
1257
- __scrollTop__?: number;
1258
- data: Record<string, any>;
1259
- options: Record<string, string>;
1260
- route: string;
1261
- createIntersectionObserver?: (options?: Record<string, any>) => any;
1262
- createMediaQueryObserver?: () => HeadlessWxMediaQueryObserver;
1263
- selectAllComponents?: (selector: string) => any[];
1264
- selectComponent?: (selector: string) => any;
1265
- setData: (patch: Record<string, any>, callback?: () => void) => void;
1266
- }
1267
- export declare function createPageInstance(route: string, definition: HeadlessPageDefinition, options?: Record<string, string>, pageState?: {
1268
- background?: HeadlessBackgroundSnapshot;
1269
- backgroundTextStyle?: HeadlessBackgroundTextStyle;
1270
- navigationBar?: HeadlessNavigationBarSnapshot;
1271
- }): HeadlessPageInstance;
1272
- //#endregion
1273
1275
  //#region src/runtime/componentInstance/types.d.ts
1274
1276
  interface HeadlessComponentInstance extends Record<string, any> {
1275
1277
  __definition__?: HeadlessComponentDefinition;
@@ -1278,6 +1280,8 @@ interface HeadlessComponentInstance extends Record<string, any> {
1278
1280
  __ready__?: boolean;
1279
1281
  createIntersectionObserver?: (options?: Record<string, any>) => any;
1280
1282
  createMediaQueryObserver?: () => HeadlessWxMediaQueryObserver;
1283
+ createSelectorQuery?: () => HeadlessWxSelectorQuery;
1284
+ getRelationNodes: (relationKey: string) => HeadlessComponentInstance[];
1281
1285
  data: Record<string, any>;
1282
1286
  properties: Record<string, any>;
1283
1287
  selectAllComponents?: (selector: string) => any[];
@@ -1309,18 +1313,68 @@ export declare function createComponentInstance(options: CreateComponentInstance
1309
1313
  export declare function runComponentLifecycle(instance: HeadlessComponentInstance, lifecycleName: 'attached' | 'created' | 'detached' | 'ready'): void;
1310
1314
  export declare function runComponentPageLifetime(instance: HeadlessComponentInstance, lifetimeName: 'hide' | 'resize' | 'show', payload?: unknown): void;
1311
1315
  //#endregion
1316
+ //#region src/runtime/pageInstance.d.ts
1317
+ export interface HeadlessPageInstance extends Record<string, any> {
1318
+ __background__?: HeadlessBackgroundSnapshot;
1319
+ __backgroundTextStyle__?: HeadlessBackgroundTextStyle;
1320
+ __lastChangedKeys__?: string[];
1321
+ __navigationBar__?: HeadlessNavigationBarSnapshot;
1322
+ __navigationBarTitle__?: string;
1323
+ __route__: string;
1324
+ __scrollTop__?: number;
1325
+ data: Record<string, any>;
1326
+ properties: Record<string, any>;
1327
+ options: Record<string, string>;
1328
+ route: string;
1329
+ createIntersectionObserver?: (options?: Record<string, any>) => any;
1330
+ createMediaQueryObserver?: () => HeadlessWxMediaQueryObserver;
1331
+ getTabBar?: () => HeadlessComponentInstance | null;
1332
+ selectAllComponents?: (selector: string) => any[];
1333
+ selectComponent?: (selector: string) => any;
1334
+ setData: (patch: Record<string, any>, callback?: () => void) => void;
1335
+ }
1336
+ export declare function getPageInstanceId(page: HeadlessPageInstance): number;
1337
+ export declare function createPageInstance(route: string, definition: HeadlessPageDefinition, options?: Record<string, string>, pageState?: {
1338
+ background?: HeadlessBackgroundSnapshot;
1339
+ backgroundTextStyle?: HeadlessBackgroundTextStyle;
1340
+ navigationBar?: HeadlessNavigationBarSnapshot;
1341
+ requestRender?: (callback?: () => void) => void;
1342
+ }): HeadlessPageInstance;
1343
+ //#endregion
1344
+ //#region src/view/wxs.d.ts
1345
+ type WxsModuleBindings = Record<string, unknown>;
1346
+ //#endregion
1312
1347
  //#region src/view/templateRuntime.d.ts
1313
1348
  interface TemplateNodeLike {
1314
1349
  attribs?: Record<string, string>;
1315
1350
  children?: TemplateNodeLike[];
1351
+ data?: string;
1316
1352
  name?: string;
1317
1353
  type?: string;
1318
1354
  }
1319
1355
  interface TemplateRenderState<T extends TemplateNodeLike> {
1320
1356
  definitions: Map<string, T>;
1357
+ definitionScopes?: Map<T, Map<string, T>>;
1358
+ definitionWxsScopes?: Map<T, WxsModuleBindings>;
1359
+ wxsModules?: WxsModuleBindings;
1321
1360
  stack: string[];
1322
1361
  }
1323
1362
  //#endregion
1363
+ //#region src/browser/styles/index.d.ts
1364
+ export interface BrowserPageStyles {
1365
+ /** 按实际遍历顺序去重的项目相对样式依赖。 */
1366
+ dependencies: string[];
1367
+ /** 已展开本地导入的页面 CSS;不包含嵌套组件样式隔离转换。 */
1368
+ cssText: string;
1369
+ /** Component 页面的 page-* 隔离选项可关闭隐式 app.wxss。 */
1370
+ appWxssEnabled: boolean;
1371
+ }
1372
+ /** 读取当前文件内容并展开页面样式依赖,保持 app 在前、页面声明在后的层叠顺序。 */
1373
+ export declare function resolveBrowserPageStyles(files: BrowserVirtualFiles, route: string, options?: {
1374
+ miniprogramRootPath?: string;
1375
+ styleIsolation?: string;
1376
+ }): BrowserPageStyles;
1377
+ //#endregion
1324
1378
  //#region src/browser/render/types.d.ts
1325
1379
  interface DomNodeLike$5 {
1326
1380
  attribs?: Record<string, string>;
@@ -1331,6 +1385,7 @@ interface DomNodeLike$5 {
1331
1385
  type?: string;
1332
1386
  }
1333
1387
  interface BrowserRenderScope {
1388
+ wxs?: WxsModuleBindings;
1334
1389
  alias?: string;
1335
1390
  classList?: string[];
1336
1391
  data: Record<string, any>;
@@ -1358,6 +1413,7 @@ interface BrowserSlotContent {
1358
1413
  }
1359
1414
  interface BrowserRenderedPageTree {
1360
1415
  root: DomNodeLike$5;
1416
+ styles: BrowserPageStyles;
1361
1417
  wxml: string;
1362
1418
  }
1363
1419
  interface BrowserRendererContext {
@@ -1389,6 +1445,7 @@ export declare function createAppInstance(definition: HeadlessAppDefinition): He
1389
1445
  //#region src/runtime/moduleLoader.d.ts
1390
1446
  interface HeadlessModuleLoader {
1391
1447
  close: () => void;
1448
+ evaluate: <T>(source: string, args: any[]) => T;
1392
1449
  executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
1393
1450
  executeAppModule: (filePath: string) => HeadlessAppDefinition;
1394
1451
  executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
@@ -1405,6 +1462,7 @@ interface DomNodeLike$4 {
1405
1462
  type?: string;
1406
1463
  }
1407
1464
  interface RuntimeRenderScope {
1465
+ wxs?: WxsModuleBindings;
1408
1466
  alias?: string;
1409
1467
  classList?: string[];
1410
1468
  data: Record<string, any>;
@@ -1846,6 +1904,7 @@ export declare class HeadlessSession {
1846
1904
  private readonly kernel;
1847
1905
  private appDefinition;
1848
1906
  private appInstance;
1907
+ private readonly appLifecycle;
1849
1908
  private readonly moduleLoader;
1850
1909
  private readonly eventListeners;
1851
1910
  private readonly registries;
@@ -1879,6 +1938,8 @@ export declare class HeadlessSession {
1879
1938
  getApp(): HeadlessAppInstance | null;
1880
1939
  getCurrentPages(): HeadlessPageInstance[];
1881
1940
  getWx(): HeadlessWx;
1941
+ /** 在当前小程序实例的上下文执行测试函数,复用应用全局对象与调度器。 */
1942
+ evaluateRuntime<T = unknown>(source: string, args?: any[]): T;
1882
1943
  callWxMethod(methodName: string, ...args: any[]): any;
1883
1944
  getCurrentPageNavigationBarTitle(): string | null;
1884
1945
  getCurrentPageNavigationBar(): {
@@ -2045,32 +2106,8 @@ export declare class HeadlessSession {
2045
2106
  getWindowInfo(): HeadlessWxWindowInfoResult;
2046
2107
  getAppBaseInfo(): HeadlessWxAppBaseInfoResult;
2047
2108
  getDeviceInfo(): HeadlessWxDeviceInfoResult;
2048
- getLaunchOptions(): {
2049
- query: {
2050
- [x: string]: string;
2051
- };
2052
- referrerInfo: {
2053
- extraData: {
2054
- [x: string]: never;
2055
- };
2056
- appId: string;
2057
- };
2058
- path: string;
2059
- scene: number;
2060
- };
2061
- getEnterOptions(): {
2062
- query: {
2063
- [x: string]: string;
2064
- };
2065
- referrerInfo: {
2066
- extraData: {
2067
- [x: string]: never;
2068
- };
2069
- appId: string;
2070
- };
2071
- path: string;
2072
- scene: number;
2073
- };
2109
+ getLaunchOptions(): HeadlessWxLaunchOptions;
2110
+ getEnterOptions(): HeadlessWxLaunchOptions;
2074
2111
  getMenuButtonBoundingClientRect(): HeadlessWxMenuButtonBoundingClientRectResult;
2075
2112
  getLocation(): HeadlessWxGetLocationResult;
2076
2113
  getNetworkType(): HeadlessWxGetNetworkTypeResult;
@@ -2157,6 +2194,7 @@ export declare class HeadlessSession {
2157
2194
  };
2158
2195
  bootstrap(launchOptions?: HeadlessWxLaunchOptions): HeadlessAppInstance;
2159
2196
  private syncRuntimeAppState;
2197
+ private bootstrapNavigation;
2160
2198
  reLaunch(url: string): HeadlessPageInstance;
2161
2199
  navigateTo(url: string): HeadlessPageInstance;
2162
2200
  redirectTo(url: string): HeadlessPageInstance;
@@ -2172,6 +2210,8 @@ export declare class HeadlessSession {
2172
2210
  fail?: (error: Error) => void;
2173
2211
  complete?: () => void;
2174
2212
  }): void;
2213
+ triggerAppHide(options: HeadlessWxAppHideOptions): void;
2214
+ triggerAppShow(options?: HeadlessWxLaunchOptions): void;
2175
2215
  triggerPullDownRefresh(): HeadlessPageInstance;
2176
2216
  startPullDownRefresh(): {
2177
2217
  errMsg: string;
@@ -2219,6 +2259,7 @@ export declare class BrowserHeadlessSession {
2219
2259
  readonly project: HeadlessProjectDescriptor;
2220
2260
  private appDefinition;
2221
2261
  private appInstance;
2262
+ private readonly appLifecycle;
2222
2263
  private readonly moduleLoader;
2223
2264
  private readonly onRender?;
2224
2265
  private readonly registries;
@@ -2385,32 +2426,8 @@ export declare class BrowserHeadlessSession {
2385
2426
  getWindowInfo(): HeadlessWxWindowInfoResult;
2386
2427
  getAppBaseInfo(): HeadlessWxAppBaseInfoResult;
2387
2428
  getDeviceInfo(): HeadlessWxDeviceInfoResult;
2388
- getLaunchOptions(): {
2389
- query: {
2390
- [x: string]: string;
2391
- };
2392
- referrerInfo: {
2393
- extraData: {
2394
- [x: string]: never;
2395
- };
2396
- appId: string;
2397
- };
2398
- path: string;
2399
- scene: number;
2400
- };
2401
- getEnterOptions(): {
2402
- query: {
2403
- [x: string]: string;
2404
- };
2405
- referrerInfo: {
2406
- extraData: {
2407
- [x: string]: never;
2408
- };
2409
- appId: string;
2410
- };
2411
- path: string;
2412
- scene: number;
2413
- };
2429
+ getLaunchOptions(): HeadlessWxLaunchOptions;
2430
+ getEnterOptions(): HeadlessWxLaunchOptions;
2414
2431
  getMenuButtonBoundingClientRect(): HeadlessWxMenuButtonBoundingClientRectResult;
2415
2432
  getLocation(): HeadlessWxGetLocationResult;
2416
2433
  getNetworkType(): HeadlessWxGetNetworkTypeResult;
@@ -2540,6 +2557,7 @@ export declare class BrowserHeadlessSession {
2540
2557
  };
2541
2558
  }): any;
2542
2559
  bootstrap(launchOptions?: HeadlessWxLaunchOptions): HeadlessAppInstance;
2560
+ private bootstrapNavigation;
2543
2561
  reLaunch(url: string): HeadlessPageInstance;
2544
2562
  navigateTo(url: string): HeadlessPageInstance;
2545
2563
  redirectTo(url: string): HeadlessPageInstance;
@@ -2552,6 +2570,8 @@ export declare class BrowserHeadlessSession {
2552
2570
  selector?: string;
2553
2571
  scrollTop?: number;
2554
2572
  }): void;
2573
+ triggerAppHide(options: HeadlessWxAppHideOptions): void;
2574
+ triggerAppShow(options?: HeadlessWxLaunchOptions): void;
2555
2575
  triggerPullDownRefresh(): HeadlessPageInstance;
2556
2576
  startPullDownRefresh(): {
2557
2577
  errMsg: string;
@@ -2663,8 +2683,10 @@ export declare class HeadlessTestingNodeHandle {
2663
2683
  private readonly interactions?;
2664
2684
  constructor(node: DomNodeLike$3, interactions?: HeadlessTestingNodeInteractionHandlers | undefined);
2665
2685
  private assertActive;
2686
+ private query;
2666
2687
  $(selector: string): Promise<HeadlessTestingNodeHandle | null>;
2667
2688
  $$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
2689
+ getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
2668
2690
  attr(name: string): Promise<string | undefined>;
2669
2691
  dataset(): Promise<Record<string, string>>;
2670
2692
  scope(): Promise<{
@@ -2804,6 +2826,8 @@ export declare class HeadlessTestingPageHandle {
2804
2826
  private readonly page;
2805
2827
  private readonly session?;
2806
2828
  constructor(project: HeadlessProjectDescriptor, page: HeadlessPageInstance, session?: HeadlessSession | undefined);
2829
+ /** 返回底层页面实例身份;重新获取 handle 不会改变该身份。 */
2830
+ get pageId(): number;
2807
2831
  get path(): string;
2808
2832
  get query(): {
2809
2833
  [x: string]: string;
@@ -2814,11 +2838,13 @@ export declare class HeadlessTestingPageHandle {
2814
2838
  callMethod(methodName: string, ...args: any[]): Promise<any>;
2815
2839
  callMethodWithOptions(methodName: string, options?: HeadlessTestingPageCallMethodOptions, ...args: any[]): Promise<any>;
2816
2840
  data(path?: string): Promise<any>;
2841
+ setData(data: Record<string, unknown>): Promise<void>;
2817
2842
  selectComponent(selector: string): Promise<HeadlessTestingScopeHandle | null>;
2818
2843
  selectAllComponents(selector: string): Promise<HeadlessTestingScopeHandle[]>;
2819
2844
  waitFor(ms?: number): Promise<void>;
2820
2845
  $(selector: string): Promise<HeadlessTestingNodeHandle | null>;
2821
2846
  $$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
2847
+ getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
2822
2848
  renderedNodes(selector: string, options?: HeadlessTestingPageQueryOptions): Promise<HeadlessTestingRenderedNodeSnapshot[]>;
2823
2849
  renderedSelectorNodes(selectors: string[], options?: HeadlessTestingPageQueryOptions): Promise<HeadlessTestingRenderedSelectorNodesSnapshot>;
2824
2850
  waitForRendered(options?: HeadlessTestingRenderedOptions): Promise<string>;
@@ -2933,10 +2959,13 @@ export declare class HeadlessTestingSessionHandle {
2933
2959
  switchTab(route: string): Promise<HeadlessTestingPageHandle>;
2934
2960
  waitForCurrentPage(route?: string, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingPageHandle>;
2935
2961
  pageScrollTo(scrollTop: number): Promise<void>;
2962
+ triggerAppHide(options: HeadlessWxAppHideOptions): Promise<void>;
2963
+ triggerAppShow(options?: HeadlessWxLaunchOptions): Promise<void>;
2936
2964
  triggerPullDownRefresh(): Promise<void>;
2937
2965
  triggerReachBottom(): Promise<void>;
2938
2966
  triggerResize(options: Record<string, any>): Promise<void>;
2939
2967
  triggerRouteDone(options?: Record<string, any>): Promise<void>;
2968
+ private invokeNavigation;
2940
2969
  private requireCurrentPage;
2941
2970
  private evaluateInRuntime;
2942
2971
  }
@@ -2944,7 +2973,9 @@ export declare class HeadlessTestingSessionHandle {
2944
2973
  //#region src/testing/launch.d.ts
2945
2974
  export interface HeadlessTestingLaunchOptions {
2946
2975
  projectPath: string;
2976
+ configureSession?: (session: HeadlessSession) => void | Promise<void>;
2977
+ onSessionCreated?: (session: HeadlessTestingSessionHandle) => void | Promise<void>;
2947
2978
  }
2948
2979
  export declare function launch(options: HeadlessTestingLaunchOptions): Promise<HeadlessTestingSessionHandle>;
2949
2980
  //#endregion
2950
- export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingToolInfo, RuntimeRenderedPageTree, RuntimeRendererContext };
2981
+ export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingToolInfo, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };