dataProviders
为已放置的超级块处理一次数据请求。
Documentation content is currently available in Simplified Chinese.
页面通过 requestData() 发起请求。飞块找到清单中的提供者,把输入和实例配置交给后台;后台返回值成为这次请求的结果。
处理函数定义见 DataProviderHandler,用法见请求数据与调用服务。
#DataProvider
清单位置:manifest.contributes.dataProviders[]。
#DataProvider.id
string · 必填
提供者 ID,使用小写字母开头,可包含小写字母、数字、.、_ 和 -,最多 128 个字符。宿主保留 host-icon 用于页面图标查询,插件不能声明该 ID。
#DataProvider.widget
string · 必填
对应的超级块 ID。只有该类型的已放置实例可以请求它。
#DataProvider.lifetime
"request" · 必填
结果属于单次请求。
#DataProvider.visibility
"instance" · 必填
响应返回给发起请求的实例。
#DataProvider.requestSchema
Schema · 可选
输入对象的 Schema,根 type 为 object。省略时接收空对象。
#DataProvider.responseSchema
Schema · 必填
返回值的 Schema。
#DataProvider.timeoutMs
integer · 可选
后台请求等待时间,默认 15000 毫秒,范围为 100–30000。
#DataProvider.maxBytes
integer · 可选
响应 JSON 最大字节数,默认 32768,范围为 1024–65536。