SharedStorage:clear() 方法
clear()
方法是 SharedStorage
接口的方法,用于清除当前源的共享存储,从中删除所有数据。
语法
js
clear()
参数
无。
返回值
一个 Promise
,其结果为 undefined
。
异常
- 如果出现以下情况,则
Promise
将拒绝并抛出一个TypeError
:- 由于共享存储不可用(例如,使用浏览器设置禁用),数据库未成功清除。
- 调用站点没有在成功的 隐私沙盒注册流程 中包含 Shared Storage API。
- 对于
WorkletSharedStorage
,如果工作线程模块尚未使用SharedStorageWorklet.addModule()
添加,则Promise
将拒绝并抛出一个TypeError
。
注意:对于 WindowSharedStorage
,如果 clear()
操作由于共享存储不可用以外的其他原因未能成功写入数据库,则不会抛出错误——操作仍将以 undefined
为结果。
示例
js
window.sharedStorage.clear().then(console.log("Shared storage cleared"));
规范
规范 |
---|
Shared Storage API # dom-sharedstorage-clear |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。