JavaScript
Πραγματικός κώδικας JS, που μεταγλωττίζεται κατά την αποθήκευση, για λογική που ένα δηλωτικό πρόγραμμα δεν μπορεί να εκφράσει.
Ένα πρόγραμμα JavaScript κρατά πραγματικό πηγαίο κώδικα στο scriptData.value, τη διέξοδο για λογική που ένα δηλωτικό Get Data, Set Data ή Batch δεν μπορεί να εκφράσει. Μεταγλωττίζεται κατά την αποθήκευση (το save_prog εκτελεί την ίδια κατασκευή με το Studio και επιστρέφει data.compile, δηλαδή { ok: true, dependencies } ή { ok: false, error }) και εκτελείται με ένα πραγματικό API για πεδία, πίνακες και συμβάντα, όχι μόνο ένα στοιχείο DOM.
Ιδιότητες
Το συμβόλαιο εκτέλεσης
Ο πηγαίος κώδικας είναι ένα απλό ασύγχρονο σώμα, χωρίς export, χωρίς περιτύλιγμα, και εκτελείται ως:
Τα params είναι οι ήδη αξιολογημένες παράμετροι του καλούντος. Το xu είναι το API της εκτέλεσης: πεδία, γραμμές βάσης δεδομένων, συμβάντα, HTTP. Το await λειτουργεί ελεύθερα αφού το περιτύλιγμα είναι ασύγχρονο. Τα εισαγωγικά επιτρέπονται εδώ, σε αντίθεση με την τιμή ενός χαρακτηριστικού xu-script.
Ανάγνωση και εγγραφή σε πίνακα
Οι μέθοδοι dbs_* παίρνουν το _id του πίνακα, ποτέ το όνομά του. Η προβολή fields στο dbs_read είναι προαιρετική: το [], η προεπιλογή, επιστρέφει κάθε πεδίο, ενώ μια λίστα με ids πεδίων επιστρέφει μόνο αυτά.
Μεταφορά δεδομένων: πεδία, όχι παράμετροι
Το call_native_javascript δεν αξιολογεί τα περιτυλίγματα παραμέτρων {value, fx}: ένα σενάριο που καλείται έτσι λαμβάνει τα κυριολεκτικά αντικείμενα {value: "", fx: "@field"}, όχι επιλυμένες τιμές. Το αξιόπιστο μοτίβο: ο καλών βάζει πρώτα το περιεχόμενο σε ένα πεδίο (με ένα βήμα update ή μια είσοδο xu-bind), καλεί το σενάριο με κενό parameters: {}, και το σενάριο διαβάζει με xu.get_field_value και αναφέρει πίσω με xu.set_field_value. Η κλήση από άλλο σενάριο είναι διαφορετική: οι παράμετροι του xu.call_javascript(prog_id, {...}) φτάνουν όπως περάστηκαν.
Κλήση ενός προγράμματος JavaScript
Ολοκληρωμένο παράδειγμα
Δηλώστε τις παραμέτρους
Οι καταχωρήσεις progFields γίνονται τα ονόματα των ορισμάτων της συνάρτησης-περιτυλίγματος, με τη σειρά κλήσης.
Γράψτε το σώμα
Ένα απλό ασύγχρονο σώμα συνάρτησης, κάντε return μια τιμή αν θα την διαβάσει το call_evaluate_javascript.
Καλέστε το και διαβάστε το compile.ok
Μετά το save_prog, ελέγξτε το data.compile.ok: μια αποτυχημένη μεταγλώττιση αποθηκεύει παρ' όλα αυτά το έγγραφο με συνημμένο build_error.
Δημιουργήστε έναν κόμβο JavaScript κάτω από τα Προγράμματα, γράψτε κώδικα στον επεξεργαστή κώδικα και προσθέστε παραμέτρους στο πλέγμα Πεδία. Η αποθήκευση μεταγλωττίζει ξανά αυτόματα και τα σφάλματα εμφανίζονται στον επεξεργαστή.