Schema del socket Wasm describe di Aggrega
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/wasm-describe-v1beta1.schema.json
La forma di trasmissione che ogni plugin Wasm restituisce dalla sua esportazione describe() (PluginDescriptor). describe() è l’autodichiarazione del plugin, letta una volta dall’host quando carica il plugin: la versione dell’ABI rispetto a cui il guest si lega, il tipo di plugin, le esportazioni che offre con la dichiarazione di capacità di ciascuna esportazione, un’autodescrizione delle capacità a livello di plugin, un contratto facoltativo sul comportamento di rendering del provider, un contratto facoltativo di riconoscimento dell’importer, comandi CLI facoltativi, uno schema di impostazioni facoltativo e metadati di paternità facoltativi. Un’unica forma copre ogni tipo di plugin — provider, linter, passo della pipeline feature-recipe, governance, CLI, parser e importer. L’host legge describe() prima di smistare qualsiasi altra esportazione e rifiuta un descrittore che non può ammettere anziché invocare in modo errato il plugin al momento dello smistamento.
Una delle forme seguenti
PluginDescriptor
Definizioni
PluginDescriptor
L’autodichiarazione completa di un plugin, restituita da describe() e letta una sola volta al caricamento. Contiene l’handshake di compatibilità ABI, il tipo di plugin, le esportazioni offerte e le superfici facoltative specifiche di ciascun tipo (il contratto di comportamento di rendering di un provider, il contratto di riconoscimento di un importer, i comandi di un plugin CLI, uno schema delle impostazioni, i metadati di paternità).
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
abi_version | const “v1beta1” | sì | L’ABI dei plugin a cui si lega il guest. L’host accetta esattamente questa versione; un guest compilato per qualsiasi altra ABI viene rifiutato al caricamento anziché essere invocato in modo errato al momento dello smistamento. Costante: "v1beta1" |
plugin_type | string (enum) | sì | Il tipo del plugin. Seleziona la regola di esportazione minima che l’host convalida e, insieme al nome dell’esportazione, il modello predefinito di consegna dell’input. Un plugin di governance serve i ruoli di trasformazione e di verdetto della pipeline di build; è il ruolo con cui è associato — non il suo tipo — a fissare ciò che può emettere. Valori consentiti: "provider", "linter", "pipeline-step", "governance", "cli", "parser", "importer" |
capabilities | string[] | no | Ciò che il plugin serve. L’elenco è piatto nel formato di trasmissione e il plugin_type obbligatorio adiacente fissa quale dei quattro significati porta ciascuna voce: per un provider, i nomi di capacità (come helm o compose) di cui renderizza la forma di output; per un passo della pipeline feature-recipe, le capacità del provider con cui il suo passo è compatibile; per un parser, i formati di origine che trasforma in un albero strutturato canonico, ciascuno scritto come parse: |
exports | PluginExport[] | sì | Le esportazioni che il plugin offre, nell’ordine dichiarato. L’host convalida che l’esportazione minima per tipo sia presente e collega la superficie host di ciascuna esportazione prima di invocarla. |
contract | ProviderContract | no | L’autodescrizione del comportamento di rendering del provider — i tipi di input che renderizza, come assembla l’output per nodo di un gruppo di smistamento e la coppia di delimitatori dei template di artefatto che applica. Descrive il provider nel suo insieme anziché una singola esportazione. Assente per un plugin che non dichiara alcun contratto di comportamento di rendering. |
importer | ImporterContract | no | L’autodescrizione di un importer su come viene riconosciuto un sorgente dei formati che annuncia quando un’importazione non nomina alcun formato. Solo un plugin il cui plugin_type è importer può dichiararla; qualsiasi altro plugin che la dichiari viene rifiutato al caricamento. Assente per un importer che non dichiara alcun modo di riconoscere i propri formati, i cui formati vengono allora raggiunti solo nominandoli. |
description | string | no | La descrizione propria del plugin, su una riga e leggibile da una persona, di ciò che fa, distinta dalla descrizione di una singola esportazione e dalla descrizione nei metadati dell’entità. È informativa; l’host non la convalida né agisce in base a essa. |
commands | PluginCLICommand[] | no | I verbi di comando aggrega di primo livello che un plugin CLI aggiunge, ciascuno con la propria riga di aiuto breve. Un solo plugin CLI può aggiungere più comandi; l’host registra un comando per voce e instrada il nome del comando risolto al guest al momento dell’invocazione. Un plugin non CLI lo lascia vuoto. |
settings_schema | object | no | Un documento JSON Schema facoltativo che un plugin dichiara per tipizzare le impostazioni fornite dall’operatore che la sua associazione porta. Quando è presente, l’host lo compila al caricamento e al momento dello smistamento convalida rispetto a esso le impostazioni dell’associazione, prima di invocare il plugin; le impostazioni non conformi arrestano la build. Quando è assente, il plugin non dichiara alcuna forma e le impostazioni passano invariate. Lo schema è la dichiarazione propria e in forma libera del plugin; l’host esegue su di esso una validazione JSON Schema generica e non interpreta il significato delle impostazioni. |
metadata | PluginDescriptorMeta | no | Informazioni facoltative di paternità e di provenienza della build. Non portano alcun contratto di comportamento — l’host non le convalida né agisce in base a esse. |
Non sono consentite proprietà aggiuntive.
PluginExport
Un’esportazione che un plugin offre, come dichiarato in describe(). L’host smista verso l’esportazione tramite il suo nome e collega la superficie host con privilegi minimi richiesta dalle funzioni host dichiarate dell’esportazione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Il nome ABI dell’esportazione — per esempio render_node, assemble_boundary, lint_rules o step. L’host smista verso l’esportazione tramite questo nome. |
input_pattern | string (enum) | no | Come l’host consegna l’input dell’esportazione: b consegna l’intero payload inline, così il guest renderizza a partire dal solo payload; a consegna un payload ridotto che il guest arricchisce tramite funzioni host. Un’esportazione che omette questo campo assume il valore predefinito del proprio tipo di plugin e del proprio nome. Valori consentiti: "a", "b" |
host_functions | string[] | no | I nomi delle funzioni host che questa esportazione importa. Ogni nome deve trovarsi nella allowlist delle funzioni host. La dichiarazione è autorevole e viene confrontata al caricamento con le funzioni che il guest importa effettivamente dal proprio modulo, così non può divergere dalle funzioni che il guest chiama davvero. |
description | string | no | Testo facoltativo leggibile da una persona che descrive l’esportazione. È documentazione per chi legge il catalogo; l’host non lo convalida né agisce in base a esso. |
stability | string (enum) | no | Il livello di stabilità dell’esportazione. Un valore omesso non esprime alcuna affermazione di stabilità. Valori consentiti: "stable", "experimental", "deprecated" |
operates | string (enum) | no | L’operazione di pipeline che questa esportazione esegue: patch modifica un documento renderizzato esistente, emit aggiunge un nuovo documento. La forma del valore viene controllata al caricamento; il runtime lo legge quando smista il passo. Valori consentiti: "patch", "emit" |
scope | string (enum) | no | La radice dei documenti su cui opera questa esportazione: own sono i documenti renderizzati propri del nodo, host sono i documenti del componente a cui è associata una feature recipe con ambito di componente. La forma del valore viene controllata al caricamento; il runtime risolve i documenti dell’ambito al momento dello smistamento. Valori consentiti: "own", "host" |
selector | string | no | Una descrizione in forma libera, leggibile da una persona, di ciò su cui agisce l’esportazione. È documentazione per chi legge il catalogo; l’host non ne convalida il contenuto né agisce in base a esso. |
input | object | no | Un documento JSON Schema facoltativo che un’esportazione step dichiara per tipizzare l’input locale al passo che una voce di pipeline fornisce tramite il proprio blocco with. Quando è presente, descrive la forma che l’input with di un passo soddisfa; quando è assente, l’esportazione non dichiara alcun contratto di input. Lo schema è la dichiarazione propria e in forma libera, da parte dell’esportazione, della superficie di input a cui mira l’autore di una pipeline per questa esportazione. |
output | object | no | Un documento JSON Schema facoltativo che un’esportazione step dichiara per tipizzare gli output che restituisce per un passo — la forma degli output indirizzabili che un passo fornisce affinché un passo successivo o un template li legga. Quando è presente, descrive la forma di quegli output restituiti; quando è assente, l’esportazione non dichiara alcun contratto di output. Lo schema è la dichiarazione propria e in forma libera, da parte dell’esportazione, della superficie di output che questa esportazione produce. |
Non sono consentite proprietà aggiuntive.
PluginCLICommand
Un verbo di comando aggrega di primo livello che un plugin CLI aggiunge, come dichiarato in describe(). L’host registra un comando per voce e al momento dell’invocazione instrada di nuovo al guest il nome del comando risolto, così un singolo guest può sostenere più comandi e scegliere il proprio comportamento in base al nome.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Il verbo di comando che l’host registra — il token aggrega che un operatore invoca e il discriminante che l’host passa al guest affinché possa instradare in base al comando chiamato. Ogni comando dichiarato deve nominarlo. |
description | string | no | Il testo di aiuto breve del comando, su una riga, mostrato nell’elenco dei comandi e nell’output di aiuto. È documentazione facoltativa; l’host non lo convalida né agisce in base a esso. |
flags | PluginCommandFlag[] | no | I flag del comando, nell’ordine dichiarato. Ogni voce aggiunge un flag che l’host registra sul comando, così aggrega help |
Non sono consentite proprietà aggiuntive.
PluginCommandFlag
Un flag che un plugin CLI dichiara su un comando, come riportato in describe(). L’host lo registra sul comando, così aggrega help
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Il nome lungo del flag — il token —name che un operatore passa sulla riga di comando. Ogni flag dichiarato deve indicarlo. Almeno 1 carattere. |
shorthand | string | no | L’alias breve facoltativo di un solo carattere del flag — la forma -x che un operatore può passare al posto del nome lungo. Se assente, il flag non ha alias breve. |
description | string | no | Il testo di aiuto di una riga del flag, mostrato nell’output di aiuto del comando. È documentazione opzionale; l’host non lo convalida né agisce su di esso. |
type | string | no | Il tipo di valore del flag — per esempio string, bool o int. Se assente, non esprime alcuna affermazione sul tipo. |
default | string | no | Il valore predefinito del flag quando l’operatore non lo passa, espresso come stringa. Se assente, il flag non dichiara alcun valore predefinito. |
Non sono consentite proprietà aggiuntive.
PluginDescriptorMeta
Metadati facoltativi di paternità e di provenienza della build che un plugin dichiara in describe(). Sono informativi; l’host non li convalida né agisce in base a essi. I campi version e commit sono la provenienza della build marcata nel guest in fase di build; una build non marcata li omette.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
author | string | no | L’autore del plugin. |
repository | string | no | Il repository sorgente del plugin. |
license | string | no | L’identificatore della licenza del plugin. |
version | string | no | La versione di provenienza della build marcata nel guest in fase di build. Omessa da una build non marcata. |
commit | string | no | Il commit breve di provenienza della build da cui è stato compilato il guest. Omesso da una build non marcata. |
Non sono consentite proprietà aggiuntive.
ProviderContract
L’autodichiarazione di un provider sui comportamenti di rendering in fase di compilazione che esegue sui nodi che renderizza — i tipi di input che accetta, se e come assembla l’output per nodo di un gruppo di smistamento in un unico artefatto, la coppia di delimitatori dei template Go che applica ai file di artefatto importati, se accetta i file che una Recipe fornisce all’output condiviso del suo confine, e i file che il suo ecosistema non distribuisce mai accanto a un sorgente. Descrive il provider nel suo insieme, non una singola esportazione. Il controllo al caricamento la confronta con l’affermazione scritta nell’entità.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
input_kinds | InputKinds | sì | Quali dei tre tipi di input di una Recipe il plugin renderizza: un insieme di file con sorgente, un workload sintetizzato e un nodo autonomo di soli artefatti. |
boundary_assembly | string (enum) | sì | Come il plugin combina l’output di rendering per nodo di un gruppo di smistamento: none scrive l’output di ciascun nodo direttamente nel percorso di smistamento, merge fonde i frammenti per nodo in un unico documento, e nest colloca l’output di ciascun nodo nella propria posizione all’interno di una struttura ombrello. Un valore vuoto non esprime alcuna affermazione di assemblaggio. Valori consentiti: "none", "merge", "nest", "" |
artifact_delimiters | ArtifactDelimiters | no | La coppia di delimitatori dei template Go che il plugin applica ai file di artefatto importati. Se assente, vale la coppia di apertura/chiusura predefinita; un plugin la cui sintassi di destinazione collide con quella coppia riporta qui una coppia alternativa. |
assembly_name_annotation | AssemblyNameAnnotation | no | Un’annotazione di confine il cui valore risolto nomina l’artefatto che il plugin assembla da un gruppo di smistamento. Se assente, il plugin nomina il proprio assemblaggio solo a partire dal percorso di smistamento. |
reusable_instance | booleana | no | Se un’unica istanza caricata del plugin può servire ogni attraversamento di rendering, assemblaggio e validazione della build anziché un’istanza nuova per ogni attraversamento. Un plugin lo dichiara true solo quando non mantiene alcuno stato tra un attraversamento e l’altro. Assente (false) è il valore predefinito sicuro: l’host carica un’istanza nuova per ogni attraversamento. |
cross_boundary_linking | booleana | no | Se il plugin collega gli archi uses tra confini — archi le cui estremità consumatrice e consumata si assemblano in gruppi di smistamento diversi — producendo un collegamento di riferimenti incrociati nativo del provider tramite le proprie esportazioni link_publish e link_resolve. Un plugin lo dichiara true solo quando esporta entrambe. Assente (false) è il valore predefinito sicuro: il plugin non collega alcun arco tra confini. |
omits | booleana | no | Se il plugin rispetta le voci omit che un input render_node porta: esclude ogni unità renderizzata a cui corrisponde una voce da tutto ciò che restituisce, e riporta un conteggio per ciascuna voce ricevuta nel campo omitted dell’output. Un plugin lo dichiara true solo quando fa entrambe le cose. Assente (false) è il valore predefinito sicuro: il plugin non afferma di escludere nulla. |
boundary_artifacts | booleana | no | Se la destinazione del plugin accetta i file che una Recipe fornisce all’output condiviso del confine in cui esegue il rendering. L’host valuta quei file e scrive ciascuno una sola volta, nella directory che contiene l’output assemblato del gruppo di smistamento, accanto a ciò che scrive l’assemblaggio del plugin; al plugin non ne viene passato nessuno e il plugin non ne legge nessuno, quindi l’affermazione dichiara che la sua destinazione tratta un file collocato lì come parte dell’output del confine. Assente (false) è il valore predefinito sicuro: una Recipe che dichiara file del genere per questo plugin viene rifiutata prima che venga renderizzato qualsiasi cosa. |
nest_segment | string | no | La directory sotto cui la destinazione del plugin colloca la sottodirectory propria di ciascun contributore, per un plugin che annida l’output per nodo di un gruppo di smistamento. L’host unisce questo segmento, il nome a livello di authoring del contributore e il percorso proprio di ciascun file. Letto solo quando boundary_assembly è nest. Se assente, l’host colloca la sottodirectory di ciascun contributore direttamente nella posizione di smistamento, senza alcuna directory che la racchiuda. Il valore nomina una sola directory e mai un percorso: un valore che contiene un separatore di percorso, o che nomina la directory corrente o quella superiore, viene rifiutato, perché l’host vi compone il nome del contributore e un frammento di percorso collocherebbe i file di un contributore in un punto diverso da sotto la posizione di smistamento. |
source_ignore | SourceIgnore | no | I file che l’ecosistema di questo plugin non distribuisce mai accanto a un sorgente che renderizza, dichiarati come regole di esclusione. L’host legge la dichiarazione quando un autore fissa una Recipe o una FeatureRecipe la cui capacità questo plugin serve per loro: compone queste regole con il file di esclusione proprio dell’autore, registra le regole composte nel lock dell’entità accanto all’entità e da quel momento ogni pubblicazione dell’entità, ogni confronto del suo sorgente locale e ogni suo rendering applica le regole registrate anziché interrogare di nuovo un plugin. Così una Recipe pubblicata per una capacità porta i file che le regole di chi l’ha pubblicata hanno mantenuto, e un plugin la renderizza quando parla la stessa versione dell’ABI, il suo contratto corrisponde all’affermazione della sua entità e non ha bisogno di alcun file al di fuori di quell’insieme. Un plugin che ha bisogno di un file che l’insieme ha escluso deve far fallire la propria build in modo esplicito e nominare il file; il compito dell’host è rifiutare l’impacchettamento o la lettura di un file che l’insieme non contiene, nominandolo. Se assente, non dichiara alcuna regola di esclusione, e un sorgente che il plugin renderizza mantiene allora ogni file che le regole proprie dell’autore mantengono. |
Non sono consentite proprietà aggiuntive.
SourceIgnore
Le regole di esclusione che l’ecosistema di un plugin applica a una directory sorgente, in sintassi gitignore: un pattern che non contiene alcuna barra, o solo una finale, corrisponde a un nome a qualsiasi profondità, un pattern che contiene qualsiasi altra barra viene letto dalla radice della directory a cui è circoscritto, una barra finale corrisponde solo a una directory, e un ! iniziale riporta ciò che una regola precedente ha escluso. Le regole si applicano in ordine e una corrispondenza successiva prevale su una precedente. Una directory che una regola esclude non viene esplorata, quindi nulla al suo interno viene riportato a meno che la directory stessa non venga riportata prima.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
patterns | string[] | no | I pattern di esclusione propri dell’ecosistema, ciascuno circoscritto alla radice della directory sorgente locale che viene esplorata, nell’ordine in cui si applicano. Assente o vuoto non ne dichiara nessuno. |
files | string[] | no | I nomi dei file di esclusione che l’ecosistema rispetta all’interno di un sorgente — .helmignore per un chart, per esempio. Ovunque l’esplorazione di un sorgente trovi un file con uno di questi nomi, le sue righe vengono lette come ulteriori pattern nella stessa sintassi, ciascuno circoscritto alla directory che contiene il file, e si applicano dopo i pattern indicati sopra; una riga vuota e una riga che inizia con # vengono saltate. Un file con un nome del genere viene esso stesso portato a meno che una regola non lo escluda. Assente o vuoto non ne nomina nessuno. |
Non sono consentite proprietà aggiuntive.
InputKinds
Quali tipi di input di una Recipe un plugin renderizza. Ogni campo è un’affermazione indipendente; un plugin può riportare qualsiasi combinazione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
sourced | booleana | sì | Se il plugin renderizza un insieme di file con sorgente (un chart, un modulo, un file compose). |
synthesized | booleana | sì | Se il plugin renderizza un workload sintetizzato. |
artifacts_standalone | booleana | sì | Se il plugin renderizza un nodo autonomo di soli artefatti — uno che porta documenti di artefatto importati e nessun sorgente né workload. |
Non sono consentite proprietà aggiuntive.
ArtifactDelimiters
La coppia di delimitatori dei template Go che un plugin applica ai file di artefatto importati, riportata quando differisce dalla coppia predefinita.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
left | string | sì | Il delimitatore di apertura. |
right | string | sì | Il delimitatore di chiusura. |
Non sono consentite proprietà aggiuntive.
AssemblyNameAnnotation
L’annotazione di confine il cui valore risolto nomina l’artefatto assemblato di un plugin, riportata quando il plugin fonde i confini contributori di un gruppo di smistamento in un unico assemblaggio con nome.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
annotation | string | sì | La chiave dell’annotazione di confine da cui il plugin legge il nome dell’artefatto assemblato. |
require_unique | booleana | no | Se ogni confine che contribuisce a un unico gruppo di smistamento deve concordare sul valore risolto dell’annotazione. Quando è true, un gruppo i cui confini che contribuiscono risolvono l’annotazione in valori diversi arresta la build; quando è false, il plugin accetta il primo valore risolto. |
Non sono consentite proprietà aggiuntive.
ImporterContract
Ciò che un importatore dichiara sui propri formati oltre ad annunciarli: le firme da cui si riconosce un sorgente di quei formati. Quando un’importazione non nomina alcun formato, l’host legge le firme registrate da ogni importatore tra cui l’importazione sceglie — gli importatori nel catalogo del workspace e gli importatori del core del compilatore, le cui entità Plugin il binario porta con sé — confronta ciascuna con il sorgente senza sapere che cosa sia alcun formato, e legge il sorgente come il formato dell’unico importatore la cui firma corrisponde. Un sorgente a cui non corrisponde alcuna firma viene rifiutato chiedendo il formato, e un sorgente a cui corrispondono firme di più di un formato viene rifiutato nominandoli. L’entità Plugin registra lo stesso elenco, e l’host rifiuta un importatore il cui rapporto di describe() differisce dalla registrazione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
detect | DetectSignature[] | no | Le firme che riconoscono un sorgente dei formati di questo importatore, nell’ordine dichiarato; un sorgente è riconosciuto quando una qualsiasi di esse vi corrisponde. Un sorgente riconosciuto da un importatore è riconosciuto come ogni formato che l’importatore annuncia, quindi un importatore che annuncia più di un formato vede ogni corrispondenza rifiutata come ambigua, e un importatore i cui sorgenti devono essere riconosciuti annuncia un solo formato. Assente o vuoto non dichiara alcuna firma, e i formati dell’importatore vengono raggiunti solo nominandoli. |
Non sono consentite proprietà aggiuntive.
DetectSignature
Un modo in cui si riconosce un sorgente: la sintassi in cui il sorgente viene letto, i nomi di file a cui si applica la firma e i predicati che l’albero analizzato deve soddisfare. Corrisponde a un file il cui nome corrisponde a uno dei suoi pattern di file — oppure, dove non ne dichiara nessuno, a un sorgente costituito da un solo file, comunque si chiami — i cui byte vengono analizzati nella sua sintassi e il cui albero analizzato soddisfa ognuno dei suoi predicati. Corrisponde a una directory quando corrisponde a uno dei file della directory selezionati dai suoi pattern, quindi una firma che non dichiara alcun pattern non corrisponde ad alcuna directory.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
syntax | string | sì | Il formato sintattico in cui il sorgente viene analizzato — json o yaml, per esempio — che è il formato che un plugin parser annuncia come parse: |
files | string[] | no | I pattern dei nomi di file a cui si applica la firma, confrontati con la parte finale del nome del sorgente con i suoi separatori letti come barre in avanti: un pattern di un solo segmento viene confrontato con il nome proprio del file, e un pattern di più segmenti separati da barre con altrettanti segmenti finali del suo percorso, quindi .vscode/mcp.json corrisponde a un file chiamato mcp.json in una directory chiamata .vscode. All’interno di un segmento, * corrisponde a qualsiasi sequenza di caratteri, ? corrisponde a un carattere e […] corrisponde a un carattere di una classe. La firma si applica quando un pattern qualsiasi corrisponde. Un pattern non ben formato viene rifiutato al caricamento. Assente o vuoto applica la firma a un sorgente costituito da un solo file, comunque si chiami, e a nessun file di una directory. I pattern delle firme di un importatore sono anche ciò che decide quali file di una directory un’importazione gli passa. |
match | PathMatch[] | no | I predicati che l’albero analizzato deve soddisfare, tutti, nell’ordine dichiarato. Se assente o vuoto, non chiede nulla all’albero oltre all’essere analizzabile nella sintassi. |
Non sono consentite proprietà aggiuntive.
PathMatch
Un predicato sull’albero analizzato: il valore che un percorso raggiunge, il tipo di valore che deve essere e, facoltativamente, una stringa a cui deve essere uguale o con cui deve iniziare.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
path | string | sì | Dove il predicato guarda nell’albero, scritto come chiavi unite da punti a partire dalla cima dell’albero: data.nodes nomina il membro nodes dell’oggetto data di primo livello. Un segmento scritto come numero intero, 0 o maggiore, seleziona quella posizione di un array contando da zero, quindi nodes.0.type nomina il type del primo nodo; ogni altro segmento seleziona un membro di un oggetto. Una chiave che contiene essa stessa un punto non può essere nominata. Lungo almeno 1 carattere. |
is | string (enum) | sì | Ciò che il percorso deve raggiungere: present vale quando raggiunge un valore di qualsiasi tipo, null incluso; absent vale quando non raggiunge nulla; object, array, string, number e boolean valgono ciascuno quando raggiunge un valore di quel tipo. Valori consentiti: "present", "absent", "object", "array", "string", "number", "boolean" |
equals | string | no | Una stringa a cui il valore raggiunto dal percorso deve essere esattamente uguale. Un valore che non è una stringa non è mai uguale a essa. Su un predicato si dichiara al massimo uno tra equals e prefix, e un predicato che li dichiara entrambi viene rifiutato al caricamento. Lungo almeno 1 carattere. |
prefix | string | no | Una stringa con cui il valore raggiunto dal percorso deve iniziare. Un valore che non è una stringa non inizia mai con essa. Su un predicato si dichiara al massimo uno tra equals e prefix, e un predicato che li dichiara entrambi viene rifiutato al caricamento. Lungo almeno 1 carattere. |
Non sono consentite proprietà aggiuntive.