Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Схема кодов ошибок хост-функций Aggrega Wasm

Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.

Идентификатор схемы: https://aggrega.ai/schemas/wasm-hostfunc-error-v1beta1.schema.json

Закрытый набор машинно сопоставляемых кодов ошибок, которые хост устанавливает в конверте ответа хост-функции при сбое обратного вызова, наряду с удобочитаемым сообщением. Код — это стабильный, машинно сопоставляемый идентификатор, по которому гостевой модуль выбирает ветвь без разбора текста сообщения; сообщение остаётся свободным текстом для людей. Эта схема — единственный источник словаря кодов, общего для всех конвертов ответов хост-функций (aggrega_pack_source, aggrega_read_source_file, aggrega_parse_source и aggrega_fetch_external_input): каждый конверт содержит необязательную строку hostfunc_error_code, которая задаётся при сбое и отсутствует при успехе. Этот ключ обозначает данный каталог и только его: идентификаторы, которые гостевой модуль сообщает для поднятого им условия остановки, передаются в выходе сокета в condition_code и condition_short_code, а это другой словарь, поэтому по одному ключу можно определить, из какого набора взято значение. Гостевой модуль допускает отсутствие кода (старый хост: использовать сообщение) и нераспознанный код (более новый хост выдаёт код, появившийся позже этого гостевого модуля: считать, что конкретного идентификатора нет, и использовать сообщение). Объект, который объявляет эта схема и который хранит словарь под code, не передаётся ни в каких данных: его значения доходят до гостевого модуля только как hostfunc_error_code конверта ответа, и каждый набор для разработки плагинов реэкспортирует их как константы.

Тип верхнего уровня: object

Свойства

СвойствоТипОбязательноОписание
codestring (enum)нетМашинно сопоставляемый идентификатор сбоя в виде передаваемых токенов в нижнем регистре через подчёркивание. fetch_request_unreadable: не удалось прочитать URL fetch-external-input из памяти гостевого модуля. 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: выбранному парсеру не удалось разобрать источник. Допустимые значения: "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"

Дополнительные свойства не допускаются.