# HTTP 请求

使用脚本修改 HTTP 请求。value 字段是一个正则表达式，用于匹配请求的 URL。

传入的参数包含在 `$request` 中：

* `$request.url<String>`: 请求的 URL。
* `$request.method<String>`：请求的 HTTP 方法。
* `$request.headers<Object>`：请求的 HTTP 标头。
* `$request.body<String or Uint8Array>`：请求的 body。仅在 `requires-body = true` 时有效。
* `$request.id<String>`: 用于在不同脚本间保持连续性的唯一 ID。

脚本必须调用 `$done()` 并传入一个对象。该对象可以包含：

* `url<String>`: 使用新的 URL 覆盖旧的 URL。请注意，它不会像 URL Rewrite 那样更新请求头中的 'Host' 字段。如果需要，您必须通过返回修改后的 header 对象来手动更改它。
* `headers<Object>`: 使用新的 headers 覆盖所有旧的 headers。请注意，某些字段（例如 'Content-Length'）可能无法修改。
* `body<String or Uint8Array>`: 使用新的 body 覆盖旧的 body。仅在 `requires-body = true` 时有效。
* `response<Object>`：如果该对象存在，Surge 将直接返回 HTTP 响应，而无需进行真正的网络操作。该对象可以包含：
  * `status<Number>`: 响应的 HTTP 状态码。（可选。默认值：200）
  * `headers<Object>`: 响应的 HTTP 标头。（可选）
  * `body<String or Uint8Array>`: 响应的 HTTP Body。（可选）

您可以调用 `$done();` 来中止请求而不返回任何内容。或者使用 `$done({});` 保持请求不变。

当前版本的一些限制：

* 使用 chunked 编码时，请求的 body 可能无法被覆盖。
* 当请求头中存在 'Expect: 100-continue' 时，请求的 body 可能无法被覆盖。

一个简单的示例：

```javascript
let headers = $request.headers;
headers['X-Modified-By'] = 'Surge';

$done({headers});
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://surge.mitsea.com/scripting/http-request.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.