English | 简体中文
Easy Post 是一个运行在 VS Code 中的轻量 REST API 调试工作台。保留日常接口调试最常用的功能。
功能特性
请求编辑
- 支持
GET、POST、PUT、PATCH、DELETE、HEAD和OPTIONS。 - 使用可独立启停的键值行编辑 Query 参数和请求头。
- 支持
None、纯文本字段form-data、x-www-form-urlencoded和 JSON 请求体。 - 在发送 JSON 请求前校验格式，并自动补充
Content-Type: application/json。 - 支持
⌘/Ctrl + Enter快速发送、30 秒超时和主动取消。 - 请求与响应区域支持拖动调整大小，并在窄窗口中自动切换为上下布局。
环境与变量
- 创建多个本地环境，并为每个环境维护普通变量和敏感变量。
- 使用
{{variableName}}在 URL、Query、Headers 和 Body 中引用变量。 - 缺少变量时阻止发送，并明确列出未定义的变量名。
- 请求前和响应后脚本可以通过
ctx.env读取、更新或删除当前环境变量。
脚本
- 支持请求前脚本和响应后脚本。
- 脚本在 QuickJS WASM 隔离运行时中同步执行。
- 单次执行最长 500 ms，内存上限 16 MiB。
- 脚本无法访问 Node.js、文件系统、网络、
require、process或 VS Code API。 - 脚本日志可在响应区域的 Console 页签查看。
响应与本地记录
- 展示状态码、状态文本、耗时、响应大小和 Content-Type。
- 查看请求 Payload、请求/响应 Headers、格式化 JSON、文本正文和脚本日志。
- 响应正文最大读取 10 MiB，超过后停止读取并显示截断提示。
- 二进制响应仅显示类型和大小，不在编辑器中渲染。
- 收藏常用请求，并保留最近 100 条请求历史。
- VS Code 重启后恢复仍然打开的请求和环境面板。
快速开始
- 点击 Activity Bar 中的 Easy Post 图标。
- 点击“新建请求”，选择 HTTP 方法并填写完整 URL。
- 在 Params、Headers、Body 和 Scripts 页签中配置请求。
- 如需变量，打开“管理环境”并创建环境，然后通过
{{name}}引用变量。 - 点击“发送”，或在 URL 输入框中按
⌘/Ctrl + Enter。 - 在响应区域查看 Payload、Body、Headers 和 Console。
- 点击“保存请求”将当前请求加入收藏。
脚本 API
请求前脚本可以读取和修改环境及请求：
ctx.env.get("token");
ctx.env.set("token", "next-token");
ctx.env.unset("oldToken");
ctx.request.method = "POST";
ctx.request.url = "https://api.example.com/users";
ctx.request.query.set("page", "2");
ctx.request.headers.set("Authorization", "Bearer " + ctx.env.get("token"));
ctx.request.body = JSON.stringify({ name: "Easy Post" });
console.log("request prepared");
响应后脚本还可以读取响应：
console.log(ctx.response.status);
console.log(ctx.response.statusText);
console.log(ctx.response.headers.get("content-type"));
console.log(ctx.response.body);
const payload = ctx.response.json();
ctx.env.set("createdId", payload.id);
请求前脚本失败时不会发送请求；响应后脚本失败时响应仍会显示。失败脚本产生的环境修改不会保存。脚本修改环境变量时必须先选择一个环境。
数据与隐私
- 所有 HTTP 请求都由用户主动触发，并从本地 VS Code 扩展宿主直接发送到目标地址。
- 插件不采集遥测，不创建项目文件。
- 收藏、历史、环境和面板草稿保存在 VS Code 的扩展全局存储中。
- 标记为敏感的环境变量，以及
Authorization、Proxy-Authorization、Cookie、Set-Cookie、X-API-Key请求头，使用 VS CodeSecretStorage保存。 - 历史记录保存未展开的请求模板和响应摘要，不保存响应正文。
当前边界
- 仅支持 HTTP 和 HTTPS。
GET和HEAD不发送请求体。form-data仅支持文本字段，不支持文件上传。- 不支持 Postman Collection、
pm.*API、GraphQL 专用编辑器、Cookie Jar、代理和自定义证书。 - 不支持二进制响应预览或文件下载。
- 数据仅保存在本机，不提供账号、团队空间或云同步。
本地开发
推荐使用 Node.js 20.19+ LTS 或 22.12+ LTS。
npm install
npm run check
npm test
npm run build
在 VS Code 中按 F5 可启动 Extension Development Host。
生成可安装的 VSIX：
npm run package:vsix
产物位于 dist/easy-post.vsix。
参与贡献
欢迎通过 Issues 提交问题或功能建议，也欢迎向 GitHub 仓库 提交 Pull Request。