docs(tests): explain asset authorization and byte retention lifecycle
This commit is contained in:
@@ -51,6 +51,7 @@ test('retired orphan identity and v5 recovery survive reopening and reject new r
|
||||
}finally{await engine.close();}
|
||||
});
|
||||
// 文件大小与 MIME 相同也可能换了字节;digest 改变必须重置无引用起点,重新等待完整保留期才能删除。
|
||||
// aa→bb 都是两字节,且 MIME 都为空,故新起点只能由内容摘要变化触发;假时钟分别检查旧/新保留期。
|
||||
test('changed orphan bytes reset the retention interval even when size and MIME stay equal',async()=>{
|
||||
const f=fixture(new Map([['old',new Blob(['aa'])]])),engine=await f.open();try{await engine.collectOrphanFiles({retentionMs:100});const digest=engine.getSnapshot().runtime.orphanFiles.get('old').digest;f.advance(100);f.files.set('old',new Blob(['bb']));const changed=await engine.collectOrphanFiles({retentionMs:100});assert.deepEqual(changed.changedIds,['old']);assert.deepEqual(changed.purgedIds,[]);const record=engine.getSnapshot().runtime.orphanFiles.get('old');assert.notEqual(record.digest,digest);assert.equal(record.retirement.unreferencedAt,1100);f.advance(100);assert.deepEqual((await engine.collectOrphanFiles({retentionMs:100})).purgedIds,['old']);}finally{await engine.close();}
|
||||
});
|
||||
@@ -65,6 +66,7 @@ test('hash budgets preserve pagination progress and a changed Root invalidates r
|
||||
}finally{gate.resolve();await engine.close();}
|
||||
});
|
||||
// abort 后迟到字节不得发布盘点结果;删除批次保存失败时保留原清理切点及资源访问屏障,persist 重试完成同一次删除。
|
||||
// disk failure 在委托原 commit 之前抛出,所以 files 仍有原字节;显示屏障防止未完成的删除被新访问穿过。
|
||||
test('cancelling verification never publishes late byte results and failures retain the original purge cut',async()=>{
|
||||
const f=fixture(new Map([['old',new Blob(['old'])]])),engine=await f.open(),gate=deferred(),entered=deferred(),read=f.storage.readFile,cancel=new AbortController();let fail=false;const commit=f.storage.commit;try{f.storage.readFile=async(...args)=>{const bytes=await read(...args);entered.resolve();await gate.promise;return bytes;};const task=engine.collectOrphanFiles({retentionMs:0,signal:cancel.signal});await entered.promise;cancel.abort();await assert.rejects(task,/file_inventory_aborted/);gate.resolve();await Promise.resolve();assert.equal(engine.getSnapshot().runtime.orphanFiles?.size??0,0);f.storage.readFile=read;f.storage.commit=async(...args)=>{if(fail&&args[1].deleteFiles?.length)throw Error('disk failure');return commit(...args);};fail=true;await assert.rejects(engine.collectOrphanFiles({retentionMs:0}),/disk failure/);assert.ok(f.files.has('old'));await assert.rejects(engine.displayResource('old'),/resource_collection_in_progress/);fail=false;await engine.persist();assert.equal(f.files.has('old'),false);assert.ok(decodeRecovery(f.image(),registry).runtime.orphanFiles.get('old').retirement.purgedAt!==undefined);
|
||||
}finally{fail=false;gate.resolve();await engine.close();}
|
||||
|
||||
Reference in New Issue
Block a user