ContextQMD
Back to Whistle

resReplace

docs/docs/rules/resReplace.md

2.10.43.7 KB
Original Source

resReplace

使用类似 JavaScript String.replace() 的方法替换响应体内容（仅对包含响应内容体的请求有效，如 200、500 等），支持多种文本格式：

  • JSON (application/json)
  • XML (application/xml)
  • HTML (text/html)
  • 纯文本 (text/xxx)

规则语法

txt
pattern resReplace://value [filters...]
参数描述详细文档
pattern匹配请求 URL 的表达式匹配模式文档
value替换配置对象，支持从以下渠道获取：
• 目录/文件路径
• 远程 URL
• 内联/内嵌/Values内容操作指令文档
filters可选过滤器，支持匹配：
• 请求URL/方法/头部/内容
• 响应状态码/头部过滤器文档

配置示例

内联方式

txt
www.example.com/path file://(00user-11test-22user-33test) resReplace://user=abc&/\d+/g=number

请求 https://www.example.com/path/to 浏览器收到的内容：

txt
numberabc-numbertest-numberabc-numbertest

内嵌模式

txt
``` resReplace.json
user: name
/\d+/g: num
```
# 或（注意转义符）
``` resReplace.json
{
  'user': 'name',
  '/\\d+/g': 'num'
}
```
www.example.com/path file://(00user-11test-22user-33test) resReplace://{resReplace.json}

请求 https://www.example.com/path/to 浏览器收到的内容：

txt
numname-numtest-numname-numtest

本地/远程资源

txt
www.example.com/path1 resReplace:///User/xxx/test.json
www.example.com/path2 resReplace://https://www.xxx.com/xxx/params.json
# 通过编辑临时文件
www.example.com/path3 resReplace://temp/blank.json

关联协议 {#related}

  1. 在响应内容前注入内容（Prepend To Body）：resPrepend
  2. 在响应内容前注入 HTML 内容（Prepend HTML To Body，响应类型必须为 text/html）：htmlPrepend
  3. 在响应内容前注入 CSS 内容（Prepend CSS To Body，响应类型必须为 text/html 或 text/css）：cssPrepend
  4. 在响应内容前注入 JS 内容（Prepend JS To Body，响应类型必须为 text/html、text/css 或 application/javascript）：jsPrepend
  5. 替换响应内容（Replace Body）：resBody
  6. 用 HTML 内容替换响应内容（Replace Body，响应类型必须为 text/html）：htmlBody
  7. 用 CSS 内容替换响应内容（Replace Body，响应类型必须为 text/html 或 text/css）：cssBody
  8. 用 JS 内容替换响应内容（Replace Body，响应类型必须为 text/html、text/css 或 application/javascript）：jsBody
  9. 在响应内容后追加内容（Append To Body）：resAppend
  10. 在响应内容后追加 HTML 内容（Append HTML To Body，响应类型必须为 text/html）：htmlAppend
  11. 在响应内容后追加 CSS 内容（Append CSS To Body，响应类型必须为 text/html 或 text/css）：cssAppend
  12. 在响应内容后追加 JS 内容（Append JS To Body，响应类型必须为 text/html、text/css 或 application/javascript）：jsAppend
  13. 使用关键字或正则表达式替换响应内容（Modify Body Text）：resReplace
  14. 覆盖响应内容中的 JSON/Form 对象（Modify Form/JSON）：resMerge
  15. 删除响应内容中的 JSON/Form 对象属性（Delete Form/JSON）：delete://resBody.xxx