改写 HTTP

用户可以通过 JavaScript 脚本修改流经 Stash 的 HTTP 请求、响应。

配置格式

http:
  script:
    - match: url-you-want-to-match
      name: your-fancy-script
      type: response # request / response
      require-body: true
      timeout: 20
      argument: ''
      binary-mode: false
      max-size: 1048576 # 1MB
 
script-providers:
  your-fancy-script:
    url: https://your-fancy-script.com/your-fancy-script.js
    interval: 86400

参数：

• match: 脚本匹配的 URL 正则表达式。
• type: 脚本类型，可选值为 request 或 response。
• require-body: 是否需要请求体 / 响应体，在脚本中处理 body 需要消耗更多的内存空间，仅在必要时启用。
• timeout: 脚本执行超时时间，单位为秒。
• argument: 脚本执行时的参数，类型为 string。
• binary-mode：二进制模式，body 会以 Uint8Array 而不是 string 传递给脚本。
• max-size：单位为字节，body 超过这个大小的请求不会触发脚本。

Request Object

• $request.url：请求 URL
• $request.method：请求方法
• $request.headers：请求头
• $request.body：请求体，仅在 require-body: true 时有，根据是否开启二进制模式，可以为 string 或者 Uint8Array

Response Object

• $request.url：请求 URL
• $request.method：请求方法
• $request.headers：请求头
• $response.status：响应状态码
• $response.headers：响应头
• $response.body：响应体，仅在 require-body: true 时有，根据是否开启二进制模式，可以为 string 或者 Uint8Array

$done(value)

对于 request 类型的脚本，调用 $done(object) 可以改写 HTTP 请求，object 可以包含下述字段：

• url：修改请求的 URL
• headers：修改请求的 headers
• body：修改请求的 body
• response：替换 HTTP 响应，不再实际发出 HTTP 请求

你可以调用 $done() 来打断请求，或者 $done({}) 不修改请求的任何内容。

对于 response 类型的脚本，调用 $done(object) 可以改写 HTTP 响应，object 可以包含下述字段：

• status：修改响应的状态码
• headers：修改响应的 headers
• body：修改响应的 body

你可以调用 $done() 来打断请求，或者 $done({}) 不修改响应的任何内容。