用 REA 静态拆解本地 JavaScript 工件:从一个 fetch 调用追到输出节点
以一个四文件本地 JavaScript 样例为输入,展示 REA 静态分析如何识别模块导入、字面量 endpoint 与 DOM 输出关系,并明确哪些运行时行为仍需另行验证。

接手一段陌生的前端代码时,第一件事往往不是把它跑起来。你可能只想知道刷新按钮会指向哪个接口、响应会经过哪个格式化函数、页面最终改了哪里。在不启动应用的前提下,静态分析可以先给出一条可核对的源码路径,再把真正需要运行环境确认的问题留在后面。
本文用一个自编的四文件 JavaScript 样例演示这个过程。我们让 REA 读取本地文件,没有执行 JavaScript、没有请求网络,也没有分析第三方应用。结果把 fetch("/api/build-status") 定位到 app.js 的精确位置,并把它和响应解析、格式化函数及 #status DOM 输出串在一起。样例与完整静态证据已打包:下载本次静态分析样例与证据包。ZIP 的 SHA-256 是 f8b531af6d639e2a7e37f3847232c16849d36aaaec2b7be6fb0a383a99036fc0。
样例从一个刷新按钮开始
压缩包里的 fixture/ 只有四个文件:index.html、app.js、format.js 与 package.json。页面把刷新按钮和状态输出节点交给 app.js,核心代码如下:
import { formatStatus } from "./format.js";
const refresh = document.querySelector("#refresh");
const output = document.querySelector("#status");
refresh.addEventListener("click", async () => {
const response = await fetch("/api/build-status");
const value = await response.json();
output.textContent = formatStatus(value);
});
format.js 只有一个导出:formatStatus(value) 返回 Build ${value.build}: ${value.status}。这个小样例故意把问题限制在一条固定 endpoint、一个 ESM import 和一次 DOM 更新上。它不是从线上项目复制的,也没有让 REA 对任何外部仓库或网页发起操作。
REA 的官方页面介绍以编码代理为入口检查软件工件,本文只使用了本地静态样例。
先看文件覆盖和模块关系
REA 返回的本次静态摘要中,relevant_files 是 4,parsed_javascript_files 是 2,parse_failures 是 0。也就是说,这次读取到的是压缩包中列出的完整样例范围,两个 JavaScript 文件都可解析,没有被解析错误截断。
进一步查看 app.js 的模块记录,分析器确认它是 ESM source module,存在 1 条 import relationship,指向本地 ./format.js。这比只搜索 formatStatus 多了一层可复核关系:读者可以回到 app.js 和 format.js,确认函数不是凭空假定来自同一文件。
| 本次观察 | 可追溯证据 |
|---|---|
| 工件范围 | 4 个相关文件,2 个 JavaScript 文件 |
| 解析结果 | 0 个解析失败 |
| 模块关系 | app.js 是 ESM 模块,含 1 条 import relationship |
| 格式化函数 | format.js 导出 formatStatus(value) |
| 覆盖边界 | application coverage 为 complete,semantic coverage 仍为 unknown,父证据中保留 22 个 semantic unknowns |
这里的 complete 只说明给定工件中的应用级文件清单已被覆盖。它不表示分析器知道所有动态分支、运行时对象属性或某次点击的真实结果。把覆盖范围和语义确定性分开记录,后续才知道该补源码阅读、测试还是运行日志。
从字面量 endpoint 追到输出节点
REA 的 endpoint 观察把 fetch("/api/build-status") 标为网络 endpoint,源码位置是 app.js:5:25-51。这一条是字面量字符串,因此静态分析可以直接给出 /api/build-status,无需猜测运行时会拼接出什么 URL。
同一份模块证据还能沿着代码文本说明后续处理:response.json() 读取响应值,formatStatus(value) 接收该值,结果写入 output.textContent;而 output 来自 document.querySelector("#status")。这给出了一个适合代码审查的静态链条:
click listener
-> fetch("/api/build-status")
-> response.json()
-> formatStatus(value)
-> #status.textContent
如果下一个任务是核对 API 响应是否符合页面所需字段,可以先从 formatStatus 看到它期望 build 与 status。再用真实或脱敏的响应样本检查结构,避免把“代码出现过一个属性名”误当成服务端已经返回了它。Trylog 的 API 响应结构差异检查 正好可以作为这一步的本地对照工具。
静态结果回答什么,留下什么
对这个工件,静态结果已经足以支持几项具体判断:存在一个 click listener;其中有固定的 /api/build-status fetch 字面量;app.js 引入并调用了 format.js 的格式化函数;源码把结果交给 #status 对应的节点。这些是源码文本和 AST 静态关系的观察结果。
它还没有回答更接近运行时的问题:页面加载时 #refresh 和 #status 是否存在,按钮是否真的被点击,endpoint 是否可达,服务端是否返回 JSON,返回值是否带有 build 和 status,以及浏览器会不会因认证、CORS 或错误响应而走向别的分支。本次证据明确写明 JavaScript 和 HTML 都按惰性文本解析,未执行 bundle bootstrap 或网络调用。
这种分界能帮助安排后续工作。先用静态证据确认应读哪些文件、接口字符串在哪里和输出点是什么;然后在隔离的运行环境里准备已知响应,记录实际请求、错误分支和 DOM 结果。静态链条和运行记录会相互补足,不能由其中一个替另一个下结论。
把 REA 放在本地工件排查的前半段
官方 REA 仓库 将它描述为帮助编码代理检查软件工件的工具。其 README 对 JavaScript/Electron 的说明是恢复模块及其关系,供后续解释、编写和测试实现。官方 安装文档 还列出静态 JavaScript CLI 检查可在 MCP 不可用时继续进行。
上游在 2026-10-18 发布了 rea-agents 6.7.0,可从 release 页面 查看发布内容。本次连接的 REA MCP 服务没有在这篇文章里被认定为该版本,因此不要把上游 release 号套到本次输出上。
对于一个本地工件,顺序可以保持简单:先固定要读取的文件和 hash,再取得模块、import、endpoint 与输出点的静态证据;需要确认真实行为时,才选择可控的环境运行最小样本。这样即使暂时没有服务端、账号或 GUI,也能先把阅读路径缩小到可核对的代码位置。
