store.deletePrefix()
原子删除所有以给定非空字符串开头的键,并返回实际删除数量。
Syntax
const result = await host.store.deletePrefix(prefix);
Return value
{ deleted: u64 }
若匹配数量超过 store.maxDeletePrefixItems,必须在删除任何键之前以 limit-exceeded 失败。
Examples
const { deleted } = await host.store.deletePrefix('cache/thumbnails/');
console.log(`清理了 ${deleted} 个缓存项`);
空前缀固定返回 invalid-key;删除本应用全部数据需要未来另行设计可信确认流程。
Errors
特有错误:denied、invalid-key、limit-exceeded。实现内部可以分批,但对 guest 必须保持原子可见性和崩溃一致性。
Parameters
prefix: string:非空、规范化的应用键前缀。
Requirements
- 能力:
host:store.deletePrefix - 用户激活:不需要
- 信任档位:green