docs(canvas): clarify entry and migration lifecycle

This commit is contained in:
2026-11-12 16:01:25 +08:00
parent 84c50fe595
commit 5803787910
5 changed files with 16 additions and 1 deletions
+3
View File
@@ -13,6 +13,7 @@ export function createResourceLoader<T>(load: (key: string, signal: AbortSignal)
// cache保存完成值,jobs保存当前可加入的尝试,queue只保存尚未占并发槽的job。
const cache = new Map<string, T>();
const jobs = new Map<string, Job>();
// FIFO 使用数组 shift/splice;不是按优先级排序的 heap,也不持久化等待项或失败重试。
const queue: Job[] = [];
let active = 0;
/** 命中后移到Map尾部,更新近用顺序;只读缓存,不启动网络。 */
@@ -34,6 +35,7 @@ export function createResourceLoader<T>(load: (key: string, signal: AbortSignal)
return load(job.key, job.controller.signal);
}).then((value) => {
if (!job.controller.signal.aborted) {
// 缓存直接借用 load 的结果引用;订阅者共享同一对象,调用方须保证可安全共享/只读。
cache.set(job.key, value);
// 超出缓存容量淘汰最久未触及key,不影响仍在运行的其它job。
while (cache.size > cacheSize) cache.delete(cache.keys().next().value!);
@@ -74,5 +76,6 @@ export function createResourceLoader<T>(load: (key: string, signal: AbortSignal)
pump();
});
}
// 实例没有 dispose/clear:宿主通过订阅信号释放任务;缓存随实例不再被引用后交给 GC。
return { request, peek };
}