21 lines
1.3 KiB
TypeScript
21 lines
1.3 KiB
TypeScript
/**
|
|
* 复用导入的合作调度机制，同时维持copy专用取消/配置错误码。
|
|
* 它不分配ID或落盘，单个原生encode/解码步骤的大小仍必须由调用者另外限制。
|
|
*/
|
|
import {fault} from '../canvas-core/values.ts';
|
|
import {createImportBudget,type ImportScheduling} from './import-budget.ts';
|
|
/** Share import scheduling while retaining the copy cancellation/error contract. */
|
|
/** 验证copy预算后包装ImportBudget；调用者只有真正await返回Promise才会交出执行权。 */
|
|
export function createCopyBudget(signal:AbortSignal,options:ImportScheduling={}){
|
|
if(signal.aborted)throw fault('copy_aborted');
|
|
if(options.frameBudgetMs!==undefined&&(!Number.isFinite(options.frameBudgetMs)||options.frameBudgetMs<=0))throw fault('invalid_copy_budget');
|
|
const budget=createImportBudget(signal,options);
|
|
/** signal已取消时将同步/异步预算失败统一为copy_aborted，其它错误原样抛给宿主。 */
|
|
const fail=(error:unknown):never=>{if(signal.aborted)throw fault('copy_aborted');throw error;};
|
|
/** 每次step先查copy取消，保持底层同步返回undefined或异步让出的原调度语义。 */
|
|
return Object.freeze({step(units=1):Promise<void>|undefined{
|
|
if(signal.aborted)throw fault('copy_aborted');
|
|
try{return budget.step(units)?.catch(fail);}catch(error){return fail(error);}
|
|
}});
|
|
}
|