Schemat kodów błędów funkcji hosta Aggrega Wasm
Dokumentacja wygenerowana automatycznie. Nie należy jej edytować ręcznie — należy ją wygenerować ponownie z opublikowanego JSON Schema.
Identyfikator schematu: https://aggrega.ai/schemas/wasm-hostfunc-error-v1beta1.schema.json
Zamknięty zbiór kodów błędów możliwych do dopasowania maszynowo, które host ustawia w kopercie odpowiedzi funkcji hosta, gdy wywołanie zwrotne się nie powiedzie, obok komunikatu czytelnego dla człowieka. Kod jest stabilną, możliwą do dopasowania maszynowo tożsamością, na podstawie której gość rozgałęzia działanie bez parsowania treści komunikatu; komunikat pozostaje dowolnym tekstem przeznaczonym dla ludzi. Ten schemat jest jedynym źródłem słownika kodów wspólnego dla wszystkich kopert odpowiedzi funkcji hosta (aggrega_pack_source, aggrega_read_source_file, aggrega_parse_source i aggrega_fetch_external_input): każda koperta zawiera opcjonalny ciąg hostfunc_error_code, ustawiany w razie niepowodzenia i nieobecny w razie powodzenia. Ten klucz wskazuje ten katalog i tylko ten katalog: identyfikatory, które gość zgłasza dla zgłoszonego przez siebie warunku zatrzymującego, są przekazywane na wyjściu gniazda pod kluczami condition_code i condition_short_code, które stanowią inny słownik, dzięki czemu czytelnik może po samym kluczu rozpoznać, z którego zbioru pochodzi wartość. Gość toleruje brak kodu (starszy host: należy użyć komunikatu) oraz nierozpoznany kod (nowszy host emituje kod nowszy niż ten gość: należy go traktować jako brak określonej tożsamości i użyć komunikatu). Obiekt, który deklaruje ten schemat i który przechowuje słownik pod code, nie jest przesyłany w żadnym komunikacie: jego wartości docierają do gościa wyłącznie jako hostfunc_error_code koperty odpowiedzi, a każdy zestaw narzędzi dla pluginów reeksportuje je jako stałe.
Typ najwyższego poziomu: object
Właściwości
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
code | string (enum) | nie | Możliwa do dopasowania maszynowo tożsamość niepowodzenia, w postaci tokenów przewodowych w notacji lowercase-snake. fetch_request_unreadable: nie można odczytać adresu URL fetch-external-input z pamięci gościa. fetch_input_unavailable: w tym kontekście nie jest powiązana żadna usługa wejścia zewnętrznego. fetch_failed: pobranie wejścia zewnętrznego nie powiodło się. request_unreadable: nie można odczytać ładunku żądania z pamięci gościa. request_undecodable: nie można zdekodować ładunku żądania. source_root_unavailable: w tym kontekście nie jest powiązany żaden katalog główny źródeł. source_read_failed: nie można odczytać pliku, katalogu lub poddrzewa w katalogu głównym źródeł. unknown_selection_op: wybór pakietu wskazał operację, której host nie rozpoznaje. source_escape: żądana ścieżka względna wychodziła ponad katalog główny źródeł i została odrzucona; ocena dotyczy samej ścieżki względnej, więc wyjście w górę jest odrzucane nawet wtedy, gdy po złączeniu ścieżka wróciłaby do wnętrza katalogu głównego. producer_consumption_reentry: odmówiono wywołania zwrotnego konsumpcji producenta, ponieważ nastąpiło ponowne wejście poza dozwoloną głębokość. no_source_parser: w tym kontekście nie jest powiązany żaden parser źródeł. no_parser_for_format: dla żądanego formatu nie zarejestrowano żadnego parsera. parse_failed: rozpoznany parser nie zdołał sparsować źródła. Dozwolone wartości: "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" |
Dodatkowe właściwości są niedozwolone.