DevToolsNativeFilesProvider
Defined in: native/native-files-provider.ts:136
原生 files provider;在 DevToolsFilesProviderWithSource 之上多一个快照回收入口。
Extends
Properties
descriptor
readonly descriptor: DevToolsProviderDescriptor;
Defined in: provider/types.ts:174
本 provider 的声明;授权矩阵的第二层直接读它。
Inherited from
DevToolsFilesProviderWithSource.descriptor
Methods
createChunkSink()
createChunkSink(transferId): DevToolsChunkSink;
Defined in: native/native-files-provider.ts:124
取一次已登记上传的落盘接收器。
Parameters
| Parameter | Type | Description |
|---|---|---|
transferId | string | upload 请求里声明的传输 ID。 |
Returns
该次传输的 sink。
Throws
该 ID 没有登记过上传时抛出——无主 sink 会把一处接线错误写成一个真实文件。
Inherited from
DevToolsFilesProviderWithSource.createChunkSink
createChunkSource()
createChunkSource(requestId): DevToolsChunkSource | undefined;
Defined in: native/native-files-provider.ts:132
取一次已登记下载的字节源。
Parameters
| Parameter | Type | Description |
|---|---|---|
requestId | string | download 请求的 ID。 |
Returns
DevToolsChunkSource | undefined
该次下载的字节源;该 ID 没有登记过下载时为 undefined。
Inherited from
DevToolsFilesProviderWithSource.createChunkSource
dispose()
dispose(): void;
Defined in: native/native-files-provider.ts:144
释放诊断快照仓库与其计时器。
Returns
void
Remarks
幂等。快照仓库持有 15 s deadline 与 60 s cursor idle 两路计时器,session 拆除时 必须一并回收——provider 按 session 装配,仓库因此也是 session 级资源。
invoke()
invoke(operation, params): Promise<DevToolsProviderResult>;
Defined in: provider/types.ts:188
执行一个操作。
Parameters
| Parameter | Type | Description |
|---|---|---|
operation | string | 已授权的操作名。 |
params | unknown | 已通过 wire 层通用校验、但未按操作解释的参数;实现负责领域级校验 (例如路径合法性 → invalid_path)。 |
Returns
Promise<DevToolsProviderResult>
成功结果或已映射的错误。
Remarks
调用方保证 operation 已经通过三层授权,因此实现不再做权限判断——
两处判断迟早会漂移,而漂移的表现是某一处悄悄放宽。