跳到主要内容

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​

ParameterTypeDescription
transferIdstringupload 请求里声明的传输 ID。

Returns​

DevToolsChunkSink

该次传输的 sink。

Throws​

该 ID 没有登记过上传时抛出——无主 sink 会把一处接线错误写成一个真实文件。

Inherited from​

DevToolsFilesProviderWithSource.createChunkSink


createChunkSource()​

createChunkSource(requestId): DevToolsChunkSource | undefined;

Defined in: native/native-files-provider.ts:132

取一次已登记下载的字节源。

Parameters​

ParameterTypeDescription
requestIdstringdownload 请求的 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​

ParameterTypeDescription
operationstring已授权的操作名。
paramsunknown已通过 wire 层通用校验、但未按操作解释的参数;实现负责领域级校验 (例如路径合法性 → invalid_path)。

Returns​

Promise<DevToolsProviderResult>

成功结果或已映射的错误。

Remarks​

调用方保证 operation 已经通过三层授权,因此实现不再做权限判断—— 两处判断迟早会漂移,而漂移的表现是某一处悄悄放宽。

Inherited from​

DevToolsFilesProviderWithSource.invoke