本页面由机器翻译。阅读英文原文。
Aggrega Wasm 宿主函数错误码 schema
自动生成的参考文档。请勿手动编辑——请从发布的 JSON Schema 重新生成。
Schema id:https://aggrega.ai/schemas/wasm-hostfunc-error-v1beta1.schema.json
回调失败时,宿主在宿主函数回复信封上设置的一组封闭的、可供机器匹配的错误码,与人类可读的消息并列。错误码是稳定的、可供机器匹配的标识,guest 无需解析消息文本即可据此分支;消息则保持为面向人类的自由格式文本。本 schema 是所有宿主函数回复信封(aggrega_pack_source、aggrega_read_source_file、aggrega_parse_source 和 aggrega_fetch_external_input)共享的错误码词汇的唯一来源:每个信封都带有一个可选的 hostfunc_error_code 字符串,失败时设置,成功时不存在。该键只指代本目录:guest 针对其自身引发的停止条件所报告的标识符,通过 socket 输出中的 condition_code 和 condition_short_code 传递,它们属于另一套词汇,因此读者仅凭键名即可判断某个值取自哪一套。guest 需容忍错误码缺失(旧版宿主:回退到消息)以及无法识别的错误码(新版宿主发出了该 guest 之前不存在的错误码:视为无特定标识,回退到消息)。本 schema 声明的对象(在 code 下保存该词汇)不会在任何线路上传输:其值只以回复信封的 hostfunc_error_code 的形式到达 guest,每个插件工具包都将它们重新导出为常量。
顶层类型: object
属性
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
code | string(枚举) | 否 | 可供机器匹配的失败标识,采用小写蛇形的传输标记。fetch_request_unreadable:无法从 guest 内存中读取 fetch-external-input 的 URL。fetch_input_unavailable:当前上下文中未绑定外部输入服务。fetch_failed:外部输入获取失败。request_unreadable:无法从 guest 内存中读取请求负载。request_undecodable:无法解码请求负载。source_root_unavailable:当前上下文中未绑定源根目录。source_read_failed:无法读取源根目录下的文件、目录或子树。unknown_selection_op:pack 选择指定了宿主无法识别的操作。source_escape:请求的相对路径越过了源根目录而被拒绝;判断基于该相对路径本身,因此即使拼接后会落回根目录内,越级也会被拒绝。producer_consumption_reentry:生产者消费回调因重入超出允许深度而被拒绝。no_source_parser:当前上下文中未绑定源解析器。no_parser_for_format:未为请求的格式注册解析器。parse_failed:解析得到的解析器未能解析该源。允许的值:"fetch_request_unreadable"、"fetch_input_unavailable"、"fetch_failed"、"request_unreadable"、"request_undecodable"、"source_root_unavailable"、"source_read_failed"、"unknown_selection_op"、"source_escape"、"producer_consumption_reentry"、"no_source_parser"、"no_parser_for_format"、"parse_failed" |
不允许其他属性。