Cache: delete() 方法

Baseline 已廣泛支援

此功能已成熟，可跨多種裝置和瀏覽器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有瀏覽器中可用。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

注意：此功能在 Web Workers 中可用。

Cache 介面的 delete() 方法會查詢鍵為指定請求的 Cache 條目，如果找到，則刪除該 Cache 條目並返回一個解析為 true 的 Promise。如果未找到 Cache 條目，則解析為 false。

語法

delete(request)
delete(request, options)

您想要刪除的 Request。這可以是一個 Request 物件或一個 URL。

一個物件，其屬性控制 delete 操作中的匹配方式。可用選項有：

ignoreSearch: 一個布林值，指定匹配過程是否應忽略 URL 中的查詢字串。如果設定為 true，則在執行匹配時會忽略 http://foo.com/?value=bar 中的 ?value=bar 部分。預設為 false。
ignoreMethod: 一個布林值，當設定為 true 時，會阻止匹配操作驗證 Request 的 HTTP 方法（通常只允許 GET 和 HEAD）。預設值為 false。
ignoreVary: 一個布林值，當設定為 true 時，會告訴匹配操作不要執行 VARY 標頭匹配。換句話說，如果 URL 匹配，無論 Response 物件是否具有 VARY 標頭，您都會獲得匹配。預設值為 false。
cacheName: 一個字串，代表要搜尋的特定快取。請注意，此選項將被 Cache.delete() 忽略。

一個 Promise，如果快取條目已被刪除，則解析為 true，否則解析為 false。

caches
  .open("v1")
  .then((cache) => cache.delete("/images/image.png"))
  .then((response) => {
    someUIUpdateFunction();
  });

規範
Service Workers # cache-delete

此頁面最後修改於 2025年6月23日，由 MDN 貢獻者進行編輯。