@mpcore/simulator 0.7.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,10 +24,30 @@
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` 导入条件不受支持,也不会触发外部请求。
27
36
 
37
+ ## 挂载期属性同步
38
+
39
+ Component 页面及普通组件的 `attached` 内调用 `setData` 时,Node/browser 宿主在调用返回前同步后代属性,包括未投影插槽声明和本次 `wx:if` 新建的子组件。同步绑定阶段不提前派发 `attached`、`detached` 或 `ready`;生命周期回到外层挂载事务处理,避免卸载回调中的写入重复触发卸载。
40
+
41
+ 同一父级写入对每个实例只消费一次,属性 observer 对自身值的修正不会被重入渲染反复覆盖;修正产生的后代属性更新先于本组件对应的 observer。以上边界已用微信开发者工具 `2.02.2608060`、基础库 `3.17.2` 对照直接子组件、关闭插槽、条件插入、数值修正和卸载写入场景,不扩展为真机或其他基础库的完整兼容承诺。
42
+
43
+ Node/browser 的挂载期绑定遍历共享页面级写入修订号。子组件 observer 再次更新 owner 时,旧遍历停止消费已复制的兄弟、循环与插槽声明作用域,并按最新数据恢复;构造期间暂缓的同步也会使旧遍历失效。恢复时复用已创建实例,不重复派发挂载生命周期。
44
+
45
+ 构造期 `created` 写入不会跳过初始属性交付。私有模板独立捕获当前修订并完成稳定遍历,保证默认子树先于宿主 `created`、后代属性先于宿主属性 observer;外层过期遍历仍停止消费旧作用域。
46
+
47
+ 挂载、就绪和关系刷新引起的遍历重启使用迭代,有限兄弟批次不会按组件数量累加调用栈。
48
+
49
+ 这里只同步逻辑绑定,不在每次写入时序列化 WXML、收集样式或提交宿主视图。既有异步视图提交与 `setData` 回调完成边界保持不变。
50
+
28
51
  ## 路由完成与滚动状态
29
52
 
30
53
  Node/browser 宿主提供 `BeforeAppRoute`、`BeforePageUnload`、`AppRoute`、`AppRouteDone` 四组 `wx.on/off` 事件;同一次导航共享字符串 `routeEventId`。前置事件发生在隐藏/卸载之前,完成事件等待目标页 ready 和该次宿主提交。模拟器通过显式事件能力标记接入,`SDKVersion` 仍为 `0.0.0`,不代表真实微信基础库或 Skyline 渲染器。
@@ -39,6 +62,28 @@ Node/browser 宿主提供 `BeforeAppRoute`、`BeforePageUnload`、`AppRoute`、`
39
62
 
40
63
  测试节点与真实预览点击共用原生 tap 分发:保留原始 `target`,逐层更新 `currentTarget`,遵守 `catchtap/catch:tap`,仅在事件到达 `navigator` 时执行其默认导航。一次交互先确定原始页面/组件归属,业务回调中的销毁、重新渲染或同路由重建不将剩余冒泡发送给新实例。测试节点 `tap()` 仍等待异步业务处理并传递结果或错误;导航的原生默认动作不等待异步业务 Promise。
41
64
 
65
+ 组件 `triggerEvent` 在 Node/browser 中共用声明树分发:默认只触发宿主直接绑定;`capturePhase: true` 按外到内执行捕获,`bubbles: true` 再按内到外冒泡,`composed: true` 才允许越过声明组件边界。普通视图与组件宿主均参与;`catch` 停止后续冒泡,`capture-catch` 同时阻止后续冒泡阶段。宿主与模板根即使合并渲染,仍保留各自的绑定和声明所有者。
66
+
67
+ 事件保留原始 `detail` 与源组件宿主的 `target.id/dataset`,各监听节点提供自己的 `currentTarget`。一次分发先固定路径和实例所有者,回调中的重渲染或移除不把剩余事件发送给新实例。公开 renderer context 的 `eventBindings` 仍保存原有 `{ method, stopAfter }` 冒泡绑定,捕获绑定独立存放于可选的 `captureEventBindings`。
68
+
69
+ 包根公开的 `collectMiniProgramEventBindings` 与 `resolveMiniProgramEventBinding` 继续返回 `{ method, stopAfter }` 冒泡绑定;只有捕获绑定时,公开 resolver 仍返回 `null`。内部的分阶段解析不会改变这些既有调用者的返回类型或优先级规则。
70
+
71
+ 上述默认、仅捕获、局部冒泡、跨组件冒泡与宿主两种 catch 边界已对照微信开发者工具稳定版 `2.02.2608080`,并覆盖同一 issue runtime suite 的 headless provider 和实际浏览器预览。此对照不扩展为原生 tap、scroll、video 的捕获支持,也不表示已验证同节点 Vue 内联捕获/冒泡处理函数的编译语义。
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
+
42
87
  ## 分块请求 mock
43
88
 
44
89
  `session.mockRequest()` 支持为 `enableChunked: true` 的请求声明分块,默认仍不访问网络:
@@ -58,3 +103,9 @@ session.mockRequest({
58
103
  顶层 `delay` 控制响应头阶段,每个分块的 `delay` 相对于前一个阶段。请求提供 `onHeadersReceived` / `offHeadersReceived`、`onChunkReceived` / `offChunkReceived`;不传回调的 off 方法移除全部对应监听。取消会停止后续分块并仅触发一次 `fail → complete`。可设置 `error` 模拟已发送分块后的连接失败。
59
104
 
60
105
  分块请求的 `success.data` 按已验证的微信 DevTools 行为返回空字符串;数据只通过 chunk 交付。未设置 `chunks` 时不会将普通 `response` 自动拆分。自定义 driver 仍可只实现 abort,公开监听方法类型为可选,使用前需检测能力。此模型不提供 Streams 或传输反压保证。
106
+
107
+ ## worker
108
+
109
+ Node 与浏览器 simulator 支持从编译产物创建 worker、CommonJS 依赖、双向消息复制、终止及会话关闭清理;每个 worker 拥有独立模块缓存、全局对象与计时器。配置沿用 `app.json.workers`,worker 分包支持 `preDownloadSubpackage({ packageType: 'workers' })`。
110
+
111
+ 当前对照场景覆盖首条消息、双向通信、页面重入与关闭后不再投递。simulator 使用确定性任务调度,不模拟真实并行线程性能、系统进程回收或实验性 worker 后端。