JavaScript
Skutečný zdrojový kód JS, kompilovaný při uložení, pro logiku, kterou deklarativní program nevyjádří.
Program JavaScript obsahuje skutečný zdrojový kód v scriptData.value, což je nouzový východ pro logiku, kterou deklarativní Get Data, Set Data nebo Batch nevyjádří. Kompiluje se při uložení (save_prog spustí stejné sestavení jako Studio a vrátí data.compile, tedy { ok: true, dependencies } nebo { ok: false, error }) a běží se skutečným API pro pole, tabulky a události, nejen s prvkem DOM.
Vlastnosti
Prováděcí smlouva
Zdroj je prosté asynchronní tělo, bez export, bez obalu, spouštěné takto:
params jsou již vyhodnocené parametry volajícího. xu je API běhového prostředí: pole, řádky databáze, události, HTTP. await funguje bez omezení, protože obal je asynchronní. Uvozovky zde nevadí, na rozdíl od hodnoty atributu xu-script.
Čtení a zápis tabulky
Metody dbs_* berou _id tabulky, nikdy její název. Projekce fields u dbs_read je volitelná: [], výchozí hodnota, vrátí všechna pole a seznam id polí vrátí jen tato pole.
Předávání dat dovnitř: pole, ne parametry
call_native_javascript nevyhodnocuje obaly parametrů {value, fx}, skript zavolaný tímto způsobem dostane doslovné objekty {value: "", fx: "@field"}, ne vyhodnocené hodnoty. Spolehlivý postup: volající nejprve vloží data do pole (krokem update nebo vstupem xu-bind), zavolá skript s prázdnými parameters: {} a skript čte pomocí xu.get_field_value a hlásí zpět pomocí xu.set_field_value. Volání z jiného skriptu je jiné, parametry xu.call_javascript(prog_id, {...}) dorazí tak, jak byly předány.
Vyvolání programu JavaScript
Praktický příklad
Deklarujte parametry
Položky progFields se stanou názvy argumentů funkce obalu, v pořadí volání.
Napište tělo
Prosté asynchronní tělo funkce, pomocí return vraťte hodnotu, pokud ji bude číst call_evaluate_javascript.
Zavolejte ho a přečtěte compile.ok
Po save_prog zkontrolujte data.compile.ok: neúspěšná kompilace dokument stále uloží, s připojenou chybou build_error.
Vytvořte uzel JavaScript v sekci Programy, zdroj napište v editoru kódu a parametry přidejte v mřížce Pole. Uložení překompiluje automaticky, chyby se zobrazí v editoru.