store.deletePrefix()
删除所有以给定字符串开头的键,并返回实际删除数量。
Syntax
const result = await host.store.deletePrefix(prefix);
Return value
{ deleted: u32 }
Examples
const { deleted } = await host.store.deletePrefix('cache/thumbnails/');
console.log(`清理了 ${deleted} 个缓存项`);
空前缀可能删除本应用全部数据,宿主必须有更严格预算或明确拒绝;不能意外越过 appId 隔离。
Errors
invalid-key、limit-exceeded、operation-incomplete。若实现分批执行,失败必须返回可恢复的明确状态,不能假装原子成功。