JavaScript
Ekte JS-kildekode, kompilert ved lagring, for logikk som et deklarativt program ikke kan uttrykke.
Et JavaScript-program inneholder ekte kildekode i scriptData.value, nødutgangen for logikk som et deklarativt Get Data, Set Data eller Batch ikke kan uttrykke. Det kompileres ved lagring (save_prog kjører samme bygg som Studio og returnerer data.compile, { ok: true, dependencies } eller { ok: false, error }), og det kjører med et ekte API for felt, tabeller og hendelser, ikke bare et DOM-element.
Egenskaper
Kjørekontrakten
Kildekoden er en vanlig async-kropp, uten export og uten omslag, og kjøres som:
params er kallerens parametere, allerede evaluert. xu er kjøretids-API-et: felt, databaserader, hendelser og HTTP. await fungerer fritt siden omslaget er async. Anførselstegn er greit her, i motsetning til i en xu-script-attributtverdi.
Lese og skrive en tabell
dbs_*-metoder tar tabellens _id, aldri navnet. fields-projeksjonen i dbs_read er valgfri: [], standardverdien, gir alle felt, og en liste med felt-ID-er gir bare dem.
Sende data inn: felt, ikke parametere
call_native_javascript evaluerer ikke parameteromslagene {value, fx}. Et skript som kalles slik, får selve objektene {value: "", fx: "@field"}, ikke ferdig evaluerte verdier. Det pålitelige mønsteret er dette: kalleren legger dataene i et felt først (et update-trinn eller et xu-bind-inndatafelt), kaller skriptet med tomme parameters: {}, og skriptet leser med xu.get_field_value og svarer tilbake med xu.set_field_value. Å kalle fra et annet skript er annerledes: parameterne i xu.call_javascript(prog_id, {...}) kommer fram slik de ble sendt.
Kalle et JavaScript-program
Eksempel
Deklarer parameterne
progFields-oppføringer blir argumentnavnene til omslagsfunksjonen, i kallrekkefølge.
Skriv kroppen
En vanlig async-funksjonskropp. Bruk return for en verdi hvis call_evaluate_javascript skal lese den.
Kall det og les compile.ok
Etter save_prog, sjekk data.compile.ok. En mislykket kompilering lagrer likevel dokumentet, med en build_error festet til.
Opprett en JavaScript-node under Programmer, skriv kildekoden i koderedigeringen og legg til parametere i rutenettet Felt. Lagring kompilerer på nytt automatisk, og feil vises i editoren.