Παγκόσμια ονόματα Total.js 5
Το Total.js 5 παρουσιάζει παγκόσμιες λειτουργίες και αντικείμενα για το routing, τις ενέργειες, την αποθήκευση, τα μηνύματα και τις εφαρμογές.
| Όνομα | Είδος | Τι κάνει | Συνταγή |
|---|---|---|---|
ON | function | Καταχωρίζει έναν ακροατή για ένα γεγονός της εφαρμογής. | events |
ONCE | function | Όπως το ON, αλλά ο ακροατής τρέχει μόνο για το πρώτο γεγονός. | events |
OFF | function | Αφαιρεί έναν ακροατή που καταχωρίστηκε με ON. | events |
EMIT | function | Εκπέμπει ένα γεγονός με έως επτά ορίσματα. | events |
LOAD | function | Φορτώνει τα αρχεία του έργου (controllers, ορισμούς...)· το framework το καλεί για εσάς στην εκκίνηση. | load-and-npminstall |
LOADCONFIG | function | Αναλύει ένα κείμενο στη μορφή config και το εφαρμόζει στο CONF. | configuration-file |
LOADRESOURCE | function | Φορτώνει έναν πόρο (αρχείο μετάφρασης) από κείμενο ή από URL. | localization |
PAUSESERVER | function | Θέτει σε παύση ή συνεχίζει τον διακομιστή με όνομα: όσο είναι σε παύση, τα αιτήματα παίρνουν σελίδα 503. | pause-server |
DEBUG | boolean | true σε λειτουργία debug, false σε λειτουργία release. | release-mode-and-debugging |
CONF | object | Η ρύθμιση της εφαρμογής (το αρχείο config και οι προεπιλογές του). | configuration-file |
DEF | object | Προεπιλεγμένοι χειριστές και ρυθμίσεις του framework (DEF.onMail, DEF.helpers, DEF.onCSRFcheck...). | view-helpers-and-config |
F | object | Το αντικείμενο του framework. Το Total είναι το ίδιο αντικείμενο. | utility-globals |
Total | object | Το αντικείμενο του framework (ίδιο με το F). Το Total.run() ξεκινά την εφαρμογή. | release-mode-and-debugging |
MAIN | object | Ένα κενό αντικείμενο που δημιουργεί το framework για τα δεδομένα της εφαρμογής σας. | utility-globals |
REPO | object | Ένα κενό αντικείμενο που δημιουργεί το framework για τα δικά σας δεδομένα. | utility-globals |
FUNC | object | Ένα κενό αντικείμενο που δημιουργεί το framework για τις δικές σας συναρτήσεις. | utility-globals |
TEMP | object | Ένα αντικείμενο για προσωρινά δεδομένα· το framework το αντικαθιστά κατά διαστήματα με ένα νέο κενό αντικείμενο. | utility-globals |
NOW | object | Η τρέχουσα ημερομηνία, που ανανεώνεται από το framework μία φορά το λεπτό και από ορισμένες κλήσεις όπως το CACHE. | utility-globals |
EMPTYARRAY | object | Ένας παγωμένος κενός πίνακας, για να αποφεύγεται η δημιουργία νέων. | utility-globals |
EMPTYOBJECT | object | Ένα παγωμένο κενό αντικείμενο, για να αποφεύγεται η δημιουργία νέων. | utility-globals |
MODS | object | Οι φορτωμένες ενότητες του φακέλου modules/, ανά id. | utility-globals |
PLUGINS | object | Τα φορτωμένα πρόσθετα του φακέλου plugins/, ανά id. | utility-globals |
NOOP | function | Μια συνάρτηση που δεν κάνει τίποτα. | utility-globals |
print | function | Το ίδιο με το console.log. | utility-globals |
REQUIRE | function | Όπως το require, αλλά ψάχνει και στον φάκελο node_modules της εφαρμογής και δέχεται ονόματα node:. | utility-globals |
Δρομολόγηση, ενέργειες και middleware
| Όνομα | Είδος | Τι κάνει | Συνταγή |
|---|---|---|---|
ROUTE | function | Δηλώνει μια διαδρομή (HTTP, SOCKET, FILE, API ή μια εφεδρική όπως το #404). | http-methods |
NEWACTION | function | Δηλώνει μια ενέργεια με την είσοδο, τα params, το query, την έξοδο και τα δικαιώματά της. | actions-crud |
NEWSCHEMA | function | Ομαδοποιεί τις ενέργειες μιας οντότητας κάτω από ένα όνομα. | schemas |
ACTION | function | Εκτελεί μια ενέργεια από τον δικό σας κώδικα. | calling-actions-from-code |
EXEC | function | Η ίδια συνάρτηση με το ACTION. | calling-actions-from-code |
NEWTRANSFORM | function | Προσθέτει ένα βήμα σε μια ονομασμένη αλυσίδα μετασχηματισμών. | transforms |
TRANSFORM | function | Περνά μια τιμή μέσα από μια αλυσίδα μετασχηματισμών. | transforms |
MIDDLEWARE | function | Καταχωρίζει ένα middleware για χρήση σε διαδρομές με #name. | middleware |
NEWMIDDLEWARE | function | Η ίδια συνάρτηση με το MIDDLEWARE. | middleware |
PROXY | function | Προωθεί τα αιτήματα κάτω από ένα πρόθεμα URL σε άλλον διακομιστή. | proxy |
CORS | function | Ορίζει τις προελεύσεις που μπορούν να καλούν την εφαρμογή από έναν περιηγητή. | cors |
ErrorBuilder | function | Η κλάση που συλλέγει τα σφάλματα επικύρωσης. | errors-and-audit |
SUCCESS | function | Επιστρέφει το αντικείμενο που στέλνει το framework για μια επιτυχή λειτουργία ({ success: true, value: value }). | errors-and-audit |
ERROR | function | Το ERROR(name) επιστρέφει ένα callback που καταγράφει το σφάλμα που λαμβάνει με αυτό το όνομα· το ERROR() επιστρέφει το προεπιλεγμένο callback σφάλματος. | errors-and-audit |
UNAUTHORIZED | function | Το UNAUTHORIZED($, ...permissions) απαντά 401 και επιστρέφει true όταν ο χρήστης δεν έχει καμία από τις άδειες· επιστρέφει false όταν έχει μία από αυτές ή είναι υπερδιαχειριστής. | action-user-and-permissions |
AUTH | function | Πιστοποιεί κάθε αίτημα: μια συνάρτηση, ή οι επιλογές των ενσωματωμένων συνεδριών. | sessions-with-built-in-auth |
BLOCKED | function | Μετρά τις κλήσεις μιας διεύθυνσης IP και λέει πότε έφτασε το όριο. | rate-limiting |
AUDIT | function | Προσθέτει μια εγγραφή ελέγχου (χρήστης, μήνυμα και τύπος) σε ένα αρχείο καταγραφής στο logs/. | errors-and-audit |
Δεδομένα και cache
| Όνομα | Είδος | Τι κάνει | Συνταγή |
|---|---|---|---|
NOSQL | function | Ανοίγει έναν πίνακα της ενσωματωμένης βάσης NoSQL. | nosql-crud |
DATA | object | Είσοδος στον query builder ανεξάρτητη από τη βάση δεδομένων. | data-api |
DB | function | Ξεκινά ένα ερώτημα με τον query builder (DB().find('table').where(...).callback($))· το ερώτημα εκτελείται από τον driver που καταχωρίστηκε με NEWDB. | query-builder-db |
NEWDB | function | Καταχωρίζει έναν driver βάσης δεδομένων function(options, callback) για τον query builder: τον προεπιλεγμένο, ή έναν ονομασμένο με NEWDB('name', fn). | query-builder-db |
CACHE | object | Ένας χώρος αποθήκευσης στη μνήμη με λήξη. | cache |
FILECACHE | function | Υπολογίζει ένα αποτέλεσμα μία φορά και το κρατά σε αρχείο για κάποιο διάστημα. | filecache |
MEMORIZE | function | Ένα αντικείμενο JSON αποθηκευμένο στον δίσκο. | memorize |
FILESTORAGE | function | Ένας χώρος αποθήκευσης για μεταφορτωμένα αρχεία. | filestorage |
Πελάτες HTTP, WebSocket και μηνυμάτων
| Όνομα | Είδος | Τι κάνει | Συνταγή |
|---|---|---|---|
REQUEST | function | Πελάτης HTTP χαμηλού επιπέδου. | request-and-download |
DOWNLOAD | function | Αποθηκεύει την απάντηση ενός URL σε αρχείο. | request-and-download |
RESTBuilder | function | Builder για κλήσεις σε άλλα HTTP API. | restbuilder |
AJAX | function | Το AJAX('METHOD /url/', data, callback) κάνει ένα αίτημα με την κεφαλίδα x-requested-with και επιστρέφει το αναλυμένο σώμα· επιστρέφει promise όταν δεν υπάρχει callback. | ajax-requests |
API | function | Καλεί μια λειτουργία μιας εξωτερικής υπηρεσίας μέσω του driver της: API('service', 'operation', data).callback($). | api-drivers |
NEWAPI | function | Καταχωρίζει τον driver function(options, next) μιας υπηρεσίας για το API, με προαιρετική ρύθμιση. | api-drivers |
TotalAPI | function | Καλεί μια υπηρεσία της πλατφόρμας Total.js μέσω API('TAPI', name, model). | remote-service-boundaries |
WEBSOCKETCLIENT | function | Ένας πελάτης WebSocket για την εφαρμογή σας. | websocket-client |
TMSCLIENT | function | Ένας πελάτης του Total Messaging Service. | tms |
PUBLISH | function | Στέλνει ένα μήνυμα στους πελάτες TMS που έχουν εγγραφεί σε αυτό. | tms |
NEWPUBLISH | function | Δηλώνει ένα μήνυμα που δημοσιεύει η εφαρμογή. | tms |
SUBSCRIBE | function | Προσθέτει έναν ακροατή για ένα μήνυμα που στέλνουν οι πελάτες στην εφαρμογή. | tms |
UNSUBSCRIBE | function | Αφαιρεί τους ακροατές ενός μηνύματος TMS. | tms |
NEWSUBSCRIBE | function | Δηλώνει ένα μήνυμα που λαμβάνει η εφαρμογή. | tms |
NEWCALL | function | Δηλώνει μια συνάρτηση που μπορούν να καλούν οι πελάτες TMS. | tms |
OPENCLIENT | function | Συνδέεται στο OpenPlatform μέσω WebSocket για απομακρυσμένες κλήσεις, συμβάντα και κοινόχρηστες συνδέσεις. | openclient-protocol |
PROXYCLIENT | function | Συνδέεται με έναν PROXYSERVER μέσω WebSocket και απαντά στα αιτήματά του με έναν τοπικό διακομιστή (μια θύρα ή ip:port). | proxy-tunnel |
PROXYSERVER | function | Μετατρέπει την εφαρμογή σε διακομιστή σήραγγας: τα αιτήματα HTTP ενός endpoint στέλνονται μέσω μιας διαδρομής WebSocket σε έναν PROXYCLIENT. | proxy-tunnel |
LDAP | function | Συνδέεται σε έναν διακομιστή LDAP (θύρα 389 εκτός αν το ldap.port λέει άλλο) και καλεί πίσω με το αποτέλεσμα. | ldap-openldap |
MAIL | function | Στέλνει ένα email του οποίου το σώμα είναι μια προβολή. | send-email |
HTMLMAIL | function | Στέλνει ένα email του οποίου το σώμα είναι μια συμβολοσειρά HTML. | send-email |
LOGMAIL | function | Στέλνει ένα email το σώμα του οποίου είναι κείμενο τυπωμένο σε μπλοκ <pre> (περάστε το σώμα ως κείμενο). | logmail |
Mail | object | Η κλάση πίσω από την αποστολή email (SMTP). | send-email |
AIMODEL | function | Ξεκινά ένα αίτημα προς ένα γλωσσικό μοντέλο που καταχωρίστηκε με NEWAIMODEL: AIMODEL('name').user('text').callback($.callback()). | ai-models |
AIPARSER | function | Δημιουργεί έναν αναλυτή για τη ροή απάντησης ενός παρόχου AI (openai, claude...): το write() δέχεται κομμάτια και το end() επιστρέφει το περιεχόμενο, τη σκέψη και τις κλήσεις εργαλείων. | ai-models |
NEWAIMODEL | function | Καταχωρίζει τον driver function(ai, done) ενός ή περισσότερων μοντέλων AI για το AIMODEL, με προαιρετική ρύθμιση. | ai-models |
PYPELINE | function | Εκτελεί από την εφαρμογή ένα αρχείο Python του φακέλου pypelines/ (ή ενσωματωμένο κώδικα Python) και επικοινωνεί μαζί του με πλαίσια JSON πάνω από ένα socket. | pypeline |
Αρχεία, σύστημα και workers
| Όνομα | Είδος | Τι κάνει | Συνταγή |
|---|---|---|---|
PATH | object | Βοηθοί που δημιουργούν διαδρομές στους φακέλους του έργου (PATH.root(), PATH.public(), PATH.tmp()...). | file-download |
MERGE | function | Καταχωρίζει ένα εικονικό αρχείο που αποτελείται από πολλά αρχεία, ελαχιστοποιημένο. | minification |
TOUCH | function | Καθαρίζει τις αποθηκευμένες ελαχιστοποιημένες, προσωρινές και μη βρεθείσες εγγραφές ενός URL, ή όλων. | touch-static-cache |
CLEANUP | function | Καταστρέφει μια ροή όταν τελειώσει. | cleanup-streams |
BACKUP | function | Συμπιέζει έναν κατάλογο σε ένα αρχείο. | backup-restore-shell |
RESTORE | function | Αποσυμπιέζει ένα αρχείο που δημιουργήθηκε με BACKUP. | backup-restore-shell |
SHELL | function | Εκτελεί μια εντολή shell στον φάκελο του έργου. | backup-restore-shell |
NPMINSTALL | function | Εγκαθιστά ένα πακέτο npm στον φάκελο ενοτήτων της εφαρμογής. | load-and-npminstall |
IMPORT | function | Κατεβάζει ένα αρχείο JavaScript από ένα URL και το φορτώνει. | import-remote-module |
Image | object | Επεξεργασία εικόνων με GraphicsMagick ή ImageMagick. | images |
NEWTHREAD | function | Ξεκινά ένα worker thread. | workers-and-threads |
NEWFORK | function | Ξεκινά μια θυγατρική διεργασία. | workers-and-threads |
NEWTHREADPOOL | function | Δημιουργεί μια ομάδα workers που οι εργασίες δανείζονται μία τη φορά. | thread-pool |
CRON | function | Εκτελεί μια συνάρτηση βάσει προγράμματος. | cron-jobs |
setTimeout2 | function | Το setTimeout με id: η κλήση του ξανά με το ίδιο id αντικαθιστά τον προηγούμενο χρονοδιακόπτη. | debounce-timers |
clearTimeout2 | function | Ακυρώνει έναν χρονοδιακόπτη που δημιουργήθηκε με setTimeout2. | debounce-timers |
Flow | object | Ο διαχειριστής των FlowStreams της εφαρμογής: Flow.load(schema), Flow.remove(id), Flow.instances και Flow.test() για ένα component. | flowstream, flowstream-component-test |
FlowStream | object | Το ίδιο αντικείμενο με το Flow. | flowstream |
NEWMACRO | function | Μεταγλωττίζει ένα macro από μια συμβολοσειρά. | macros |
NEWCOMPONENT | function | Μεταγλωττίζει το HTML ενός component. | native-components |
COMPONENTATOR | function | Κατεβάζει ένα πακέτο Componentator στο public/ ως ui-<name>-<hash>.min.js και αποθηκεύει τη διεύθυνσή του στο F.repo[name]. | remote-service-boundaries |
Βοηθητικά, πρότυπα και τοπική προσαρμογή
| Όνομα | Είδος | Τι κάνει | Συνταγή |
|---|---|---|---|
U | object | Το βοηθητικό αντικείμενο του framework (U.extend(), U.clone()...). | utilities |
Utils | object | Το ίδιο αντικείμενο με το U. | utilities |
UID | function | Δημιουργεί ένα σύντομο μοναδικό id ταξινομημένο κατά χρόνο. | unique-ids-and-hashes |
GUID | function | Δημιουργεί μια τυχαία συμβολοσειρά του δοσμένου μήκους. | unique-ids-and-hashes |
HASH | function | Επιστρέφει ένα γρήγορο αριθμητικό hash (όχι για κωδικούς πρόσβασης). | unique-ids-and-hashes |
CLONE | function | Κάνει ένα βαθύ αντίγραφο ενός αντικειμένου. | utility-globals |
COPY | function | Αντιγράφει τις ιδιότητες του πρώτου αντικειμένου στο δεύτερο και επιστρέφει το δεύτερο. | utility-globals |
DIFFARR | function | Συγκρίνει δύο πίνακες αντικειμένων ως προς μια ιδιότητα και επιστρέφει τα αντικείμενα προς προσθήκη, τα ζεύγη προς ενημέρωση και τις τιμές προς αφαίρεση. | diffarr-sync-lists |
QUERIFY | function | Δημιουργεί ένα URL με συμβολοσειρά ερωτήματος από ένα αντικείμενο. | utility-globals |
PROMISIFY | function | Το PROMISIFY(fn, a, b, c) καλεί μια συνάρτηση που παίρνει callback ως τελευταίο όρισμα και επιστρέφει promise. | utility-globals |
ENCRYPT | function | Μετατρέπει μια τιμή σε αδιαφανές διακριτικό. | encrypt-and-decrypt |
DECRYPT | function | Διαβάζει μια τιμή από ένα διακριτικό που δημιουργήθηκε με ENCRYPT. | encrypt-and-decrypt |
ENCRYPTREQ | function | Κρυπτογραφεί μια τιμή μαζί με τον user agent ενός αιτήματος (και τη διεύθυνση IP του σε αυστηρή λειτουργία). | request-bound-tokens |
DECRYPTREQ | function | Διαβάζει μια τιμή που δημιουργήθηκε με ENCRYPTREQ· δεν επιστρέφει τίποτα όταν το αίτημα δεν ταιριάζει. | request-bound-tokens |
LOCALIZE | function | Επιλέγει τη γλώσσα κάθε αιτήματος. | localization |
TRANSLATE | function | Μεταφράζει τα κείμενα @(...) μιας συμβολοσειράς σε μια γλώσσα. | localization |
Tangular | object | Η μηχανή προτύπων (Tangular.render()). | tangular-templates |
Ta | object | Άλλο όνομα του Tangular, της μηχανής προτύπων. | template-files |
Thelpers | object | Οι βοηθητικές συναρτήσεις που είναι διαθέσιμες στα πρότυπα Tangular. | tangular-templates |
TEMPLATE | function | Αποδίδει ένα πρότυπο Tangular που είναι κείμενο, αρχείο του φακέλου templates ή URL, και επιστρέφει promise με το κείμενο. | template-files |
exports.install = function() {
ROUTE('GET /globals/', globals);
};
function globals($) {
var output = {};
for (var name of Object.getOwnPropertyNames(globalThis)) {
var value;
try {
value = globalThis[name];
} catch (e) {
value = undefined;
}
output[name] = typeof(value) === 'function' ? 'function' : value === null ? 'null' : typeof(value);
}
$.json(output);
}