# Api-Switch

**Repository Path**: yanwuhc/api-swicth

## Basic Information

- **Project Name**: Api-Switch
- **Description**: 一款轻量高效的 Chrome 浏览器插件，支持拦截网页请求、自定义 API 地址转发、URL 路由重定向，可快速切换开发 / 测试 / 线上接口，一键修改请求域名与路径，极大提升前端调试、接口联调、本地代理开发效率，开箱即用，配置简单。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# API请求记录器 - Chrome扩展

记录浏览器中的HTTP请求，支持修改URL前缀后一键重发。面向后端和前端开发者的调试工具。

## 功能

- **自动记录请求**：自动捕获页面中的所有 XHR / Fetch 请求
- **常用地址管理**：预设本地开发地址（如 `http://localhost:8080`），点击即可替换到请求中
- **请求类型过滤**：按 HTTP Method（GET / POST / PUT / DELETE 等）多选过滤，只看你关心的类型
- **URL前缀替换**：展开任意请求，修改 URL 前缀即可切换到另一个环境重发
- **请求头编辑**：查看、修改、新增请求头（Token、Content-Type 等）
- **请求体查看**：自动捕获 JSON / FormData 请求体并回填，可编辑后重发
- **一键重发**：修改完毕后点击发送，直接看到响应结果（自动格式化 JSON）
- **本地存储**：所有数据仅保存在浏览器本地 `chrome.storage.local`，关闭页面不丢失

## 安装

### 从源码加载（开发者模式）

1. 下载本仓库代码到本地
2. 打开 Chrome 浏览器，访问 `chrome://extensions/`
3. 开启右上角的 **开发者模式**
4. 点击 **加载已解压的扩展程序**
5. 选择本项目所在的文件夹

### 从 Chrome Web Store（待上架）

*暂未上架*

## 快速上手

1. 打开你的测试系统或任意网页，正常操作触发 API 请求
2. 点击 Chrome 工具栏中的扩展图标，打开插件面板
3. 在 **常用地址** 区域添加你的本地地址（如 `http://localhost:3000`）
4. 在请求列表中找到你要调试的接口，点击展开
5. 修改 URL 前缀、请求头、请求体
6. 点击 **发送请求**，查看响应结果

## 项目结构

```
api-interrupt-extension/
├── manifest.json          # 扩展配置文件
├── background.js          # 后台脚本：请求监听、存储、重发
├── popup.html             # 弹出面板 UI
├── popup.js               # 面板交互逻辑
└── icons/                 # 扩展图标
    ├── api_16x16.png
    ├── api_32x32.png
    ├── api_48x48.png
    └── api_128x128.png
```

## 权限说明

本扩展需要以下权限：

| 权限 | 用途 |
|------|------|
| `webRequest` | 监听和记录浏览器发出的 HTTP 请求 |
| `storage` | 保存请求记录、常用地址、过滤偏好到本地 |
| `activeTab` | 在弹出面板中与当前页面交互 |
| `<all_urls>` | 捕获所有域名的 XHR / Fetch 请求 |

**所有数据仅存储在用户本地，不会上传到任何远程服务器。**

## 隐私声明

- 本扩展**不会**收集、上传或分享任何用户数据
- 所有捕获的请求信息（URL、Headers、Body）仅保存在浏览器本地存储中
- 用户可以随时通过 **清空记录** 按钮删除所有已保存数据
- 扩展不会拦截或修改页面中的正常请求，只做记录

## 常见问题

**Q: 为什么有些请求没有记录？**
A: 本扩展只记录 `XHR` 和 `Fetch` 类型的请求，页面导航、图片加载等不会记录。

**Q: 请求体为什么是空的？**
A: 某些浏览器的隐私限制可能导致无法捕获请求体，特别是跨域请求。这是浏览器的安全机制。

**Q: 最多能记录多少条请求？**
A: 最多记录 100 条，超出后自动丢弃最早的记录。

## License

MIT