SharedStorage: clear() 方法

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

SharedStorage 介面的 clear() 方法會清除當前源的共享儲存，並從中移除所有資料。

語法

clear()

無。

一個 Promise，它將以 undefined 解析。

如果出現以下情況，Promise 會以 TypeError 拒絕：
- 由於共享儲存不可用（例如，在瀏覽器設定中被停用），資料庫未能成功清除。
- 呼叫站點未在成功的隱私沙盒註冊流程中包含共享儲存 API。
對於 WorkletSharedStorage，如果未透過 SharedStorageWorklet.addModule() 新增 worklet 模組，Promise 會以 TypeError 拒絕。

注意：對於 WindowSharedStorage，如果 clear() 操作由於共享儲存不可用以外的原因未能成功寫入資料庫，則不會丟擲錯誤 — 操作仍會以 undefined fulfilled。

window.sharedStorage.clear().then(() => console.log("Shared storage cleared"));

規範
共享儲存 API # dom-sharedstorage-clear

此頁面最後修改於 2025年7月29日，由 MDN 貢獻者編輯。