用户手册

iOS 抓包脚本:自动处理请求与响应

当简单重写不足以表达复杂逻辑时,NetPeek 脚本可在请求前、响应后或定时执行 JavaScript,并通过常量统一管理环境地址、Token 等复用值。

5脚本

当规则不够用时,用 JavaScript 脚本对命中请求做更灵活的处理:读取/改写请求与响应、解压 gzip、按条件计算返回值等。脚本按 host 生效,和规则一样在隧道里运行。

  1. 脚本列表点 + 新建,填名称与作用域(host)。
  2. 在编辑器里写处理逻辑(提供 $utils 等辅助能力,如 gzip 解压)。
  3. 保存并启用,重新发起请求即可看到效果。
打开脚本列表 新建脚本

7常量

把常用的值(如某段 Mock JSON、Token、测试地址)存成常量,规则里用 ${常量ID} 引用,改一处即可全局生效。

打开常量管理 新建常量
简单模式的 Mock 已自动帮你处理响应内容,通常无需手动建常量;常量更适合专家模式里跨多条规则复用。

规则不够用时才写脚本

重写规则处理静态替换已经足够,需要条件判断和计算时才轮到脚本:

  • 按响应内容决定改不改:比如只在返回特定错误码时替换 Body。
  • 需要计算的值:时间戳、签名、随机 ID,写死在规则里没有意义。
  • 解压后再处理:对 gzip 的响应体先解压,改完再回压。
  • 跨请求串联:把上一个请求拿到的 Token 用到下一个请求上。

脚本的运行边界

  • 脚本按 host 作用域生效,和重写规则一样在隧道里执行。
  • 提供 $utils 等辅助能力,涵盖 gzip/gunzip 等常用操作。
  • 可以选择请求前、响应后,或按计划定时执行。
  • 常量集中管理环境地址和 Token,多个脚本复用同一份配置。

常见问题

脚本适合什么场景?

适合需要条件分支、组合处理或定时自动化的调试逻辑;简单 Header、Body 或 Mock 修改优先使用重写规则。

脚本会自动运行吗?

只有脚本本身已启用且全局脚本开关开启时才会执行。

常量有什么用?

常量用于复用 API 地址、Token 等值,修改一处即可影响引用它的规则或脚本。

继续了解