大网数据广告活动
Web 标准与前端开发

OPTIONS 请求方法

· 52CE 我爱测

HTTP **`OPTIONS`** 方法向给定 URL 或服务器请求其允许的通信选项。它可用于测试一个请求允许使用的 HTTP 方法,或用于确定一个请求在发起 CORS 预检请求时是否会成功。客户端可以使用该方法指定一个 URL,或者使用星号(`*`)来指代整个服务器。

HTTP OPTIONS 方法向给定 URL 或服务器请求其允许的通信选项。它可用于测试一个请求允许使用的 HTTP 方法,或用于确定一个请求在发起 CORS 预检请求时是否会成功。客户端可以使用该方法指定一个 URL,或者使用星号(*)来指代整个服务器。

<table class="properties"> <tbody> <tr> <th scope="row">请求是否有主体</th> <td>可能有*</td> </tr> <tr> <th scope="row">成功的响应是否有主体</th> <td>可能有</td> </tr> <tr> <th scope="row">Safe/HTTP</th> <td>是</td> </tr> <tr> <th scope="row">Idempotent</th> <td>是</td> </tr> <tr> <th scope="row">Cacheable</th> <td>否</td> </tr> <tr> <th scope="row"> 是否允许在 HTML 表单中使用 </th> <td>否</td> </tr> </tbody> </table>

* 尽管技术上带有请求体的 OPTIONS 消息是允许的,但其语义未被定义。只要提供有效的 Content-Type 标头,并且确定服务器会接受(因为行为依赖于具体实现),就可以在 OPTIONS 消息中包含请求体。

语法

OPTIONS *|<request-target>["?"<query>] HTTP/1.1

请求目标可以是表示整个服务器的“星号形式” *,也可以是与其他方法相同的常见请求目标:

  • *
    • : 表示客户端希望对整个服务器而不仅只是该服务器的某个特定资源发起 OPTIONS 请求。
  • <request-target>
    • : 当与 Host 标头提供的信息结合使用时,可用于标识请求的目标资源。请求源服务器时是绝对路径(例如,/path/to/file.html),请求代理服务器时是绝对 URL(例如,http://www.example.com/path/to/file.html)。
  • <query>
    • : 可选的查询组件,以问号 ? 开头。通常用于以 key=value 对的形式承载识别信息。

示例

检测服务器所支持的请求方法

要想知道一个服务器支持哪些请求方法,可以使用 curl 命令行程序来发出 OPTIONS 请求:

curl -X OPTIONS https://example.org -i

这会创建以下 HTTP 请求:

OPTIONS / HTTP/2
Host: example.org
User-Agent: curl/8.7.1
Accept: */*

响应包含 Allow 标头,它的值将指示服务器支持的所有 HTTP 方法:

HTTP/1.1 204 No Content
Allow: OPTIONS, GET, HEAD, POST
Cache-Control: max-age=604800
Date: Thu, 13 Oct 2016 11:45:00 GMT
Server: EOS (lax004/2813)

CORS 中的预检请求

在 CORS 中,可以使用 OPTIONS 方法发起一个预检请求,以检测实际请求是否可以被服务器所接受。在这个示例中,我们会为这些参数请求权限:

  • 在预检请求中发送的 Access-Control-Request-Method 标头告知服务器实际请求所使用的 HTTP 方法,在这里将实际使用 POST 请求方法。
  • Access-Control-Request-Headers 标头告知服务器实际请求所携带的自定义标头,在这里会使用 X-PINGOTHER 和 Content-Type 标头。
OPTIONS /resources/post-here/ HTTP/1.1
Host: bar.example
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-us,en;q=0.5
Accept-Encoding: gzip,deflate
Connection: keep-alive
Origin: https://foo.example
Access-Control-Request-Method: POST
Access-Control-Request-Headers: X-PINGOTHER, Content-Type

服务器现在可以回应是否会接受这些情况下的请求。在这个例子中,服务器的响应说明了:

  • Access-Control-Allow-Origin
    • : https://foo.example 源被允许通过以下方式请求 bar.example/resources/post-here/ URL:
  • Access-Control-Allow-Methods
    • : POST、GET 和 OPTIONS 是该 URL 允许的方法(该标头类似于 Allow 响应标头,但只用于 CORS)。
  • Access-Control-Allow-Headers
    • : X-PINGOTHER 和 Content-Type 是该 URL 允许的请求标头。
  • Access-Control-Max-Age
    • : 以上权限可以缓存 86400 秒(1 天)。
HTTP/1.1 200 OK
Date: Mon, 01 Dec 2008 01:15:39 GMT
Server: Apache/2.0.61 (Unix)
Access-Control-Allow-Origin: https://foo.example
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-PINGOTHER, Content-Type
Access-Control-Max-Age: 86400
Vary: Accept-Encoding, Origin
Keep-Alive: timeout=2, max=100
Connection: Keep-Alive

[!NOTE] 200 和 204 都是允许的状态码,但是部分浏览器错误地认为 204 No Content 也适用于该资源,且不发送后续请求来获取资源内容。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。