@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 +23 -0
- package/dist/index.d.mts +111 -31
- package/dist/index.mjs +1155 -335
- package/package.json +4 -3
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:
|
|
1069
|
-
offAppRouteDone: (listener?: (event:
|
|
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/
|
|
1422
|
-
interface
|
|
1423
|
-
|
|
1424
|
-
|
|
1425
|
-
|
|
1426
|
-
|
|
1427
|
-
|
|
1428
|
-
|
|
1429
|
-
|
|
1430
|
-
|
|
1431
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
3134
|
+
private readonly navigation;
|
|
3135
|
+
private disconnection?;
|
|
3136
|
+
private cdp?;
|
|
3064
3137
|
constructor(project: HeadlessProjectDescriptor, session: HeadlessSession);
|
|
3065
3138
|
close(): Promise<void>;
|
|
3066
|
-
/**
|
|
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 };
|