DELETE 請求方法

DELETE HTTP 方法要求伺服器刪除指定的資源。

DELETE 方法對訊息體沒有明確的語義定義,因此訊息體應該為空。

請求有正文 可能
成功響應有正文 可能
安全
冪等
可快取
允許在 HTML 表單中使用

語法

http
DELETE <request-target>["?"<query>] HTTP/1.1
<請求目標>

Host 標頭中提供的資訊結合使用時,標識請求的目標資源。這是對源伺服器的請求中的絕對路徑(例如,/path/to/file.html),以及對代理的請求中的絕對 URL(例如,http://www.example.com/path/to/file.html)。

<query> 可選

一個可選的查詢元件,前面帶有一個問號 ?。通常用於以 key=value 對的形式攜帶識別資訊。

示例

成功刪除資源

以下請求要求伺服器刪除資源 file.html

http
DELETE /file.html HTTP/1.1
Host: example.com

如果請求成功,可能會有多種 成功的響應狀態碼204 No Content 響應表示請求成功,且無需向客戶端傳送額外資訊。

http
HTTP/1.1 204 No Content
Date: Wed, 04 Sep 2024 10:16:04 GMT

200 OK 響應表示請求成功,且響應主體中包含描述結果的表示。

http
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Fri, 21 Jun 2024 14:18:33 GMT
Content-Length: 1234

<html lang="en-US">
  <body>
    <h1>File "file.html" deleted.</h1>
  </body>
</html>

202 Accepted 響應表示請求已被接受,且很可能會成功,但資源尚未被伺服器刪除。

http
HTTP/1.1 202 Accepted
Date: Wed, 26 Jun 2024 12:00:00 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 1234

<html lang="en-US">
  <body>
    <h1>Deletion of "file.html" accepted.</h1>
    <p>See <a href="http://example.com/tasks/123/status">the status monitor</a> for details.</p>
  </body>
</html>

規範

規範
HTTP 語義
# name-delete

瀏覽器相容性

瀏覽器不會將 DELETE 方法用於使用者發起的行為,因此“瀏覽器相容性”不適用。開發者可以使用 fetch() 設定此請求方法。

另見