Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Aggrega-Schema der Fehlercodes für Wasm-Host-Funktionen

Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.

Schema-ID: https://aggrega.ai/schemas/wasm-hostfunc-error-v1beta1.schema.json

Die geschlossene Menge maschinell abgleichbarer Fehlercodes, die der Host auf einem Antwortumschlag einer Host-Funktion setzt, wenn ein Callback fehlschlägt, neben der für Menschen lesbaren Meldung. Der Code ist eine stabile, maschinell abgleichbare Identität, nach der ein Guest verzweigt, ohne den Meldungstext zu parsen; die Meldung bleibt freie Prosa für Menschen. Dieses Schema ist die einzige Quelle des Code-Vokabulars, das alle Antwortumschläge der Host-Funktionen gemeinsam nutzen (aggrega_pack_source, aggrega_read_source_file, aggrega_parse_source und aggrega_fetch_external_input): Jeder Umschlag trägt einen optionalen String hostfunc_error_code, der bei einem Fehlschlag gesetzt ist und bei Erfolg fehlt. Dieser Schlüssel benennt diesen Katalog und nur diesen Katalog: Die Bezeichner, die ein Guest für eine von ihm ausgelöste Abbruchbedingung meldet, werden auf einer Socket-Ausgabe unter condition_code und condition_short_code übertragen, die ein anderes Vokabular sind, sodass ein Leser allein am Schlüssel erkennen kann, aus welcher Menge ein Wert stammt. Ein Guest toleriert einen fehlenden Code (älterer Host: auf die Meldung zurückfallen) und einen nicht erkannten Code (ein neuerer Host gibt einen Code aus, der jünger ist als dieser Guest: als keine bestimmte Identität behandeln, auf die Meldung zurückfallen). Das Objekt, das dieses Schema deklariert und das das Vokabular unter code enthält, wird in keinem Übertragungsformat übertragen: Seine Werte erreichen einen Guest nur als hostfunc_error_code eines Antwortumschlags, und jedes Plugin-Kit re-exportiert sie als Konstanten.

Typ der obersten Ebene: object

Eigenschaften

EigenschaftTypErforderlichBeschreibung
codestring (enum)neinDie maschinell abgleichbare Identität des Fehlschlags, in kleingeschriebenen Snake-Case-Übertragungstoken. fetch_request_unreadable: Die URL von fetch-external-input konnte nicht aus dem Guest-Speicher gelesen werden. fetch_input_unavailable: In diesem Kontext ist kein Dienst für externe Eingaben gebunden. fetch_failed: Der Abruf der externen Eingabe ist fehlgeschlagen. request_unreadable: Die Payload der Anfrage konnte nicht aus dem Guest-Speicher gelesen werden. request_undecodable: Die Payload der Anfrage konnte nicht dekodiert werden. source_root_unavailable: In diesem Kontext ist keine Quellwurzel gebunden. source_read_failed: Eine Datei, ein Verzeichnis oder ein Teilbaum unter der Quellwurzel konnte nicht gelesen werden. unknown_selection_op: Die Pack-Auswahl hat eine Operation genannt, die der Host nicht erkennt. source_escape: Der angeforderte relative Pfad ist über die Quellwurzel hinaufgestiegen und wurde abgelehnt; das Urteil wird über diesen relativen Pfad selbst gefällt, sodass ein Aufstieg auch dort abgelehnt wird, wo er nach dem Zusammenfügen wieder innerhalb der Wurzel gelandet wäre. producer_consumption_reentry: Ein Producer-Consumption-Callback wurde verweigert, weil er über die zulässige Tiefe hinaus erneut eingetreten ist. no_source_parser: In diesem Kontext ist kein Quellparser gebunden. no_parser_for_format: Für das angeforderte Format ist kein Parser registriert. parse_failed: Der aufgelöste Parser konnte die Quelle nicht parsen. Zulässige Werte: "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"

Zusätzliche Eigenschaften sind nicht zulässig.