定制 Fiddler 之按设备过滤请求

需求

在开发/测试过程中有多台设备（PC/手机/模拟器）通过 Fiddler 代理上网时，如何方便地从满屏纷飞的 Session 中筛选出自己关心的那台设备的请求？

设想

通过 FiddlerScript 扩展，在 Session 的右键弹出菜单中添加一项，作为「查看所有设备请求」和「查看单个设备请求」的切换开关。

设计操作流程：

1. 找到自己关心的设备发出的某一条请求，在它的右键弹出菜单里有我们添加的菜单项「开/关过滤单设备请求」。

2. 点击该菜单项后：

   • 若当前状态为「查看所有设备请求」，则切换为「查看单个设备请求」状态，该设备为此条请求的发送者，并清除当前已显示的所有不关心的设备的请求。
   • 若当前状态为「查看单个设备请求」，则切换为「查看所有设备请求」状态。

实现

实现思路：

• 通过修改 CustomRules.js，在右键弹出菜单上添加一个菜单项来切换请求筛选状态。

• 每一条请求都带有 ClientIP，它在没有网络切换之类的情况发生时能较好地唯一标识一台设备。

• 筛选规则是将非来自该 ClientIP 的请求隐藏掉。

实现步骤：

1. 打开 CustomRules.js。

   启动Fiddler，依次选择菜单 Rules > Customize Rules…

2. 在 OnBeforeRequest 前添加如下代码：

   // 是否过滤单设备请求标志
   public static var gs_FilterDevice: boolean = false;
   // 显示请求的设备的 ClientIP
   public static var gs_FilterClientIP: String = null;
   
   static function IsUnMatchClientIP(oS:Session):Boolean {
       return (oS.m_clientIP != gs_FilterClientIP);
   }
   
   public static ContextAction("开/关过滤单设备请求")
   function ToggleDeviceFilter(oSessions: Fiddler.Session[]){
       if (gs_FilterDevice) {
           gs_FilterDevice = false;
           return;
       }
       var oS: Session = FiddlerApplication.UI.GetFirstSelectedSession();
       if (null == oS) return;
       if (!gs_FilterDevice) {
           gs_FilterDevice = true;
       }
       gs_FilterClientIP = oS.clientIP;
   
       // 删除当前已显示的非所关心设备的请求
       FiddlerApplication.UI.actSelectSessionsMatchingCriteria(IsUnMatchClientIP);
       FiddlerApplication.UI.actRemoveSelectedSessions();
   }
   

3. 在 OnBeforeRequest 函数里添加如下代码，用于在「查看单个设备请求」状态时将不关心的设备产生的新请求隐藏：

   if (gs_FilterDevice && oSession.m_clientIP != gs_FilterClientIP) {
       oSession["ui-hide"] = "true";
   }
   

最终效果如下图：

• 筛选前

  

• 筛选后

  

缺陷

当前做法有如下缺陷，尚未想到好办法解决：

• 菜单项并不能标明当前的状态，不知道筛选是开是关，这可以通过查看当前 Session 列表里是否有多种设备的请求来判断。

• 当设备有网络切换时，比如重启了路由或者离开又回到某 Wifi，ClientIP 可能发生了变化，需要关闭筛选后在设备以新的 ClientIP 产生的请求上右键再次开启筛选。

附注

我使用的完整最新的 CustomRules.js 文件我上传到了一个 Gist 里，详见：https://gist.github.com/mzlogin/3c5f9781c5bedff3fcfb，如果想直接使用可以复制脚本内容后放置到「我的文档/Fiddler 2/Scripts/CustomRules.js」，也可以在此目录下使用 git 抓取我的最新定制 js 文件。