@mpcore/simulator 1.0.0 → 1.1.0

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,6 +12,9 @@
12
12
  - 提供测试节点句柄上的 `tap()`、`trigger()`、`input()`、`change()`、`blur()` 交互辅助方法
13
13
  - 提供测试页面/会话句柄上的 `waitForSelector()`、`waitForText()`、`waitForTextGone()`、`waitForData()`、`waitForCurrentPage()` 等轮询等待方法
14
14
  - 测试会话句柄提供与 `miniprogram-automator` 对齐的 `toolInfo()`,headless provider 返回稳定的 simulator 标识
15
+ - Node/browser session 的 `reloadPageDefinition(route)` 显式更新已加载页面的入口定义,返回源码字节是否变化;测试会话句柄返回 `Promise<boolean>`。它保留 App、当前页面和共享依赖缓存,不自动导航;需要新页面时再调用 `reLaunch()`。失败会恢复模块缓存及注册表,但不会撤销业务脚本已经执行的任意副作用。普通导航不自动重载脚本。
16
+ - Node/browser session 与测试 `launch()` 接受 `compiledTemplatePaths`,声明相对小程序根目录的编译 WXML 输出。创建会话时冻结这些模板及递归 `import/include` 依赖,形成全局注册图;原生模板引用同一依赖时也读取该依赖的注册版本,图外的原生 WXML 仍实时读取。普通查询、数据更新、脚本重载和导航都不会提交新模板。`reloadTemplates()` 显式提交整批新版本,返回是否变化,测试句柄返回 `Promise<boolean>`;缺失任意模板或依赖路径超出小程序根目录时保留整批旧版本和 WXS 缓存。成功提交新版本后清除本会话的 WXS 缓存,内联 WXS 随新模板重新加载。它保留当前页面、组件及 App 实例,适合由宿主注册生命周期调用;classic 重启可通过新建会话重新注册模板。
17
+ - `disconnect()` 同步开始释放独占运行时并返回可等待的 Promise;并发、重入与后续调用共享关闭结果,关闭失败会保留在该 Promise 中
15
18
  - 提供原生形状的 `wx.onAppShow/offAppShow/onAppHide/offAppHide`;Node/browser session 与测试句柄通过 `triggerAppShow(options?)`、`triggerAppHide({ reason })` 显式驱动应用前后台事件,普通页面导航不会伪造应用切换
16
19
  - 测试入口 `launch({ configureSession })` 会在执行 `app.js` 前等待配置完成,可安装测试宿主能力;配置失败会关闭会话,默认 request 仍受既有 mock / strict mock 策略约束,不自动开放真实网络
17
20
  - 通过共享 `RuntimeKernel` 管理 artifact、独立执行 realm、timer、diagnostics 与平台适配边界
@@ -21,6 +24,12 @@
21
24
 
22
25
  应用首次启动只执行一次 `onLaunch`,并在首页加载前发送应用显示事件。后续 `triggerAppShow` 更新 enter options,不改写 launch options;隐藏原因显式限定为 `0 | 1 | 2 | 3`。关闭会话会清理应用事件监听,不合成额外的隐藏事件。这里定义的是可测试的 simulator 行为,不代表已验证真实微信 IDE 中 App hook 与 `wx` 监听器之间的相对调用顺序。
23
26
 
27
+ 测试会话的 `send(method, params?, { timeout }?)` 提供协议子集:`Tool.getInfo`、`App.getCurrentPage`、`App.getPageStack`、`App.callFunction`、`App.callWxMethod`。页面响应沿用 `{ pageId, path, query }`,调用响应沿用 `{ result }`,复用同一运行时与页面身份;关闭会话会拒绝尚未完成的协议请求。其他协议会抛出带 `code: 'HEADLESS_PROTOCOL_UNSUPPORTED'` 与 `method` 的错误。
28
+
29
+ `CDP()` 保留 `enable`、`sendCommand`、`listProtocol`、`onEvent` 的类型形状。当前 headless 后端不提供 CDP:启用和命令调用会拒绝,`onEvent` 同步抛出不支持错误;这些错误均带 `code: 'HEADLESS_PROTOCOL_UNSUPPORTED'`。不会产生模拟的 V8 协议、堆内存、事件或调试器数据。
30
+
31
+ 节点句柄的 `touchstart`、`touchmove`、`touchend` 以及 `dispatchEvent({ eventName, $?, ...event })` 经过共享事件链调用真实页面或组件处理器,保留 `touches` 和 `changedTouches`。`$` 可选择当前节点内的后代节点。旧字段 `changeTouches` 作为弃用别名接收;两者同时存在时 `changedTouches` 优先,处理器只收到正确字段。
32
+
24
33
  浏览器会话的 `renderCurrentPage().styles` 提供当前页面的 `cssText`、项目相对 `dependencies` 和 `appWxssEnabled`,Web demo 将该结果挂载到页面预览的 Shadow DOM。解析器读取 `app.wxss`、页面 `.wxss` 及递归本地 `@import`,保留导入位置和全局在前、页面在后的层叠顺序;页面 `.wxss` 内联的全局样式快照也会动态加载,并保留其后页面自有样式的覆盖优先级。文件修改后重新渲染会读取最新内容,包括只更新样式的场景,不重建页面或 App 实例。
25
34
 
26
35
  此入口只负责页面样式依赖和 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` 导入条件不受支持,也不会触发外部请求。
@@ -61,6 +70,20 @@ Node/browser 宿主提供 `BeforeAppRoute`、`BeforePageUnload`、`AppRoute`、`
61
70
 
62
71
  上述默认、仅捕获、局部冒泡、跨组件冒泡与宿主两种 catch 边界已对照微信开发者工具稳定版 `2.02.2608080`,并覆盖同一 issue runtime suite 的 headless provider 和实际浏览器预览。此对照不扩展为原生 tap、scroll、video 的捕获支持,也不表示已验证同节点 Vue 内联捕获/冒泡处理函数的编译语义。
63
72
 
73
+ ## 原生表单提交与富文本
74
+
75
+ Node/browser 的原生 tap 到达未禁用的 `button form-type="submit"` 时,在 tap 回调之后提交最近的参与表单。提交目标、字段值与方法所有者在回调前固定;组件销毁、重渲染或同路由重建不会把提交转交给新实例。`tap()` 等待 tap 与 submit 的异步处理,继续传递结果或错误。普通插槽按声明归属参与;跨私有组件边界的按钮需要 `wx://form-field-button`,原生字段分组需要 `wx://form-field-group`。WXML 按 XML 节点结构解析,不应用 HTML 对嵌套 `form` 的隐式修复。
76
+
77
+ 后续监听器同步抛错时,测试句柄仍观察并等待此前已启动的异步处理。只有该同步错误时原样抛出;异步处理也失败时,抛出包含全部已收集失败的 `AggregateError`,并以原同步错误作为 `cause`,避免遗留未处理的 Promise 拒绝。
78
+
79
+ `submit.detail.value` 来自参与表单的具名原生控件当前渲染绑定,包含 input/textarea、switch、slider、picker、radio-group 与 checkbox-group;picker 数组保留原始绑定类型,不从逗号字符串猜测值。此能力不补齐未绑定输入的宿主状态、`wx://form-field` 自定义值导出、reset 或真实 `formId` 上报,也不把任意页面数据当作原生字段值。
80
+
81
+ `rich-text` 的结构化 `nodes` 与 HTML 字符串通过 `@weapp-core/shared/rich-text` 的共同安全规则生成实际渲染子树,支持更新和清空。内容不会再次解释为 WXML 表达式、事件或自定义组件;外部内容不能伪造 `data-sim-*` 元数据。通用 `text()`、快照和序列化观察同一份渲染内容,`attr('nodes')` 仍是既有字符串属性,不是结构化属性 API。富文本内部不获得 WXML 声明作用域;需要检查内部渲染节点时使用 XPath,而不是放宽声明作用域内的 CSS 查询。
82
+
83
+ 浏览器预览取消富文本链接的普通/辅助点击导航和 HTML 表单默认提交;业务 tap 与原生表单动作仍由模拟器分发,不能让浏览器额外导航或再次提交。
84
+
85
+ 上述能力属于模拟器模型,不代表真实微信 IDE 或设备验收。
86
+
64
87
  ## 分块请求 mock
65
88
 
66
89
  `session.mockRequest()` 支持为 `enableChunked: true` 的请求声明分块,默认仍不访问网络:
package/dist/index.d.mts CHANGED
@@ -1054,6 +1054,8 @@ export interface HeadlessWxRouteEvent {
1054
1054
  routeEventId: string;
1055
1055
  timeStamp: number;
1056
1056
  }
1057
+ /** 路由动画完成只提供路由身份,不携带接受路由时的渲染引擎字段。 */
1058
+ export type HeadlessWxRouteDoneEvent = Omit<HeadlessWxRouteEvent, 'renderer'>;
1057
1059
  /** 页面销毁前的原生实例,仍可同步读取页面数据。 */
1058
1060
  export interface HeadlessWxBeforePageUnloadEvent extends HeadlessWxRouteEvent {
1059
1061
  page: HeadlessPageInstance;
@@ -1065,8 +1067,8 @@ export interface HeadlessWxRouteListeners {
1065
1067
  offBeforePageUnload: (listener?: (event: HeadlessWxBeforePageUnloadEvent) => void) => void;
1066
1068
  onAppRoute: (listener: (event: HeadlessWxRouteEvent) => void) => void;
1067
1069
  offAppRoute: (listener?: (event: HeadlessWxRouteEvent) => void) => void;
1068
- onAppRouteDone: (listener: (event: HeadlessWxRouteEvent) => void) => void;
1069
- offAppRouteDone: (listener?: (event: HeadlessWxRouteEvent) => void) => void;
1070
+ onAppRouteDone: (listener: (event: HeadlessWxRouteDoneEvent) => void) => void;
1071
+ offAppRouteDone: (listener?: (event: HeadlessWxRouteDoneEvent) => void) => void;
1070
1072
  }
1071
1073
  export interface HeadlessWxDriver extends HeadlessWxDriverCapabilities, HeadlessWxRouteListeners {
1072
1074
  chooseImage: (option: HeadlessWxChooseImageOption) => HeadlessWxChooseImageResult;
@@ -1240,6 +1242,7 @@ export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsol
1240
1242
  //#endregion
1241
1243
  //#region src/kernel/artifactSource.d.ts
1242
1244
  export interface ArtifactSource {
1245
+ /** 判断产物文件是否存在,目录不属于产物。 */
1243
1246
  has: (filePath: string) => boolean;
1244
1247
  readText: (filePath: string) => string | undefined;
1245
1248
  }
@@ -1399,6 +1402,7 @@ export interface BrowserModuleLoader {
1399
1402
  executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
1400
1403
  executeAppModule: (filePath: string) => HeadlessAppDefinition;
1401
1404
  executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
1405
+ reloadPageModule: (filePath: string, route: string) => boolean;
1402
1406
  wx: HeadlessWx;
1403
1407
  }
1404
1408
  export declare function createBrowserModuleLoader(files: BrowserVirtualFiles, registries: HeadlessHostRegistries, getCurrentPages: () => any[], getApp: () => any, wxDriver: Parameters<typeof createHeadlessWx>[0], options: {
@@ -1418,17 +1422,21 @@ export interface CreateBrowserProjectOptions {
1418
1422
  }
1419
1423
  export declare function createBrowserProject(files: BrowserVirtualFiles, options?: CreateBrowserProjectOptions): HeadlessProjectDescriptor;
1420
1424
  //#endregion
1421
- //#region src/view/nodeHandle.d.ts
1422
- interface DomNodeLike$5 {
1423
- attribs?: Record<string, string>;
1424
- children?: DomNodeLike$5[];
1425
- data?: string;
1426
- dataset?: Record<string, unknown>;
1427
- name?: string;
1428
- parent?: DomNodeLike$5 | null;
1429
- type?: string;
1430
- }
1431
- export interface HeadlessTestingNodeEventInit {
1425
+ //#region src/view/nodeEvents.d.ts
1426
+ interface HeadlessTestingTouch {
1427
+ identifier?: number;
1428
+ pageX?: number;
1429
+ pageY?: number;
1430
+ clientX?: number;
1431
+ clientY?: number;
1432
+ }
1433
+ interface HeadlessTestingTouchEventInit {
1434
+ touches?: HeadlessTestingTouch[];
1435
+ changedTouches?: HeadlessTestingTouch[];
1436
+ /** @deprecated 请改用与微信事件一致的 changedTouches。 */
1437
+ changeTouches?: HeadlessTestingTouch[];
1438
+ }
1439
+ interface HeadlessTestingNodeEventInit extends HeadlessTestingTouchEventInit {
1432
1440
  currentTarget?: {
1433
1441
  dataset?: Record<string, unknown>;
1434
1442
  id?: string;
@@ -1442,12 +1450,27 @@ export interface HeadlessTestingNodeEventInit {
1442
1450
  id?: string;
1443
1451
  };
1444
1452
  }
1445
- export interface HeadlessTestingNodeValueEventInit extends HeadlessTestingNodeEventInit {
1453
+ interface HeadlessTestingNodeValueEventInit extends HeadlessTestingNodeEventInit {
1446
1454
  detail?: {
1447
1455
  value?: string;
1448
1456
  [key: string]: unknown;
1449
1457
  };
1450
1458
  }
1459
+ interface HeadlessTestingDispatchEventInit extends HeadlessTestingNodeEventInit {
1460
+ eventName: string;
1461
+ $?: string;
1462
+ }
1463
+ //#endregion
1464
+ //#region src/view/nodeHandle.d.ts
1465
+ interface DomNodeLike$5 {
1466
+ attribs?: Record<string, string>;
1467
+ children?: DomNodeLike$5[];
1468
+ data?: string;
1469
+ dataset?: Record<string, unknown>;
1470
+ name?: string;
1471
+ parent?: DomNodeLike$5 | null;
1472
+ type?: string;
1473
+ }
1451
1474
  interface HeadlessTestingNodeInteractionHandlers {
1452
1475
  assertActive?: () => void;
1453
1476
  callMethod: (scopeId: string | null, methodName: string, event: Record<string, any>) => unknown;
@@ -1496,6 +1519,10 @@ export declare class HeadlessTestingNodeHandle {
1496
1519
  tagName(): Promise<string | undefined>;
1497
1520
  trigger(eventName: string, event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1498
1521
  tap(event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1522
+ touchstart(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
1523
+ touchmove(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
1524
+ touchend(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
1525
+ dispatchEvent({ eventName, $: selector, ...event }: HeadlessTestingDispatchEventInit): Promise<unknown>;
1499
1526
  input(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1500
1527
  change(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1501
1528
  blur(value?: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
@@ -1532,6 +1559,20 @@ export declare function createMiniProgramEventPayload(node: {
1532
1559
  };
1533
1560
  timeStamp: number;
1534
1561
  type: string;
1562
+ changedTouches?: {
1563
+ identifier?: number;
1564
+ pageX?: number;
1565
+ pageY?: number;
1566
+ clientX?: number;
1567
+ clientY?: number;
1568
+ }[] | undefined;
1569
+ touches?: {
1570
+ identifier?: number;
1571
+ pageX?: number;
1572
+ pageY?: number;
1573
+ clientX?: number;
1574
+ clientY?: number;
1575
+ }[] | undefined;
1535
1576
  };
1536
1577
  //#endregion
1537
1578
  //#region src/view/wxs.d.ts
@@ -1614,6 +1655,7 @@ interface BrowserRendererContext {
1614
1655
  componentCache: Map<string, HeadlessComponentInstance>;
1615
1656
  componentScopes: Map<string, BrowserRenderScope>;
1616
1657
  files: BrowserVirtualFiles;
1658
+ templateSource?: Pick<ArtifactSource, 'readText'>;
1617
1659
  moduleLoader: BrowserModuleLoader;
1618
1660
  project: HeadlessProjectDescriptor;
1619
1661
  session: {
@@ -1642,6 +1684,7 @@ interface HeadlessModuleLoader {
1642
1684
  executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
1643
1685
  executeAppModule: (filePath: string) => HeadlessAppDefinition;
1644
1686
  executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
1687
+ reloadPageModule: (filePath: string, route: string) => boolean;
1645
1688
  wx: HeadlessWx;
1646
1689
  }
1647
1690
  //#endregion
@@ -2106,6 +2149,8 @@ export declare function createHeadlessWxState(scheduler?: Pick<RuntimeScheduler,
2106
2149
  //#endregion
2107
2150
  //#region src/runtime/session.d.ts
2108
2151
  export interface HeadlessSessionOptions {
2152
+ /** 相对小程序根目录的编译模板路径;仅在显式宿主重载时提交新版本。 */
2153
+ compiledTemplatePaths?: readonly string[];
2109
2154
  globals?: Record<string, unknown>;
2110
2155
  project?: HeadlessProjectDescriptor;
2111
2156
  projectPath?: string;
@@ -2119,6 +2164,7 @@ export declare class HeadlessSession {
2119
2164
  private appInstance;
2120
2165
  private readonly appLifecycle;
2121
2166
  private readonly moduleLoader;
2167
+ private readonly templateRegistration;
2122
2168
  private readonly routeEvents;
2123
2169
  private readonly eventListeners;
2124
2170
  private readonly registries;
@@ -2127,8 +2173,7 @@ export declare class HeadlessSession {
2127
2173
  private readonly componentCache;
2128
2174
  private readonly componentScopes;
2129
2175
  private readonly selectorQueryScopeSnapshots;
2130
- private renderRequestPending;
2131
- private readonly renderRequestCallbacks;
2176
+ private readonly renderQueue;
2132
2177
  private readonly tabBarRoutes;
2133
2178
  private readonly tabPages;
2134
2179
  private readonly tabBarItems;
@@ -2151,6 +2196,10 @@ export declare class HeadlessSession {
2151
2196
  get isClosed(): boolean;
2152
2197
  getApp(): HeadlessAppInstance | null;
2153
2198
  getCurrentPages(): HeadlessPageInstance[];
2199
+ /** 显式重载已变更的页面 entry,保留 App 与依赖缓存;调用者随后自行导航。 */
2200
+ reloadPageDefinition(route: string): boolean;
2201
+ /** 显式提交编译模板及其 import/include 依赖;不重载脚本、不导航或替换实例。 */
2202
+ reloadTemplates(): boolean;
2154
2203
  getWx(): HeadlessWx;
2155
2204
  /** 在当前小程序实例的上下文执行测试函数,复用应用全局对象与调度器。 */
2156
2205
  evaluateRuntime<T = unknown>(source: string, args?: any[]): T;
@@ -2468,6 +2517,8 @@ export declare function createHeadlessSession(options: HeadlessSessionOptions):
2468
2517
  //#endregion
2469
2518
  //#region src/browser/session.d.ts
2470
2519
  export interface BrowserHeadlessSessionOptions {
2520
+ /** 相对小程序根目录的编译模板路径;仅在显式宿主重载时提交新版本。 */
2521
+ compiledTemplatePaths?: readonly string[];
2471
2522
  files: BrowserVirtualFiles;
2472
2523
  globals?: Record<string, unknown>;
2473
2524
  /** 返回的 Promise 表示宿主 DOM 已提交;普通返回值按同步渲染处理。 */
@@ -2482,6 +2533,7 @@ export declare class BrowserHeadlessSession {
2482
2533
  private appInstance;
2483
2534
  private readonly appLifecycle;
2484
2535
  private readonly moduleLoader;
2536
+ private readonly templateRegistration;
2485
2537
  private readonly onRender?;
2486
2538
  private readonly registries;
2487
2539
  private currentPageInstance;
@@ -2489,9 +2541,7 @@ export declare class BrowserHeadlessSession {
2489
2541
  private readonly componentCache;
2490
2542
  private readonly componentScopes;
2491
2543
  private readonly selectorQueryScopeSnapshots;
2492
- private renderRequestPending;
2493
- private renderInProgress;
2494
- private readonly renderRequestCallbacks;
2544
+ private readonly renderQueue;
2495
2545
  private readonly tabBarRoutes;
2496
2546
  private readonly tabPages;
2497
2547
  private readonly tabBarItems;
@@ -2514,6 +2564,10 @@ export declare class BrowserHeadlessSession {
2514
2564
  get isClosed(): boolean;
2515
2565
  getApp(): HeadlessAppInstance | null;
2516
2566
  getCurrentPages(): HeadlessPageInstance[];
2567
+ /** 显式重载已变更的页面 entry,保留 App 与依赖缓存;调用者随后自行导航。 */
2568
+ reloadPageDefinition(route: string): boolean;
2569
+ /** 显式提交编译模板及其 import/include 依赖;不重载脚本、不导航或替换实例。 */
2570
+ reloadTemplates(): boolean;
2517
2571
  getCurrentPageNavigationBarTitle(): string | null;
2518
2572
  getCurrentPageNavigationBar(): {
2519
2573
  animation: {
@@ -3003,6 +3057,30 @@ export declare class HeadlessTestingPageHandle {
3003
3057
  private waitAccess;
3004
3058
  }
3005
3059
  //#endregion
3060
+ //#region src/testing/sessionHandle/protocol.d.ts
3061
+ interface HeadlessTestingProtocolOptions {
3062
+ timeout?: number;
3063
+ }
3064
+ type HeadlessTestingEvaluator<T = unknown> = ((...args: any[]) => T | PromiseLike<T>) | string;
3065
+ interface HeadlessTestingToolInfo {
3066
+ version: 'mpcore-simulator';
3067
+ }
3068
+ /** 无头协议只公布已有运行时语义;不把宿主缺失能力伪装为调试器结果。 */
3069
+ export declare class HeadlessTestingProtocolUnsupportedError extends Error {
3070
+ readonly method: string;
3071
+ readonly code = "HEADLESS_PROTOCOL_UNSUPPORTED";
3072
+ constructor(method: string);
3073
+ }
3074
+ //#endregion
3075
+ //#region src/testing/sessionHandle/cdp.d.ts
3076
+ type HeadlessTestingCDPEventListener = (domain: string, event: string, params: unknown) => void;
3077
+ interface HeadlessTestingCDP {
3078
+ enable: (options?: HeadlessTestingProtocolOptions) => Promise<unknown>;
3079
+ sendCommand: <T = unknown>(domain: string, method: string, params?: Record<string, unknown>, options?: HeadlessTestingProtocolOptions) => Promise<T>;
3080
+ listProtocol: <T = unknown>(options?: HeadlessTestingProtocolOptions) => Promise<T>;
3081
+ onEvent: (listener: HeadlessTestingCDPEventListener) => () => void;
3082
+ }
3083
+ //#endregion
3006
3084
  //#region src/testing/sessionHandle/scope.d.ts
3007
3085
  export declare class HeadlessTestingScopeHandle {
3008
3086
  readonly scopeId: string;
@@ -3050,21 +3128,18 @@ export declare class HeadlessTestingScopeHandle {
3050
3128
  }
3051
3129
  //#endregion
3052
3130
  //#region src/testing/sessionHandle/index.d.ts
3053
- interface HeadlessTestingProtocolOptions {
3054
- timeout?: number;
3055
- }
3056
- type HeadlessTestingEvaluator<T = unknown> = ((...args: any[]) => T | PromiseLike<T>) | string;
3057
- interface HeadlessTestingToolInfo {
3058
- version: 'mpcore-simulator';
3059
- }
3060
3131
  export declare class HeadlessTestingSessionHandle {
3061
3132
  private readonly project;
3062
3133
  private readonly session;
3063
- private readonly pendingNavigations;
3134
+ private readonly navigation;
3135
+ private disconnection?;
3136
+ private cdp?;
3064
3137
  constructor(project: HeadlessProjectDescriptor, session: HeadlessSession);
3065
3138
  close(): Promise<void>;
3066
- /** 无头会话独占本地 runtime;同步释放与 automator 的连接清理契约一致。 */
3067
- disconnect(): void;
3139
+ /** 先保存共享结果,再同步开始关闭,覆盖关闭监听器内的重入调用。 */
3140
+ disconnect(): Promise<void>;
3141
+ send<T = unknown>(method: string, params?: Record<string, unknown>, options?: HeadlessTestingProtocolOptions): Promise<T>;
3142
+ CDP(): HeadlessTestingCDP;
3068
3143
  toolInfo(): Promise<HeadlessTestingToolInfo>;
3069
3144
  on(eventName: string, handler: (...args: any[]) => void): this;
3070
3145
  removeListener(eventName: string, handler: (...args: any[]) => void): this;
@@ -3101,6 +3176,10 @@ export declare class HeadlessTestingSessionHandle {
3101
3176
  waitForComponent(selector: string, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingScopeHandle>;
3102
3177
  waitForComponents(selector: string, count?: number, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingScopeHandle[]>;
3103
3178
  reLaunch(route: string): Promise<HeadlessTestingPageHandle>;
3179
+ /** 只更新页面定义;不隐式导航,也不替换当前页面或应用实例。 */
3180
+ reloadPageDefinition(route: string): Promise<boolean>;
3181
+ /** 显式提交宿主编译模板;不隐式重载脚本或导航。 */
3182
+ reloadTemplates(): Promise<boolean>;
3104
3183
  navigateTo(route: string): Promise<HeadlessTestingPageHandle>;
3105
3184
  redirectTo(route: string): Promise<HeadlessTestingPageHandle>;
3106
3185
  navigateBack(delta?: number): Promise<HeadlessTestingPageHandle | null>;
@@ -3113,17 +3192,18 @@ export declare class HeadlessTestingSessionHandle {
3113
3192
  triggerReachBottom(): Promise<void>;
3114
3193
  triggerResize(options: Record<string, any>): Promise<void>;
3115
3194
  triggerRouteDone(options?: Record<string, any>): Promise<void>;
3116
- private invokeNavigation;
3117
3195
  private requireCurrentPage;
3118
3196
  private evaluateInRuntime;
3119
3197
  }
3120
3198
  //#endregion
3121
3199
  //#region src/testing/launch.d.ts
3122
3200
  export interface HeadlessTestingLaunchOptions {
3201
+ /** 相对小程序根目录的编译模板路径;普通查询不得提交尚未注册的模板。 */
3202
+ compiledTemplatePaths?: readonly string[];
3123
3203
  projectPath: string;
3124
3204
  configureSession?: (session: HeadlessSession) => void | Promise<void>;
3125
3205
  onSessionCreated?: (session: HeadlessTestingSessionHandle) => void | Promise<void>;
3126
3206
  }
3127
3207
  export declare function launch(options: HeadlessTestingLaunchOptions): Promise<HeadlessTestingSessionHandle>;
3128
3208
  //#endregion
3129
- export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingToolInfo, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };
3209
+ export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingCDP, HeadlessTestingCDPEventListener, HeadlessTestingDispatchEventInit, HeadlessTestingEvaluator, HeadlessTestingNodeEventInit, HeadlessTestingNodeValueEventInit, HeadlessTestingProtocolOptions, HeadlessTestingToolInfo, HeadlessTestingTouch, HeadlessTestingTouchEventInit, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };