JavaScript
Código fuente JS real, compilado al guardar, para la lógica que un programa declarativo no puede expresar.
Un programa JavaScript contiene código fuente real en scriptData.value, la salida de emergencia para la lógica que un Get Data, Set Data o Batch declarativo no puede expresar. Se compila al guardar (save_prog ejecuta la misma compilación que Studio y devuelve data.compile, { ok: true, dependencies } o { ok: false, error }), y se ejecuta con una API real para campos, tablas y eventos, no solo un elemento DOM.
Propiedades
El contrato de ejecución
El código fuente es un cuerpo asíncrono simple, sin export, sin envoltorio, ejecutado como:
params son los parámetros de quien llama, ya evaluados. xu es la API del entorno de ejecución: campos, filas de la base de datos, eventos, HTTP. await funciona libremente porque el envoltorio es asíncrono. Aquí las comillas no dan problema, a diferencia de un valor de atributo xu-script.
Leer y escribir una tabla
Los métodos dbs_* reciben el _id de la tabla, nunca su nombre. La proyección fields de dbs_read es opcional: [], el valor por defecto, devuelve todos los campos, y una lista de ids de campo devuelve solo esos.
Pasar datos: campos, no parámetros
call_native_javascript no evalúa los envoltorios de parámetros {value, fx}; un script llamado así recibe los objetos literales {value: "", fx: "@field"}, no valores resueltos. El patrón fiable: quien llama pone primero la carga útil en un campo (un paso update o un campo de entrada xu-bind), llama al script con parameters: {} vacío, y el script lee con xu.get_field_value e informa con xu.set_field_value. Llamar desde otro script es distinto: los parámetros de xu.call_javascript(prog_id, {...}) sí llegan tal como se pasan.
Invocar un programa JavaScript
Ejemplo práctico
Declara los parámetros
Las entradas de progFields se convierten en los nombres de los argumentos de la función envoltorio, en el orden de la llamada.
Escribe el cuerpo
Un cuerpo de función asíncrona simple; haz return de un valor si call_evaluate_javascript lo va a leer.
Llámalo y lee compile.ok
Después de save_prog, comprueba data.compile.ok: una compilación fallida igualmente guarda el documento con un build_error adjunto.
Crea un nodo JavaScript en Programas, escribe el código en el editor de código y añade parámetros en la cuadrícula de Campos. Al guardar se recompila automáticamente; los errores aparecen en el editor.