Accept ADR 0003: handlers return fetch/after maps; the official bridge runs Promise/timer work and resumes via mq_call. Add fetch.mq.md demo. Co-authored-by: Cursor <cursoragent@cursor.com>
1.9 KiB
1.9 KiB
ADR 0003:浏览器异步 I/O(fetch / 定时)— 效应表 + 续体回调
| 状态 | Accepted |
| 日期 | 2026-09-01 |
| 决策者 | chaungming + 协作 |
| 相关 | 0002-browser-marqdo-wasm.md · browser-marqdo-wasm.md · roadmap/browser-wasm.md |
背景
Marqdo 调用面今日以同步为主。浏览器 fetch / setTimeout 是异步的;若在 WASM 里阻塞等待,会卡死 UI,且 wasm32-unknown-unknown 无真实阻塞 HTTP。
C3 已有:mq_call 返回 Map(如 set_text)由官方 bridge 执行。C4 在同一通道上扩展异步效应。
决策
- 不在语言内核引入 async/await 关键字或假同步
fetch。 - 处理器返回值可含效应字段(与
set_text并列),由 JS bridge 执行:fetch:{ url, method?, then, headers?, body? }after:{ ms, then }(定时续体)
- 异步完成后 bridge 调用
mq_call(then, payload):- fetch 成功/失败:
{ ok, status, body, error? } - after:
{ ok: true }
- fetch 成功/失败:
- 能力默认关网络语义仍由返回效应显式开启(站点作者主动返回
fetch);CORS / 鉴权仍是浏览器与服务端责任。 - 服务端
lib/net/plugins/web不变;本 ADR 仅浏览器 WASM 宿主。
后果
- 作者用表格/Map 声明「请求谁、完成后调谁」,无手写业务 JS。
- Bridge 必须串行处理效应(先
set_text,再调度fetch/after)。 - 深层 Promise 链靠多次
then回调;不在 C4 做通用 async 运行时。
否决
| 方案 | 原因 |
|---|---|
WASM 内同步阻塞 fetch |
卡死主线程;平台不支持 |
| 编译期把 Marqdo 译成 async JS | 回到路线 B |
在核心加 await 关键字 |
违反 Markup-as-Syntax / 关键字纪律 |